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

Voir aussi

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

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

Voir aussi

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().

Voir aussi

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.

Voir aussi

// 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 tableau. Le tableau peut être de longueur zéro ou supérieure, ou contenir une liste d’éléments spécifiés, éventuellement de types de données différents. Le nombre et le type de données des arguments utilisés déterminent le contenu du tableau renvoyé.

• 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 une liste de valeurs spécifiques renvoie un tableau composé d’éléments contenant chacun des valeurs spécifiées.

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, consultez la section Exemple de cette entrée.

Paramètres

Voir aussi

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

Voir aussi

Renvoie une représentation sous forme de chaîne du jour, de la date, de l’heure et du fuseau horaire en cours. Le format de date utilisé pour la sortie est le suivant :

     Jou Moi Date HH:MM:SS TZD AAAA
     

Par exemple :

     Mer Avr 12 15:30:17 GMT-0700 2006
     

Pour associer une valeur au type Date, utilisez x as Date à la place de Date(x).

Voir aussi

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 not 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

Voir aussi

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

Voir aussi

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 de caractères de base qui ne sont pas convertis en séquences d’échappement UTF-8 par la fonction encodeURI.

Paramètres

Voir aussi

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

Voir aussi

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().

Paramètres

Voir aussi

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

Paramètres

Voir aussi

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 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.

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

Voir aussi

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

Paramètres

Voir aussi

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

Voir aussi

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

Voir aussi

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

Convertit un objet en objet XML.

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

Paramètres

Voir aussi

Convertit un objet en objet XMLList.

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

Paramètres

Voir aussi