Niveau supérieur 

Valeur spéciale représentant une valeur Infinity négative. La valeur de cette constante est identique à Number.NEGATIVE_INFINITY.

Eléments de l’API associés

trace(0 / 0);  // NaN
trace(7 / 0);  // Infinity
trace(-7 / 0); // -Infinity

Valeur spéciale représentant une valeur Infinity positive. La valeur de cette constante est identique à Number.POSITIVE_INFINITY.

Eléments de l’API associés

trace(0 / 0);  // NaN
trace(7 / 0);  // Infinity
trace(-7 / 0); // -Infinity

Membre spécial du type de données Number qui représente une valeur qui « n’est pas un nombre » (NaN). Lorsqu’une expression mathématique produit une valeur qui ne peut pas être exprimée sous forme de nombre, le résultat correspond à NaN. La liste suivante décrit des expressions courantes qui produisent NaN.

• La division par 0 ne renvoie NaN que si le diviseur est également 0. Si le diviseur est supérieur à 0, la division par 0 produit Infinity. Si le diviseur est inférieur à 0, la division par 0 produit -Infinity.
• Racine carrée d’un nombre négatif.
• Arc sinus d’un nombre non compris entre 0 et 1 (la plage valide).
• Infinity soustrait de Infinity.
• Infinity ou -Infinity divisé par Infinity or -Infinity.
• Infinity ou -Infinity multiplié par 0.

La valeur NaN ne fait pas partie des types de données int ou uint.

La valeur NaN n’étant pas considérée comme égale à toute autre valeur, NaN inclus, l’utilisation de l’opérateur d’égalité pour vérifier si une expression correspond à NaN est impossible. Pour déterminer si un nombre correspond à la fonction NaN, utilisez isNaN().

Eléments de l’API associés

Valeur spéciale appliquée aux variables sans type qui n’ont pas été initialisées ou aux propriétés d’objets dynamiques qui ne sont pas initialisées. Dans ActionScript 3.0, seules les variables qui n’ont pas de type peuvent recevoir la valeur undefined, contrairement à ActionScript 1.0 et ActionScript 2.0. Par exemple, les deux variables sont undefined dans la mesure où elles ne sont pas typées et pas initialisées :

• var foo;
• var bar:*;

La valeur undefined s’applique également aux propriétés non initialisées ou non définies d’objets dynamiques. Par exemple, si un objet est une occurrence de la classe Object, la valeur de toute propriété ajoutée dynamiquement est définie sur undefined jusqu’à ce qu’une valeur lui soit affectée.

Les résultats varient lorsque undefined est utilisé avec diverses fonctions :

• String(undefined) renvoie la valeur "undefined" (undefined est converti en chaîne).
• Number(undefined) renvoie la valeur NaN.
• int(undefined) et uint(undefined) renvoient la valeur 0.
• Object(undefined) renvoie une nouvelle occurrence d’Object.
• Si vous affectez la valeur undefined à une variable associée à un type, elle est convertie en la valeur par défaut du type de données.

Veillez à ne pas confondre undefined et null. Lorsque les propriétés null et undefined sont comparées avec l’opérateur d’égalité (==), elles sont considérées comme égales. Lorsque les propriétés null et undefined sont comparées avec l’opérateur d’égalité stricte (===), elles sont considérées comme différentes.

Eléments de l’API associés

// trace value of untyped and uninitialized variable
var myVar;
trace(myVar); // undefined

dynamic class A {}
var obj:A = new A()

// trace undefined property of obj
trace(obj.propName); // undefined

Crée un nouveau tableau. Le tableau peut être de longueur zéro ou plus, ou un tableau renseigné par un seul objet spécifié.

• Appeler Array() sans argument renvoie un tableau vide.
• Appeler Array() avec un seul argument entier renvoie un tableau de la longueur spécifiée, mais dont les éléments possèdent une valeur non définie.
• Appeler Array() avec un objet spécifié renvoie un tableau avec un élément de l’objet spécifié.

Remarque : si vous essayez d’utiliser la fonction Array() pour créer un nouveau tableau et transmettez plusieurs valeurs comme paramètres pour renseigner le tableau, vous obtenez une erreur de compilateur. La fonction Array() ne prend en charge qu’un seul paramètre. Utilisez plutôt le constructeur de classe Array pour créer et renseigner un tableau de plusieurs valeurs.

