Math - Guide de référence de l’API Adobe ActionScript® 3 (AS3 )

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

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

La classe Math contient des méthodes et des constantes qui représentent les fonctions et valeurs mathématiques courantes.

Utilisez les méthodes et les propriétés de cette classe pour accéder aux constantes et fonctions mathématiques et les manipuler. Toutes les propriétés et les méthodes de la classe Math sont statiques et doivent être appelées à l’aide de la syntaxe Math.method( parameter ) ou Math.constant. Dans ActionScript, les constantes sont définies selon la précision maximale des nombres à virgule flottante comportant deux décimales, conformément à IEEE-754.

Plusieurs méthodes de la classe Math utilisent la mesure d’un angle en radians en tant que paramètre. Vous pouvez utiliser l’équation suivante pour calculer les valeurs en radian avant d’appeler la méthode, puis exprimer la valeur calculée en tant que paramètre. Vous pouvez également utiliser toutes les valeurs situées à droite de l’équation (l’angle étant exprimé en radians plutôt qu’en degrees) en tant que paramètre radian.

Pour calculer une valeur radian, utilisez la formule suivante :

 radians = degrees * Math.PI/180

Pour convertir les radians en degrés, utilisez la formule suivante :

 degrees = radians * 180/Math.PI

Dans l’exemple suivant, l’équation est utilisée en tant que paramètre pour calculer le sinus d’un angle de 45° :

Math.sin(45 * Math.PI/180) est identique à Math.sin(.7854)

Remarque : les fonctions Math acos, asin, atan, atan2, cos, exp, log, pow, sin et sqrt risquent de produire un résultat légèrement différent selon les algorithmes utilisés par le processeur ou le système d’exploitation. Les moteurs d’exécution de Flash font appel au processeur (ou au système d’exploitation si le processeur ne prend pas en charge les calculs en virgule flottante) lorsqu’ils effectuent des calculs pour les fonctions indiquées et que les résultats sont légèrement différents selon le processeur ou le système d’exploitation utilisé.

Plus d’exemples

Utilisation de la classe Math avec les méthodes de dessin

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
		abs(val:Number):Number [statique] Calcule et renvoie la valeur absolue du nombre spécifié par le paramètre val.	Math
		acos(val:Number):Number [statique] Calcule et renvoie l’arc cosinus du nombre spécifié dans le paramètre val, en radians.	Math
		asin(val:Number):Number [statique] Calcule et renvoie l’arc sinus du nombre spécifié dans le paramètre val, en radians.	Math
		atan(val:Number):Number [statique] Calcule et renvoie la valeur, en radians, de l’angle dont la tangente est spécifiée dans le paramètre val.	Math
		atan2(y:Number, x:Number):Number [statique] Calcule et renvoie l’angle du point y/x en radians, lorsqu’il est mesuré dans le sens inverse des aiguilles d’une montre à partir de l’axe x d’un cercle (où 0,0 représente le centre du cercle).	Math
		ceil(val:Number):Number [statique] Renvoie la valeur maximale du nombre ou de l’expression spécifié(e).	Math
		cos(angleRadians:Number):Number [statique] Calcule et renvoie le cosinus de l’angle spécifié en radians.	Math
		exp(val:Number):Number [statique] Renvoie la valeur de la base du logarithme népérien (e), à la puissance de l’exposant spécifié dans le paramètre x.	Math
		floor(val:Number):Number [statique] Renvoie la valeur minimale du nombre ou de l’expression spécifié(e) dans le paramètre val.	Math
		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
		log(val:Number):Number [statique] Renvoie le logarithme népérien du paramètre val.	Math
		max(val1:Number, val2:Number, ... rest):Number [statique] Evalue val1 et val2 (ou plusieurs valeurs) et renvoie la valeur la plus grande.	Math
		min(val1:Number, val2:Number, ... rest):Number [statique] Evalue val1 et val2 (ou plusieurs valeurs) et renvoie la valeur inférieure.	Math
		pow(base:Number, pow:Number):Number [statique] Calcule et renvoie base à la puissance de pow.	Math
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		random():Number [statique] Renvoie un nombre pseudo-aléatoire n, où 0 <= n < 1.	Math
		round(val:Number):Number [statique] Arrondit la valeur du paramètre val à l’entier immédiatement supérieur ou inférieur et la renvoie.	Math
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		sin(angleRadians:Number):Number [statique] Calcule et renvoie le sinus de l’angle spécifié en radians.	Math
		sqrt(val:Number):Number [statique] Calcule et renvoie la racine carrée du nombre spécifié.	Math
		tan(angleRadians:Number):Number [statique] Calcule et renvoie la tangente de l’angle spécifié.	Math
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object

