Number

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

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Type de données représentant un nombre à virgule flottante à deux décimales conforme à IEEE -754. Vous pouvez manipuler des valeurs numériques primitives à l’aide des méthodes et des propriétés associées à la classe Number. Cette classe est identique à la classe JavaScript Number.

Les propriétés de la classe Number 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.

Le type de données Number est conforme à la norme IEEE-754 relative aux nombres à deux décimales.

Il s’avère utile lorsque vous utilisez des valeurs à virgule flottante. Les moteurs d’exécution de Flash gèrent mieux les types de données int et uint que le type de données Number, mais Number est utile lorsque la plage de valeurs requises dépasse la plage valide des types de données int et uint. La classe Number permet de représenter des valeurs d’entier qui dépassent nettement la plage valide des types de données int et uint. Le type de données Number utilise jusqu’à 53 bits pour représenter les valeurs d’entier, alors que int et uint sont limités à 32 bits. La valeur par défaut d’une variable de type Number est NaN (n’est pas un nombre).

Consulter les exemples

Eléments de l’API associés

int
uint

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
		Number(num:Object) Crée un objet Number à la valeur spécifiée.	Number
		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.	Number
		toFixed(fractionDigits:uint):String Renvoie une représentation sous forme de chaîne du nombre en notation à virgule fixe.	Number
		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.	Number
		toString(radix:Number = 10):String Renvoie la représentation sous la forme d’une chaîne spécifiant l’objet Number spécifié (myNumber).	Number
		valueOf():Number Renvoie le type de valeur primitive de l’objet Number spécifié.	Number

Constantes publiques

	Constante		Défini par
		MAX_VALUE : Number [statique] Nombre représentable le plus élevé (à deux décimales conformément à IEEE-754).	Number
		MIN_VALUE : Number [statique] Nombre représentable le plus faible conformément à IEEE 1394 (le plus proche de zéro, pas le plus négatif) qui ne se compare pas égal à zéro.	Number
		NaN : Number [statique] Valeur IEEE-754 ne représentant pas une valeur numérique (NaN).	Number
		NEGATIVE_INFINITY : Number [statique] Spécifie la valeur IEEE-754 représentant l’infini négatif.	Number
		POSITIVE_INFINITY : Number [statique] Spécifie la valeur IEEE-754 représentant l’infini positif.	Number

Détails du constructeur

()

Constructeur

public function Number(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 Number à la valeur spécifiée. L’effet de ce constructeur est identique à celui de la fonction native publique Number(), qui convertit un objet d’un autre type en valeur numérique primitive.

Paramètres

num:Object — La valeur numérique de l’occurrence de Number en cours de création, ou valeur à convertir en objet Number. La valeur par défaut est de 0 si num n’est pas spécifié. Utiliser le constructeur sans spécifier de paramètre num n’est pas équivalent à la déclaration d’une variable de type Number à laquelle n’est affectée aucune valeur (telle que var myNumber:Number), qui correspond par défaut à NaN. Un nombre auquel n’est pas affectée de valeur n’est pas défini et constitue l’équivalent de new Number(undefined).

Eléments de l’API associés

Number.toString()
Number.valueOf()

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:Number = 10):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 la forme d’une chaîne spécifiant l’objet Number spécifié (myNumber). Si la valeur de l’objet Number est un nombre décimal sans zéro à gauche (tel que 0,4), Number.toString() ajoute le zéro (0,4).

Paramètres

radix:Number (default = 10) — 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 numérique de l’objet Number sous forme de chaîne.

valueOf

()

méthode

AS3 function valueOf():Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Renvoie le type de valeur primitive de l’objet Number spécifié.

Valeur renvoyée

Number — Valeur de type primitive de l’objet Number.

Détails de la constante

MAX_VALUE

Constante

public static const MAX_VALUE:Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Nombre représentable le plus élevé (à deux décimales conformément à IEEE-754). La valeur de ce nombre est d’environ 1,79e+308.

MIN_VALUE

Constante

public static const MIN_VALUE:Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Nombre représentable le plus faible conformément à IEEE 1394 (le plus proche de zéro, pas le plus négatif) qui ne se compare pas égal à zéro. Sur la plupart des plates-formes, ce nombre est proche de 5e-324, mais peut être plus élevé sur les systèmes qui ne prennent pas en charge les nombres dénormalisés. Par exemple, sur iOS la valeur de cette constante est de 2.225e-308.

Remarque : le nombre global représentable le plus faible absolu est -Number.MAX_VALUE.

NaN

Constante

public static const NaN:Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Valeur IEEE-754 ne représentant pas une valeur numérique (NaN).

Eléments de l’API associés

Fonction globale isNaN()

NEGATIVE_INFINITY

Constante

public static const NEGATIVE_INFINITY:Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Spécifie la valeur IEEE-754 représentant l’infini négatif. La valeur de cette propriété est identique à celle de la constante -Infinity.

L’infini négatif est une valeur numérique spéciale renvoyée lorsqu’une opération mathématique ou une fonction renvoie une valeur négative supérieure à celle pouvant être représentée.

POSITIVE_INFINITY

Constante

public static const POSITIVE_INFINITY:Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Spécifie la valeur IEEE-754 représentant l’infini positif. La valeur de cette propriété est identique à celle de la constante Infinity.

L’infini positif est une valeur numérique spéciale renvoyée lorsqu’une opération mathématique ou une fonction renvoie une valeur supérieure à celle pouvant être représentée.

Exemples Comment utiliser cet exemple

NumberExample.as

L’exemple suivant indique comment un nombre à six chiffres après la virgule est tronqué et arrondi pour obtenir avec un nombre à deux chiffres après la virgule.

package {
    import flash.display.Sprite;

    public class NumberExample extends Sprite {
        public function NumberExample() {
            var num:Number = new Number(10.456345);
            var str:String = num.toFixed(2);
            trace(num); // 10.456345
            trace(str); // 10.46
        }
    }
}

Informations juridiques | Politique de confidentialité en ligne

Number - AS3

Packagesx

Eléments du langage

Annexes

Classes x

Number

toExponential

toFixed

toPrecision

toString

valueOf

MAX_VALUE

MIN_VALUE

NaN

NEGATIVE_INFINITY

POSITIVE_INFINITY