La fonction Array() n’a pas projeté le type d’un objet sur un tableau. Utilisez l’opérateur as pour effectuer une conversion de type explicite, ou attribution de type, si l’argument n’est pas une valeur primitive. Pour plus d’informations, voir la section Exemple de cette entrée. Si vous transmettez un objet en tant que paramètre à la fonction Array(), un nouveau tableau contenant l’objet en tant qu’élément est créé.

Paramètres

Eléments de l’API associés

var obj:Object = [ "a", "b", "c" ];
      
var newArray:Array = Array( obj );

trace(newArray == obj);    // false
trace(newArray[0] == obj); // true
trace(newArray[0][0])      // a
trace(newArray[0][1])      // b
trace(newArray[0][2])      // c

var obj:Object = [ "a", "b", "c" ];
      
var newArray:Array = obj as Array;

trace(newArray == obj); // true
trace(newArray[0]);     // a
trace(newArray[1]);     // b
trace(newArray[2]);     // c

Convertit le paramètre expression en une valeur booléenne et renvoie une valeur.

La valeur renvoyée varie selon le type de données et la valeur de l’argument, comme décrit dans le tableau suivant :

A l’encontre des versions antérieures d’ActionScript, la fonction Boolean() renvoie les mêmes résultats que le constructeur de classe Boolean.

Paramètres

Décode une URI codée pour produire une chaîne. Renvoie une chaîne dans laquelle tous les caractères précédemment codés par la fonction encodeURI retrouvent leur forme non codée.

Le tableau suivant contient l’ensemble de séquences d’échappement qui ne sont pas décodées par la fonction decodeURI pour obtenir des caractères. Utilisez decodeURIComponent() pour décoder les séquences d’échappement répertoriées dans ce tableau.

Paramètres

Eléments de l’API associés

package {
    import flash.display.Sprite;

    public class DecodeURIExample extends Sprite {
        public function DecodeURIExample() {
            var uri:String = "http://www.example.com/application.jsp?user=<user name='some user'></user>";
            var encoded:String = encodeURI(uri);
            var decoded:String = decodeURI(encoded);
            trace(uri);        // http://www.example.com/application.jsp?user=<user name='some user'></user>
            trace(encoded);    // http://www.example.com/application.jsp?user=%3Cuser%20name='some%20user'%3E%3C/user%3E
            trace(decoded);    // http://www.example.com/application.jsp?user=<user name='some user'></user>
        }
    }
}

Décode un composant URI codé pour produire une chaîne. Renvoie une chaîne dont tous les caractères précédemment convertis en séquence d’échappement par la fonction encodeURIComponent retrouvent leur forme non codée.

Cette fonction est différente de la fonction decodeURI() en ce sens qu’elle est conçue pour être utilisée uniquement avec une partie de chaîne URI appelée composant URI. Un composant URI correspond à tout texte compris entre des caractères spéciaux nommés séparateurs de composants ( : / ; et ? ). « http » et « www.adobe.com » sont des exemples courants de composant URI.