Constantes publiques

	Constante		Défini par
		E : Number = 2.71828182845905 [statique] Constante mathématique pour la base des logarithmes népériens, exprimée en e.	Math
		LN10 : Number = 2.302585092994046 [statique] Constante mathématique pour le logarithme népérien de 10, exprimée sous la forme de loge10, d’une valeur approximative de 2,302585092994046.	Math
		LN2 : Number = 0.6931471805599453 [statique] Constante mathématique pour le logarithme népérien de 2, exprimée sous la forme de loge2, d’une valeur approximative de 0,6931471805599453.	Math
		LOG10E : Number = 0.4342944819032518 [statique] Constante mathématique pour le logarithme en base 10 de la constante e (Math.E), exprimée sous la forme de log10e, d’une valeur approximative de 0,4342944819032518.	Math
		LOG2E : Number = 1.442695040888963387 [statique] Constante mathématique pour le logarithme en base 2 de la constante e, exprimée sous la forme de log2e, d’une valeur approximative de 1,442695040888963387.	Math
		PI : Number = 3.141592653589793 [statique] Constante mathématique pour le ratio de la circonférence d’un cercle par rapport à son diamètre, exprimée sous la forme de pi, d’une valeur de 3,141592653589793.	Math
		SQRT1_2 : Number = 0.7071067811865476 [statique] Constante mathématique pour la racine carrée de un demi, d’une valeur approximative de 0,7071067811865476.	Math
		SQRT2 : Number = 1.4142135623730951 [statique] Constante mathématique pour la racine carrée de 2, d’une valeur approximative de 1,4142135623730951.	Math

Détails de la méthode

abs

()

méthode

public static function abs(val:Number):Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcule et renvoie la valeur absolue du nombre spécifié par le paramètre val.

Paramètres

val:Number — Nombre dont la valeur absolue est renvoyée.

Valeur renvoyée

Number — Valeur absolue du paramètre spécifié.

acos

()

méthode

public static function acos(val:Number):Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcule et renvoie l’arc cosinus du nombre spécifié dans le paramètre val, en radians.

Paramètres

val:Number — Nombre compris entre -1,0 et 1,0.

Valeur renvoyée

Number — Arc cosinus du paramètre val.

asin

()

méthode

public static function asin(val:Number):Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcule et renvoie l’arc sinus du nombre spécifié dans le paramètre val, en radians.

Paramètres

val:Number — Nombre compris entre -1,0 et 1,0.

Valeur renvoyée

Number — Nombre compris entre pi négatif divisé par 2 et pi positif divisé par 2.

atan

()

méthode

public static function atan(val:Number):Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcule et renvoie la valeur, en radians, de l’angle dont la tangente est spécifiée dans le paramètre val. La valeur renvoyée est comprise entre pi négatif divisé par 2 et pi positif divisé par 2.

Paramètres

val:Number — Nombre représentant la tangente d’un angle.

Valeur renvoyée

Number — Nombre compris entre pi négatif divisé par 2 et pi positif divisé par 2.

atan2

()

méthode

public static function atan2(y:Number, x:Number):Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcule et renvoie l’angle du point y/x en radians, lorsqu’il est mesuré dans le sens inverse des aiguilles d’une montre à partir de l’axe x d’un cercle (où 0,0 représente le centre du cercle). La valeur renvoyée est comprise entre pi positif et pi négatif. Notez que le premier paramètre attribué à atan2 correspond toujours à la coordonnée y.

Paramètres

	`y:Number` — Coordonnée y du point.

	`x:Number` — Coordonnée x du point.

Valeur renvoyée

Number — Un nombre.

Eléments de l’API associés

