Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
Niveau supérieur 

int  - AS3

PackageNiveau supérieur
Classepublic final class int
Héritageint Inheritance Object

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

La classe int vous permet de manipuler les types de données représentant un entier 32 bits signé. La plage de valeurs représentées par la classe int est comprise entre -2 147 483 648 (-2^31) et 2 147 483 647 (2^32-1).

Les propriétés des constantes de la classe int, MAX_VALUE et MIN_VALUE sont statiques, ce qui signifie qu’il n’est pas nécessaire de disposer d’un objet pour les utiliser ; par conséquent, il n’est pas nécessaire d’utiliser le constructeur. En revanche, les méthodes n’étant pas statiques, vous devez utiliser un objet pour y faire appel. Pour créer un objet int, utilisez le constructeur de la classe int ou déclarez une variable de type int et affectez-lui une valeur littérale.

Similaire au type de données int dans Java et C++, le type de données int s’avère utile pour les compteurs de boucles et les cas où un nombre à virgule flottante n’est pas nécessaire. La valeur par défaut d’une variable de type int correspond à 0

Si vous manipulez des nombres supérieurs à int.MAX_VALUE, envisagez l’utilisation de Number.

L’exemple suivant appelle la méthode toString() de la classe int, qui renvoie la chaîne 1234 :

 var myint:int = 1234;
 myint.toString();
 

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

 var smallest:int = int.MIN_VALUE;
 

Consulter les exemples

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
Méthodes publiques
 MéthodeDéfini par
  
int(num:Object)
Constructeur qui crée un nouvel objet int.
int
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
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
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
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.
int
  
toFixed(fractionDigits:uint):String
Renvoie une représentation sous forme de chaîne du nombre en notation à virgule fixe.
int
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
  
Renvoie une représentation sous forme de chaîne du nombre en notation exponentielle ou à virgule fixe.
int
  
Renvoie la représentation sous forme de chaîne d’un objet int.
int
  
Renvoie la valeur primitive de l’objet int spécifié.
int
Constantes publiques
 ConstanteDéfini par
  MAX_VALUE : int = 2147483647
[statique] Entier signé 32 bits représentable le plus élevé, soit 2 147 483 647.
int
  MIN_VALUE : int = -2147483648
[statique] Entier signé 32 bits représentable le plus faible, soit -2 147 483 648.
int
Détails du constructeur

int

()Constructeur
public function int(num:Object)

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Constructeur qui crée un nouvel objet int. L’utilisation du constructeur int est obligatoire si vous utilisez int.toString() et int.valueOf(). Ne faites pas appel à un constructeur si vous utilisez les propriétés d’un objet int. Le constructeur new int sert surtout d’espace réservé. Ne confondez pas l’objet int avec la fonction int(), qui convertit un paramètre en valeur primitive.

Paramètres
num:Object — Valeur numérique de l’objet int en cours de création, ou valeur à convertir en nombre. La valeur par défaut est 0 si value n’est pas fourni.

Eléments de l’API associés


Exemple
Comment utiliser cet exemple
Le code suivant crée de nouveaux objets int :
	 var n1:int = new int(3.4);
	 var n2:int = new int(-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 int.

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 — Chaîne.

Exemple
Comment utiliser cet exemple
L’exemple suivant utilise 2 et 8 pour le paramètre radix et renvoie une chaîne qui contient la représentation correspondante du numéro 9 :
	 var myint:int = new int(9);
	 trace(myint.toString(2)); // 1001
	 trace(myint.toString(8)); // 11
	 

L’exemple suivant renvoie une valeur hexadécimale.

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

valueOf

()méthode 
AS3 function valueOf():int

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Renvoie la valeur primitive de l’objet int spécifié.

Valeur renvoyée
int — Valeur int.

Exemple
Comment utiliser cet exemple
L’exemple suivant a pour résultat la valeur primitive de l’objet numSocks.
	 var numSocks:int = new int(2);
	 trace(numSocks.valueOf()); // 2
	 
Détails de la constante

MAX_VALUE

Constante
public static const MAX_VALUE:int = 2147483647

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Entier signé 32 bits représentable le plus élevé, soit 2 147 483 647.


Exemple
Comment utiliser cet exemple
Le code ActionScript suivant affiche l’objet int représentable le plus élevé et l’objet int représentable le plus faible dans le panneau Sortie :
	trace("int.MIN_VALUE = "+int.MIN_VALUE);
	trace("int.MAX_VALUE = "+int.MAX_VALUE);
	

Ce code affiche les valeurs suivantes :

	int.MIN_VALUE = -2147483648
	int.MAX_VALUE = 2147483647
	

MIN_VALUE

Constante 
public static const MIN_VALUE:int = -2147483648

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Entier signé 32 bits représentable le plus faible, soit -2 147 483 648.


Exemple
Comment utiliser cet exemple
Le code ActionScript suivant affiche les objets int représentables le plus élevé et le plus faible dans le panneau Sortie :
     trace("int.MIN_VALUE = "+int.MIN_VALUE);
     trace("int.MAX_VALUE = "+int.MAX_VALUE);
     

Ce code affiche les valeurs suivantes :

	int.MIN_VALUE = -2147483648
	int.MAX_VALUE = 2147483647
     
IntExample.as

L’exemple suivant exploite la classe IntExample pour indiquer comment manipuler les données de type int et vérifier leur validité :
  1. Deux variables int, a et b, sont déclarées dans le constructeur.
  2. Les deux ints sont ajoutés à l’aide de la méthode addIntegers().
  3. Une troisième variable int, c reçoit la sortie de parseInteger(), qui vérifie la validité de la chaîne qui lui a été transmise pour s’assurer qu’il s’agit bien d’un entier avec une plage acceptable pour les types de données int. Elle renvoie ensuite une valeur int qui est égale à l’entier de la valeur de la chaîne, si cette dernière est valide.
  4. Les variables int, a et c, sont ajoutées à l’aide de addIntegers().
package {
    import flash.display.Sprite;

    public class IntExample extends Sprite {    
        public function IntExample() {
            var a:int = 512;
            var b:int = -128;
            
            trace(addIntegers(a, b)); // 384

            var c:int = parseInteger("32");
            
            trace(addIntegers(a, c)); // 544
        }
            
        public function addIntegers(a:int, b:int):int {
            return a + b;
        }
        
        public function parseInteger(str:String):int {
            var num:Number = parseInt(str);
            if(!isNaN(num) && num <= int.MAX_VALUE && num >= int.MIN_VALUE) {
                return int(num);
            }
            
            return 0;
        }
        
    }
}




[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.