Il existe une autre différence majeure entre cette fonction et decodeURI() : parce la fonction part du principe qu’elle manipule un composant URI, elle traite les séquences d’échappement qui représentent des caractères de séparation spéciaux ( ; / ? : @ & = + $ , #) en tant que texte ordinaire qui doit être décodé.

Paramètres

Eléments de l’API associés

Convertit une chaîne en URI (Uniform Resource Identifier) valide. Convertit une URI complète en chaîne dont tous les caractères sont codés en tant que séquences d’échappement UTF-8, à moins qu’un caractère n’appartienne à un petit groupe de caractères de base.

Le tableau suivant répertorie l’ensemble complet des caractères de base qui ne sont pas convertis en séquences d’échappement UTF-8 par la fonction encodeURI.

Paramètres

Eléments de l’API associés

package {
    import flash.display.Sprite;

    public class EncodeURIExample extends Sprite {
        public function EncodeURIExample() {
            var uri:String = "http://www.example.com/application.jsp?user=<user name='some user'></user>";
            var encoded:String = encodeURI(uri);
            var decoded:String = decodeURI(encoded);
            trace(uri);        // http://www.example.com/application.jsp?user=<user name='some user'></user>
            trace(encoded);    // http://www.example.com/application.jsp?user=%3Cuser%20name='some%20user'%3E%3C/user%3E
            trace(decoded);    // http://www.example.com/application.jsp?user=<user name='some user'></user>
        }
    }
}

Convertit une chaîne en composant URI valide. Convertit une sous-chaîne d’URI en chaîne dont tous les caractères sont convertis en séquences d’échappement UTF-8, à moins qu’un caractère n’appartienne à un groupe très réduit de caractères de base.

La fonction encodeURIComponent() est différente de la fonction encodeURI() en ce sens qu’elle est conçue pour être utilisée uniquement avec une partie de chaîne URI appelée composant URI. Un composant URI correspond à tout texte compris entre des caractères spéciaux nommés séparateurs de composants ( : / ; et ? ). « http » et « www.adobe.com » sont des exemples courants de composant URI.

Il existe une autre différence majeure entre cette fonction et encodeURI() : dans la mesure où la fonction manipule un composant URI, elle traite les caractères de séparation spéciaux ( ; / ? : @ & = + $ , #) en tant que texte ordinaire qui doit être codé.

Le tableau suivant répertorie tous les caractères qui ne sont pas convertis en séquences d’échappement UTF-8 par la fonction encodeURIComponent.

Paramètres

Eléments de l’API associés

Convertit le paramètre en chaîne et applique le format de code URL, où la plupart des caractères qui ne sont pas de type alphanumérique sont remplacés par des séquences hexadécimales %. Lorsque cette fonction est utilisée dans une chaîne codée au format URL, le symbole pour cent (%) introduit les caractères d’échappement et ne doit pas être confondu avec l’opérateur modulo (%).

Le tableau suivant répertorie tous les caractères qui ne sont pas convertis en séquences d’échappement par la fonction escape().

Remarque : Utilisez la fonction encodeURIComponent() au lieu de la fonction escape() pour traiter les caractères séparateurs spéciaux (@ + /) comme étant du texte régulier à coder.

Paramètres

Eléments de l’API associés

Convertit une valeur numérique spécifiée en entier. Les valeurs décimales sont tronquées au niveau de la virgule.

Paramètres

Eléments de l’API associés

Renvoie true si la valeur est un nombre fini, false si la valeur est Infinity ou -Infinity. La présence de Infinity ou -Infinity indique une erreur mathématique, telle que la division par 0.

Paramètres

Renvoie true si la valeur est NaN (not a number : n’est pas un nombre). La fonction isNaN() permet de s’assurer qu’une expression mathématique a été évaluée correctement en tant que nombre. La fonction isNaN() est principalement utilisée pour vérifier la valeur renvoyée par les fonctions parseInt() et parseFloat(). La valeur NaN est un membre spécial du type de données Number et représente une valeur qui « n’est pas un nombre ».

Remarque : La valeur NaN ne fait pas partie des types de données int ou uint.

Le tableau ci-dessous décrit la valeur renvoyée par isNaN() pour divers types et valeurs d’entrées (si les avertissements de votre compilateur sont réglés sur le mode strict, certaines des opérations suivantes pourront générer des erreurs de compilation).

Paramètres

Détermine si la chaîne spécifiée est un nom valide d’attribut ou d’élément XML.

Paramètres

Convertit une valeur spécifique en valeur numérique. Le tableau suivant affiche le résultat de divers types d’entrées :

Paramètres

Plus d’exemples

Dans ActionScript 3.0, chaque valeur est un objet, ce qui signifie qu’appeler Object() pour une valeur renvoie celle-ci.

Paramètres

Convertit une chaîne en nombre à virgule flottante. Cette fonction lit, ou analyse, et renvoie les nombres dans une chaîne jusqu’à ce que cette dernière atteigne un caractère qui ne fait pas partie du nombre initial. Si la chaîne ne commence pas par un nombre qui peut être analysé, parseFloat() renvoie NaN. L’espace blanc qui précède un entier valide est ignoré, comme les caractères de fin non numériques.

Paramètres

Convertit une chaîne en entier. Si la chaîne spécifiée par les paramètres ne peut pas être convertie en nombre, la fonction renvoie NaN. Les chaînes commençant par 0x sont interprétées en tant que nombres hexadécimaux. A l’encontre des versions antérieures d’ActionScript, les entiers débutant par 0 ne sont not interprétés comme des nombres octaux. Vous devez spécifier la base 8 pour les nombres octaux. L’espace blanc et les zéros qui précèdent un entier valide sont ignorés, tout comme les caractères de fin non numériques.

Paramètres

Renvoie une chaîne représentant le paramètre spécifié.

Le tableau suivant affiche le résultat de divers types d’entrées :

Paramètres

Plus d’exemples

Affiche des expressions ou effectue une consignation dans les fichiers journaux pendant le débogage. Une instruction trace unique peut prendre en charge plusieurs arguments. Si un argument d’instruction trace comprend un type de données autre que String, la fonction trace appelle la méthode toString() associée correspondante. Si par exemple l’argument est une valeur booléenne, la fonction trace appelle Boolean.toString() et affiche la valeur renvoyée.

Paramètres

package {
    import flash.display.Sprite;

    public class TraceExample extends Sprite {

        public function TraceExample() {
            trace("Hello World");
        }
    }
}

Convertit une valeur numérique spécifiée en entier non signé. Les valeurs décimales sont tronquées au niveau de la virgule.

Le tableau ci-dessous décrit la valeur renvoyée par uint() pour divers types et valeurs d’entrées.

Paramètres

Eléments de l’API associés

Evalue le paramètre str en tant que chaîne, décode la chaîne qui est au format codé en URL (en convertissant toutes les séquences hexadécimales en caractères ASCII) et renvoie cette chaîne.

Paramètres

Crée une nouvelle occurrence de Vector dont les éléments sont des occurrences du type de données spécifié. Lorsque vous appelez cette fonction, vous spécifiez le type de données des éléments du vecteur résultant (le type de base du vecteur) à l’aide d’un paramètre type. Cette fonction utilise la même syntaxe utilisée lors de la déclaration d’une occurrence de Vector ou de l’appel du constructeur new Vector.<T>() :

var v:Vector.<String> = Vector.<String>(["Hello", "World"]);

Le vecteur résultant est renseigné avec les valeurs contenues dans les éléments de l’argument sourceArray. Si l’argument sourceArray est déjà une occurrence de Vector.<T>, où T représente le type de base, la fonction renvoie ce vecteur. Sinon, le vecteur résultant est renseigné avec les éléments du vecteur ou du tableau sourceArray.

Quoi qu’il en soit, le type de données de tous les éléments de l’argument sourceArray doit correspondre au type de base T spécifié dans l’appel de fonction.

Si la valeur length de la propriété sourceArray est de 0, la fonction renvoie un vecteur vide.

Si un vecteur est transmis en tant qu’argument sourceArray et que son type de base n’est pas T, ou si un tableau est transmis et que ses éléments ne sont pas des occurrences du type de base T, une tentative de conversion des valeurs au type de base est effectuée. Si les valeurs peuvent être automatiquement converties, le vecteur obtenu contient les valeurs converties. Si aucune conversion n’est possible, une erreur se produit.

De même, si un élément de l’argument sourceArray est une occurrence de la sous-classe du type de baseT, l’appel aboutit et l’élément est ajouté au vecteur résultant. Ceci est valable même si l’argument sourceArray est un vecteur dont le type de base est une sous-classe de T. C’est en fait le seul moyen de convertir un vecteur avec un type de base T en un vecteur avec un type de base étant une super-classe de T.

Par exemple, le code suivant génère une erreur de compilation en mode strict, ou une erreur TypeError à l’exécution, car il tente d’affecter un Vector.<Sprite> à une variable Vector.<DisplayObject> (Sprite est une sous-classe de DisplayObject) :

     var v1:Vector.<Sprite> = new Vector.<Sprite>();
     v1[0] = new Sprite();
     var v2:Vector.<DisplayObject> = v1;
     

La version alternative du code suivante copie avec succès les éléments d’une occurrence de Vector.<Sprite> sur une occurrence de Vector.<DisplayObject> :

     var v1:Vector.<Sprite> = new Vector.<Sprite>();
     v1[0] = new Sprite();
     var v2:Vector.<DisplayObject> = Vector.<DisplayObject>(v1);
     

Paramètres

Eléments de l’API associés

Convertit un objet en objet XML.

Le tableau suivant décrit les valeurs renvoyées pour divers types d’entrées.

Paramètres

Informations complémentaires

Eléments de l’API associés

Convertit un objet en objet XMLList.

Le tableau suivant décrit les valeurs renvoyées pour divers types d’entrées.

Paramètres

Eléments de l’API associés