Math.acos()
Math.asin()
Math.atan()
Math.cos()
Math.sin()
Math.tan()

ceil

()

méthode

public static function ceil(val:Number):Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Renvoie la valeur maximale du nombre ou de l’expression spécifié(e). La valeur maximale d’un nombre est l’entier le plus proche supérieur ou égal au nombre.

Paramètres

val:Number — Nombre ou expression.

Valeur renvoyée

Number — Entier le plus proche et supérieur ou égal au paramètre val.

Eléments de l’API associés

Math.floor()
Math.round()

cos

()

méthode

public static function cos(angleRadians:Number):Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcule et renvoie le cosinus de l’angle spécifié en radians. Pour calculer un radian, voir la présentation de la classe Math.

Paramètres

angleRadians:Number — Nombre représentant un angle mesuré en radians.

Valeur renvoyée

Number — Nombre compris entre -1,0 et 1,0.

Eléments de l’API associés

Math.acos()
Math.asin()
Math.atan()
Math.atan2()
Math.sin()
Math.tan()

exp

()

méthode

public static function exp(val:Number):Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Renvoie la valeur de la base du logarithme népérien (e), à la puissance de l’exposant spécifié dans le paramètre x. La constante Math.E peut renvoyer la valeur e.

Paramètres

val:Number — Exposant ; un nombre ou une expression.

Valeur renvoyée

Number — e à la puissance du paramètre val.

Eléments de l’API associés

Math.E

floor

()

méthode

public static function floor(val:Number):Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Renvoie la valeur minimale du nombre ou de l’expression spécifié(e) dans le paramètre val. La valeur minimale est l’entier le plus proche inférieur ou égal au nombre ou à l’expression spécifié(e).

Paramètres

val:Number — Nombre ou expression.

Valeur renvoyée

Number — Entier le plus proche et inférieur ou égal au paramètre val.

log

()

méthode

public static function log(val:Number):Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Renvoie le logarithme népérien du paramètre val.

Paramètres

val:Number — Nombre ou expression d’une valeur supérieure à 0.

Valeur renvoyée

Number — Logarithme népérien du paramètre val.

max

()

méthode

public static function max(val1:Number, val2:Number, ... rest):Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Evalue val1 et val2 (ou un nombre supérieur de valeurs), puis renvoie la valeur supérieure.

Paramètres

	`val1:Number` — Nombre ou expression.

	`val2:Number` — Nombre ou expression.

	`... rest` — Nombre ou expression. `Math.max()` peut accepter plusieurs arguments.

Valeur renvoyée

Number — Renvoie la valeur la plus élevée des paramètres val1 et val2 (ou un nombre supérieur de paramètres).

Eléments de l’API associés

Math.min()

min

()

méthode

public static function min(val1:Number, val2:Number, ... rest):Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Evalue val1 et val2 (ou un nombre supérieur de valeurs), puis renvoie la valeur inférieure.

Paramètres

	`val1:Number` — Nombre ou expression.

	`val2:Number` — Nombre ou expression.

	`... rest` — Nombre ou expression. `Math.min()` peut accepter plusieurs arguments.

Valeur renvoyée

Number — Renvoie la valeur inférieure des paramètres val1 et val2 (ou un nombre supérieur de paramètres).

Eléments de l’API associés

Math.max()

pow

()

méthode

public static function pow(base:Number, pow:Number):Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcule et renvoie base à la puissance de pow.

Paramètres

	`base:Number` — Nombre à élever à la puissance du paramètre `pow`.

	`pow:Number` — Nombre spécifiant la puissance à laquelle le paramètre `base` est élevé.

Valeur renvoyée

Number — Valeur de base à la puissance de pow.

random

()

méthode

public static function random():Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Renvoie un nombre pseudo-aléatoire n, où 0 <= n < 1. Le nombre renvoyé est calculé de façon confidentielle et « pseudo-aléatoire », dans la mesure où le calcul contient inévitablement certains éléments non aléatoires.

Valeur renvoyée

Number — Nombre pseudo-aléatoire.

Eléments de l’API associés

flash.crypto.generateRandomBytes()

round

()

méthode

