uint

Package	Niveau supérieur
Classe	public final class uint
Héritage	uint Object

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

La classe uint propose des méthodes d’utilisation d’un type de données représentant un entier 32 bits non signé. Un entier non signé étant nécessairement positif, sa valeur maximale est le double de celle de la classe int.

La plage de valeurs représentée par la classe uint est comprise entre 0 et 4 294 967 295 (2^32-1).

Pour créer un objet uint, déclarez une variable de type uint et affectez-lui une valeur littérale. La valeur par défaut d’une variable de type uint correspond à 0.

La classe uint est surtout utilisée pour les valeurs de couleur de pixel (ARVB et RVBA), ainsi que les cas où le type de données int ne fonctionne pas correctement. Par exemple, le nombre 0xFFFFFFFF, qui représente la valeur de la couleur blanche avec une valeur alpha 255, ne peut pas être représenté à l’aide du type de données int, car elle excède la plage de valeurs int valides.

L’exemple suivant crée un objet uint et appelle la méthode toString() :

 var myuint:uint = 1234;
 trace(myuint.toString()); // 1234

L’exemple suivant affecte la valeur de la propriété MIN_VALUE à une variable sans l’utilisation du constructeur :

 var smallest:uint = uint.MIN_VALUE;
 trace(smallest.toString()); // 0

Consulter les exemples

Eléments de l’API associés

int
Number

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		uint(num:Object) Crée un objet uint.	uint
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.	Object
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toExponential(fractionDigits:uint):String Renvoie une représentation sous forme de chaîne du nombre en notation exponentielle.	uint
		toFixed(fractionDigits:uint):String Renvoie une représentation sous forme de chaîne du nombre en notation à virgule fixe.	uint
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toPrecision(precision:uint):String Renvoie une représentation sous forme de chaîne du nombre en notation exponentielle ou à virgule fixe.	uint
		toString(radix:uint):String Renvoie la représentation sous forme de chaîne d’un objet uint.	uint
		valueOf():uint Renvoie la valeur du type uint de primitive de l’objet uint spécifié.	uint

Constantes publiques

	Constante		Défini par
		MAX_VALUE : uint = 4294967295 [statique] Entier non signé 32 bits représentable le plus élevé, soit 4 294 967 295.	uint
		MIN_VALUE : uint = 0 [statique] Entier non signé représentable le plus faible, soit 0.	uint

Détails du constructeur

()

Constructeur

public function uint(num:Object)

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Crée un objet uint. Vous pouvez créer une variable de type uint et lui affecter une valeur littérale. Le constructeur new uint() sert surtout d’espace réservé. Ne confondez pas l’objet uint avec la fonction uint(), qui convertit un paramètre en valeur primitive.

Paramètres

num:Object — Valeur numérique de l’objet uint en cours de création, ou valeur à convertir en nombre. Si num n’est pas fourni, la valeur par défaut est 0.

Exemple
Comment utiliser cet exemple
Le code suivant construit deux nouveaux objets uint. Pour créer le premier, il affecte une valeur littérale, tandis que pour créer le second, il utilise la fonction constructeur :

	 var n1:uint = 3;
	 var n2:uint = new uint(10);

Détails de la méthode

toExponential

()

méthode

AS3 function toExponential(fractionDigits:uint):String

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 9, AIR 1.0, Flash Lite 4

Renvoie une représentation sous forme de chaîne du nombre en notation exponentielle. La chaîne contient un chiffre avant la virgule et jusqu’à 20 décimales, comme spécifié par le paramètre fractionDigits.

Paramètres

fractionDigits:uint — Entier compris entre 0 et 20 inclus qui représente le nombre requis de décimales.

Valeur renvoyée

String

Valeur émise

RangeError — Renvoie une exception si l’argument fractionDigits n’est pas compris entre 0 et 20.

Exemple ( Comment utiliser cet exemple )

L’exemple suivant indique comment toExponential(2) renvoie une chaîne sous forme de notation exponentielle.


var num:Number = 315003;
trace(num.toExponential(2)); // 3.15e+5

toFixed

()

méthode

AS3 function toFixed(fractionDigits:uint):String

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 9, AIR 1.0, Flash Lite 4

Renvoie une représentation sous forme de chaîne du nombre en notation à virgule fixe. La notation à virgule fixe signifie que la chaîne contiendra un nombre spécifique de décimales, indiqué par le paramètre fractionDigits. Le paramètre fractionDigits gère une plage de valeurs comprises entre 0 et 20. Spécifier une valeur qui excède cette plage entraîne le renvoi d’une exception.

Paramètres

fractionDigits:uint — Entier compris entre 0 et 20 inclus qui représente le nombre requis de décimales.

Valeur renvoyée

String

Valeur émise

RangeError — Renvoie une exception si l’argument fractionDigits n’est pas compris entre 0 et 20.

Exemple ( Comment utiliser cet exemple )

L’exemple suivant indique comment toFixed(3) renvoie une chaîne qui arrondit le résultat à trois chiffres après la virgule.


var num:Number = 7.31343;
trace(num.toFixed(3)); // 7.313

L’exemple suivant indique comment toFixed(2) renvoie une chaîne qui ajoute des zéros à la fin.


var num:Number = 4;
trace(num.toFixed(2)); // 4.00

toPrecision

()

méthode

AS3 function toPrecision(precision:uint):String

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 9, AIR 1.0, Flash Lite 4

Renvoie une représentation sous forme de chaîne du nombre en notation exponentielle ou à virgule fixe. La chaîne contiendra le nombre de décimales spécifié par le paramètre precision.

Paramètres

precision:uint — Entier compris entre 1 et 21 inclus qui indique le nombre requis de décimales dans la chaîne générée.

Valeur renvoyée

String

Valeur émise

RangeError — Renvoie une exception si l’argument precision n’est pas compris entre 1 et 21.

Exemple ( Comment utiliser cet exemple )

L’exemple suivant indique comment toPrecision(3) renvoie une chaîne limitée à trois chiffres. La chaîne recourt à la notation à point fixe, dans la mesure où la notation exponentielle n’est pas requise.


var num:Number = 31.570;
trace(num.toPrecision(3)); // 31.6

L’exemple suivant indique comment toPrecision(3) renvoie une chaîne limitée à trois chiffres. La chaîne applique la notation exponentielle dans la mesure où le nombre qui en résulte ne contient pas suffisamment de chiffres pour la notation à point fixe.


var num:Number = 4000;
trace(num.toPrecision(3)); // 4.00e+3

toString

()

méthode

AS3 function toString(radix:uint):String

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Renvoie la représentation sous forme de chaîne d’un objet uint.

Paramètres

radix:uint — Spécifie la base numérique (de 2 à 36) à appliquer pour la conversion nombre vers chaîne. Si vous omettez le paramètre radix, la valeur par défaut est de 10.

Valeur renvoyée

String — Représentation sous forme de chaîne de l’objet uint.

Exemple
Comment utiliser cet exemple
L’exemple suivant utilise 2 et 8 pour les paramètres radix et renvoie une valeur de chaîne avec la représentation correspondante du numéro 9 :

	 var myuint:uint = 9;
	 trace(myuint.toString(2)); // 1001
	 trace(myuint.toString(8)); // 11

L’exemple suivant crée des valeurs hexadécimales :

	 var r:uint = 250;
	 var g:uint = 128;
	 var b:uint = 114;
	 var rgb:String = "0x" + r.toString(16) + g.toString(16) + b.toString(16);
	 trace(rgb); // 0xfa8072

valueOf

()

méthode

AS3 function valueOf():uint

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Renvoie la valeur du type uint de primitive de l’objet uint spécifié.

Valeur renvoyée

uint — Valeur du type uint de primitive de l’objet uint.

Exemple
Comment utiliser cet exemple
L’exemple suivant renvoie la valeur primitive de l’objet numSocks.

	 var numSocks:uint = 2;
	 trace(numSocks.valueOf()); // 2

Détails de la constante

MAX_VALUE

Constante

public static const MAX_VALUE:uint = 4294967295

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Entier non signé 32 bits représentable le plus élevé, soit 4 294 967 295.

Exemple
Comment utiliser cet exemple
Le code ActionScript suivant affiche les valeurs uint représentables les plus élevées et les plus faibles :

	trace("uint.MIN_VALUE = " + uint.MIN_VALUE);
	trace("uint.MAX_VALUE = " + uint.MAX_VALUE);

Les valeurs sont les suivantes :

	uint.MIN_VALUE = 0
	uint.MAX_VALUE = 4294967295

MIN_VALUE

Constante

public static const MIN_VALUE:uint = 0

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Entier non signé représentable le plus faible, soit 0.

Exemple
Comment utiliser cet exemple
Le code ActionScript suivant affiche les valeurs uint représentables les plus élevées et les plus faibles :

	 trace("uint.MIN_VALUE = " + uint.MIN_VALUE);
	 trace("uint.MAX_VALUE = " + uint.MAX_VALUE);

Les valeurs sont les suivantes :

	 uint.MIN_VALUE = 0
	 uint.MAX_VALUE = 4294967295

Exemples Comment utiliser cet exemple

UintExample.as

L’exemple suivant déclare un paramètre uint i au sein d’une boucle for, qui imprime les nombres 0 à 9 (dans la mesure où uint applique par défaut la valeur 0).


package {
    import flash.display.Sprite;

    public class UintExample extends Sprite {
        public function UintExample() {
            for(var i:uint; i < 10; i++) {
                trace(i);
            }
        }
    }
}

Informations juridiques | Politique de confidentialité en ligne

uint - AS3

Classes x

uint

toExponential

toFixed

toPrecision

toString

valueOf

MAX_VALUE

MIN_VALUE