public static function round(val:Number):Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Arrondit la valeur du paramètre val à l’entier immédiatement supérieur ou inférieur et la renvoie. Si val est équidistant par rapport aux deux entiers les plus proches (si le nombre se termine par ,5), la valeur est arrondie à l’entier immédiatement supérieur.

Paramètres

val:Number — Nombre à arrondir.

Valeur renvoyée

Number — Paramètre val arrondi à l’entier le plus proche.

Eléments de l’API associés

Math.ceil()
Math.floor()

sin

()

méthode

public static function sin(angleRadians:Number):Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcule et renvoie le sinus de l’angle spécifié en radians. Pour calculer un radian, voir la présentation de la classe Math.

Paramètres

angleRadians:Number — Nombre représentant un angle mesuré en radians.

Valeur renvoyée

Number — Nombre ; le sinus de l’angle spécifié (compris entre -1,0 et 1,0).

Eléments de l’API associés

Math.acos()
Math.asin()
Math.atan()
Math.atan2()
Math.cos()
Math.tan()

sqrt

()

méthode

public static function sqrt(val:Number):Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcule et renvoie la racine carrée du nombre spécifié.

Paramètres

val:Number — Nombre ou expression supérieur ou égal à 0.

Valeur renvoyée

Number — Si le paramètre val est supérieur ou égal à zéro, un nombre. Dans le cas contraire, NaN (n’est pas un nombre).

tan

()

méthode

public static function tan(angleRadians:Number):Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcule et renvoie la tangente de l’angle spécifié. Pour calculer un radian, voir la présentation de la classe Math.

Paramètres

angleRadians:Number — Nombre représentant un angle mesuré en radians.

Valeur renvoyée

Number — Tangente du paramètre angleRadians.

Eléments de l’API associés

Math.acos()
Math.asin()
Math.atan()
Math.atan2()
Math.cos()
Math.sin()

Détails de la constante

E

Constante

public static const E:Number = 2.71828182845905

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Constante mathématique pour la base des logarithmes népériens, exprimée en e. La valeur approximative de e est 2,71828182845905.

LN10

Constante

public static const LN10:Number = 2.302585092994046

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Constante mathématique pour le logarithme népérien de 10, exprimée sous la forme de log_e 10, d’une valeur approximative de 2,302585092994046.

LN2

Constante

public static const LN2:Number = 0.6931471805599453

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Constante mathématique pour le logarithme népérien de 2, exprimée sous la forme de log_e 2, d’une valeur approximative de 0.6931471805599453.

LOG10E

Constante

public static const LOG10E:Number = 0.4342944819032518

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Constante mathématique pour le logarithme en base 10 de la constante e (Math.E), exprimée sous la forme de log₁₀e, d’une valeur approximative de 0,4342944819032518.

La méthode Math.log() calcule le logarithme népérien d’un nombre. Multipliez le résultat de Math.log() par Math.LOG10E pour obtenir le logarithme en base 10.

LOG2E

Constante

public static const LOG2E:Number = 1.442695040888963387

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Constante mathématique pour le logarithme en base 2 de la constante e, exprimée sous la forme de log2e, d’une valeur approximative de 1,442695040888963387.

La méthode Math.log calcule le logarithme népérien d’un nombre. Multipliez le résultat de Math.log() par Math.LOG2E pour obtenir le logarithme en base 2.

PI

Constante

public static const PI:Number = 3.141592653589793

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Constante mathématique pour le ratio de la circonférence d’un cercle par rapport à son diamètre, exprimée sous la forme de pi, d’une valeur de 3,141592653589793.

SQRT1_2

Constante

public static const SQRT1_2:Number = 0.7071067811865476

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Constante mathématique pour la racine carrée de un demi, d’une valeur approximative de 0,7071067811865476.

SQRT2

Constante

public static const SQRT2:Number = 1.4142135623730951

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Constante mathématique pour la racine carrée de 2, d’une valeur approximative de 1,4142135623730951.

Informations juridiques | Politique de confidentialité en ligne

Math - AS3

Packagesx

Eléments du langage

Annexes

Classes x

abs

acos

asin

atan

atan2

ceil

cos

exp

floor

log

max

min

pow

random

round

sin

sqrt

tan

E

LN10

LN2

LOG10E

LOG2E

PI

SQRT1_2

SQRT2