Les opérateurs symboliques sont des caractères qui spécifient comment combiner, comparer ou modifier les valeurs d'une expression.


  Arithmétique
 +additionAjoute des expressions numériques.
 --decrementSoustrait 1 de l'opérande.
 /divisionDivise expression1 par expression2.
 ++incrementAjoute 1 à une expression.
 %moduloCalcule le reste de expression1 divisé par expression2.
 *multiplicationMultiplie deux expressions numériques.
 -subtractionUtilisé pour la négation ou la soustraction.
  Affectation composée arithmétique
 +=addition assignmentAffecte à expression1 la valeur de expression1 + expression2.
 /=division assignmentAffecte à expression1 la valeur de expression1 / expression2.
 %=modulo assignmentAffecte à expression1 la valeur de expression1 % expression2.
 *=multiplication assignmentAffecte à expression1 la valeur de expression1 * expression2.
 -=subtraction assignmentAffecte à expression1 la valeur de expression1 - expression2.
  Affectation
 =assignmentAffecte la valeur expression2 (opérande à droite) à la variable, l'élément de tableau ou une propriété dans expression1.
  Au niveau du bit
 &bitwise ANDConvertit expression1 et expression2 en entiers de 32 bits non signés et exécute une opération Boolean AND sur chaque bit des entiers entrés en tant que paramètres.
 <<bitwise left shiftConvertit expression1 et shiftCount en entiers de 32 bits et décale tous les bits de expression1 vers la gauche en fonction du nombre spécifié par l'entier résultant de la conversion de shiftCount.
 ~bitwise NOTConvertit l'expression en un entier signé de 32 bits, puis applique un complément à un au niveau du bit.
 |bitwise ORConvertit expression1 et expression2 en entiers non signés de 32 bits et insère un 1 à chaque position de bit, où les bits correspondant de expression1 ou expression2, sont de 1.
 >>bitwise right shiftConvertit expression et shiftCount en entiers de 32 bits et décale tous les bits de expression vers la droite en fonction du nombre spécifié par l'entier résultant de la conversion de shiftCount.
 >>>bitwise unsigned right shiftIdentique à l'opérateur de décalage vers la droite au niveau du bit (>>), à la différence qu'il ne conserve pas le signe de l'expression d'origine car les bits de gauche sont toujours remplacés par des 0.
 ^bitwise XORConvertit expression1 et expression2 en entiers non signés de 32 bits et insère un 1 à chaque position de bit, où les bits correspondant de expression1 ou expression2, mais pas des deux, sont de 1.
  Affectation composée au niveau du bit
 &=bitwise AND assignmentAffecte à expression1 la valeur de expression1 & expression2.
 <<=bitwise left shift and assignmentEffectue un décalage vers la gauche (<<=) au niveau du bit et stocke ensuite le contenu dans expression1.
 |=bitwise OR assignmentAffecte à expression1 la valeur de expression1 | expression2.
 >>=bitwise right shift and assignmentEffectue un décalage au niveau du bit vers la droite et stocke le résultat dans expression.
 >>>=bitwise unsigned right shift and assignmentEffectue un décalage droite au niveau du bit non signé et stocke le résultat dans expression.
 ^=bitwise XOR assignmentAffecte à expression1 la valeur de expression1 ^ expression2.
  Commentaire
 /*..*/block comment delimiterDélimite une ou plusieurs lignes de commentaires de script.
 //line comment delimiterSignale le début d'un commentaire de script.
  Comparaison
 ==equalityVérifie si deux expressions sont égales.
 >greater thanCompare deux expressions et détermine si expression1 est supérieur à expression2. Dans l'affirmative, le résultat est true.
 >=greater than or equal toCompare deux expressions et détermines si expression1 est supérieur ou égal à expression2 (true), ou si expression1 est inférieur à expression2 (false).
 !=inequalityRecherche l'inverse de l'opérateur d'égalité (==).
 <less thanCompare deux expressions et détermine si expression1 est inférieur ou égal à expression2. Dans l'affirmative, le résultat est true.
 <=less than or equal toCompare deux expressions et détermine si expression1 est inférieur ou égal à expression2. Dans l'affirmative, le résultat est true.
 ===strict equalityTeste l'égalité de deux expressions, mais sans conversion automatique des données.
 !==strict inequalityRecherche l'inverse exact de l'opérateur d'égalité stricte (===).
  Logique
 &&logical ANDRenvoie expression1 s'il a la valeur false ou peut être converti en false, expression2 dans tous les autres cas.
 &&=logical AND assignmentAffecte à expression1 la valeur de expression1 && expression2.
 !logical NOTInverse la valeur Boolean d'une variable ou d'une expression.
 ||logical ORRenvoie expression1 s'il a la valeur true ou peut être converti en true, expression2 dans tous les autres cas.
 ||=logical OR assignmentAffecte à expression1 la valeur de expression1 || expression2.
  Autre
 []array accessInitialise un nouveau tableau, simple ou multidimensionnel, avec les éléments spécifiés (a0, etc.) ou accède aux éléments d'un tableau.
  asEvalue si une expression spécifiée par le premier opérande est membre du type de données indiqué par le deuxième opérande.
 ,commaEvalue expression1, puis expression2, et ainsi de suite.
 ?:conditionalEvalue expression1, et si la valeur de expression1 est true, le résultat reprend la valeur de expression2. Sinon, le résultat reprend la valeur de expression3.
  deleteDétruit la propriété objet spécifiée par reference. Le résultat est true si la propriété n'existe pas à la fin de l'opération, et false dans tous les autres cas.
 .dotAccède aux méthodes et aux variables de la classe, récupère et définit les propriétés de l'objet et délimite les packages ou les classes importé(e)s.
  inEvalue si une propriété fait partie d'un objet spécifique.
  instanceofEvalue si la chaîne de prototype d'une expression comprend l'objet prototype de function.
  isEvalue si un objet est compatible avec un certain type de données ou une certaine classe ou interface.
 ::name qualifierPermet d'identifier l'espace de noms d'une propriété, d'une méthode, d'une propriété ou d'un attribut XML.
  newInstancie une occurrence de classe.
 {}object initializerCrée un objet et l'initialise avec les paires de propriétés name et value spécifiées.
 ()parenthesesRegroupe un ou plusieurs paramètres, évalue les expressions de façon séquentielle ou entoure un ou plusieurs paramètres et les transmet en tant qu'arguments à une fonction placée avant les parenthèses.
 /RegExp delimiterLorsqu'ils entourent des caractères, indiquent que ceux-ci ont une valeur littérale et doivent être traités en tant qu'expression régulière (RegExp) et non pas en tant que variable, chaîne ou tout autre élément ActionScript.
 :typeUtilisé pour affecter un type aux données ; cet opérateur spécifie le type de variable, le type de renvoi de la fonction ou le type de paramètre de la fonction.
  typeofEvalue expression et renvoie une chaîne spécifiant son type de données.
  voidEvalue une expression, puis supprime sa valeur en renvoyant undefined.
  Chaîne
 +concatenationConcatène (combine) des chaînes.
 +=concatenation assignmentAffecte à expression1 la valeur de expression1 + expression2.
 "string delimiterLorsqu'ils entourent des caractères, indiquent que ces caractères ont une valeur littérale et sont considérés comme une chaîne, et non pas en tant que variable, valeur numérique ou tout autre élément ActionScript.
  XML
 @attribute identifierIdentifie les attributs d'un objet XML ou XMLList.
 { }braces (XML)Evalue une expression utilisée dans un initialiseur XML ou XMLList.
 [ ]brackets (XML)Accède à une propriété ou un attribut d'un objet XML ou XMLList.
 +concatenation (XMLList)Concatène (combine) des valeurs XML ou XML dans un objet XMLList.
 +=concatenation assignment (XMLList)Affecte à expression1, qui est un objet XMLList, la valeur de expression1 + expression2.
  delete (XML)Supprime les éléments ou les attributs XML spécifiés par reference.
 ..descendant accessorNavigue jusqu'aux éléments descendants d'un objet XML ou XMLList ou (combiné avec l'opérateur @) détecte les attributs correspondants des descendants.
 .dot (XML)Accède aux éléments enfant d'un objet XML ou XML, ou (combiné avec l'opérateur @) renvoie les attributs d'un objet XML ou XMLList.
 ( )parentheses (XML)Evalue une expression dans une construction E4X XML.
 < >XML literal tag delimiterDéfinit une balise XML dans un littéral XML.
Détails de l'opérateur
+ addition Opérateur
Utilisation
expression1 + expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Ajoute des expressions numériques. Si les deux expressions sont des entiers, la somme est un entier. Si l'une ou les deux expressions sont des nombres à virgule flottante, la somme est un nombre à virgule flottante.

Si l'une des expressions est une chaîne, toutes les autres sont converties en chaînes et concaténées au lieu d'être additionnées. Dans le cas contraire, si une expression n'est pas numérique, Flash® Player la convertit en nombre.

Opérandes
expression1:Number — Valeur à ajouter.
expression2:Number — Valeur à ajouter.

Résultat
Number — Entier ou nombre à virgule flottante.

Exemple
Utilisation des exemples
Cette instruction additionne les entiers 2 et 3 :
trace(2 + 3); // 5
Cette instruction additionne les nombres à virgule flottante 2,5 et 3,25 :
trace(2.5 + 3.25); // 5.75
Cet exemple montre que, si une expression est une chaîne, toutes les autres sont converties en chaînes et concaténées :
trace("Number " + 8 + 0); // Number 80
Le type de données des variables associées aux champs texte dynamique et de saisie est String. Dans l'exemple suivant, la variable deposit est un champ texte de saisie sur la scène. Lorsque l'utilisateur donne un acompte, le script tente d'ajouter deposit à oldBalance. Toutefois, le type de données de deposit étant String, le script concatène les valeurs des variables (les met bout à bout pour former une chaîne) au lieu de les additionner.
var oldBalance:Number = 1345.23; 
var currentBalance = deposit_txt.text + oldBalance; 
trace(currentBalance); 
Par exemple, si un utilisateur entre 475 dans le champ texte deposit, la fonction trace() envoie la valeur 4751345,23 au panneau de sortie. Pour y remédier, utilisez la fonction Number() pour convertir la chaîne en nombre de la manière suivante :
var oldBalance:Number = 1345.23; 
var currentBalance:Number = Number(deposit_txt.text) + oldBalance;
trace(currentBalance);

Voir aussi

+= addition assignment Opérateur  
Utilisation
expression1 += expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Affecte à expression1 la valeur de expression1 + expression2. Par exemple, les deux instructions suivantes ont le même résultat :

x += y; 
x = x + y; 
Toutes les règles de l'opérateur d'addition (+) s'appliquent à l'opérateur d'affectation de l'addition (+=).

Opérandes
expression1:Number — Nombre.
expression2:Number — Nombre.

Résultat
Number — Résultat de l'addition.

Exemple
Utilisation des exemples
L'exemple suivant illustre une utilisation numérique de l'opérateur d'affectation de l'addition (+=) :
var x:Number = 5; 
var y:Number = 10; 
x += y; 
trace(x); // 15 

Voir aussi

[] array access Opérateur  
Utilisation
myArray = [a0, a1,...aN]
myArray[i] = value 
myObject[propertyName]

Versions du moteur d'exécution: Flash Player 9

Initialise un nouveau tableau, simple ou multidimensionnel, avec les éléments spécifiés (a0, etc.) ou accède aux éléments d'un tableau. L'opérateur d'accès au tableau permet de définir et récupérer de façon dynamique des noms d'occurrence, de variable et d'objet. Il permet également d'accéder aux propriétés d'objet.

Utilisation 1 : Un tableau est un objet dont les propriétés sont appelées éléments, tous identifiés par des nombres appelés index. Lorsque vous créez un tableau, vous entourez les éléments avec l'opérateur ([]) d'accès au tableau (crochets). Un tableau peut regrouper différents types d'éléments. Par exemple, le tableau suivant, appelé employee, comporte trois éléments ; le premier est un nombre et les deux suivants sont des chaînes (entre guillemets) :

var employee:Array = [15, "Barbara", "Jay"]; 
Vous pouvez imbriquer des crochets pour simuler les tableaux multi-dimensionnels. Vous pouvez imbriquer jusqu'à 256 niveaux dans les tableaux. Le code suivant crée un tableau appelé ticTacToe et comportant trois éléments, chacun d'eux correspondant à un tableau de trois éléments :
var ticTacToe:Array = [[1, 2, 3], [4, 5, 6], [7, 8, 9]]; 
			
/* Select Debug > List Variables in test mode 
to see a list of the array elements.*/ 
Utilisation 2 : Mettez l'index de chaque élément entre crochets ([]) pour y accéder directement. Vous pouvez ajouter un nouvel élément à un tableau ou bien modifier ou récupérer la valeur d'un élément existant. Le premier index d'un tableau a toujours la valeur 0, comme dans l'exemple suivant :
var my_array:Array = new Array(); 
my_array[0] = 15; 
my_array[1] = "Hello"; 
my_array[2] = true; 
Vous pouvez utiliser des crochets pour ajouter un quatrième élément, comme dans l'exemple suivant :
my_array[3] = "George"; 
Vous pouvez utiliser des crochets pour accéder à un élément d'un tableau multidimensionnel. La première paire de crochets identifie l'élément dans le tableau d'origine, tandis que la deuxième identifie l'élément dans le tableau imbriqué. L'instruction trace() suivant détecte le troisième élément (index 2) du second tableau (index 1).
var ticTacToe:Array = [[1, 2, 3], [4, 5, 6], [7, 8, 9]]; 
trace(ticTacToe[1][2]); // 6 
Utilisation 3 : Vous pouvez utiliser l'opérateur d'accès au tableau pour définir et extraire de façon dynamique les valeurs d'une propriété d'objet.
var obj:Object = new Object();
obj.prop1 = "foo";
trace(obj["prop" + 1]); // foo
obj.prop2 = "bar";
for (j in obj) {
	trace(obj[j]);
} 
/* Output of for loop: 
foo
bar */

Opérandes
myArray:Object — Nom d'un tableau.
a0, a1,...aN:Object — Eléments d'un tableau ; tout type natif ou occurrence d'objet, y compris les tableaux imbriqués.
i:Number — Index entier supérieur ou égal à 0.
myObject:Object — Nom d'un objet.
propertyName:String — Chaîne qui nomme une propriété de l'objet.

Résultat
Object

Utilisation 1 : Référence à un tableau.

Utilisation 2 : Une valeur du tableau ; soit un type natif, soit une occurrence d'objet (y compris de tableau).

Utilisation 3 : Une propriété de l'objet ; soit un type natif, soit une occurrence d'objet (y compris de tableau).


Exemple
Utilisation des exemples
L'exemple suivant présente deux façons de créer un objet Array vide ; la première ligne utilise des crochets ([]) :
var my_array:Array = []; 
var my_array:Array = new Array(); 

L'exemple suivant crée un tableau appelé employee_array avec trois éléments et modifie le troisième.

var employee_array = ["Barbara", "George", "Mary"]; 
trace(employee_array); // Barbara,George,Mary 
employee_array[2] = "Sam"; 
trace(employee_array); // Barbara,George,Sam 
Dans l'exemple suivant, l'expression placée entre crochets est évaluée et le résultat obtenu est utilisé en tant que nom de la variable à récupérer dans l'objet obj :
var obj:Object = new Object();
obj.prop1 = "foo";
obj.prop2 = "bar";

for (var i:int = 1;i < 3;i++) {
    trace(obj["prop"+i]);
}
/* Output of for loop:
foo
bar */ 

Voir aussi

as Opérateur  
Utilisation
expression as datatype

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Evalue si une expression spécifiée par le premier opérande est membre du type de données indiqué par le deuxième opérande. Si le premier opérande est membre du type de données, le résultat est le premier opérande. Sinon, il contient la valeur null.

L'expression utilisée pour le second opérande doit renvoyer un type de données.

Opérandes
expression:* — Valeur à vérifier par rapport au type de données spécifié.
datatype:Class — Type de données utilisé pour évaluer l'opérande expression. Le type * spécial (sans type) ne peut pas être utilisé.

Résultat
Object — Le résultat est expression si expression est un membre du type de données spécifié dans datatype. Sinon, il contient la valeur null.

Exemple
Utilisation des exemples
L'exemple suivant crée un tableau simple appelé myArray et utilise l'opérateur as avec différents types de données.
public var myArray:Array = ["one", "two", "three"];
trace(myArray as Array);  // one,two,three
trace(myArray as Number); // null
trace(myArray as int);    // null

Voir aussi

= assignment Opérateur  
Utilisation
expression1 = expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Affecte la valeur expression2 (opérande à droite) à la variable, l'élément de tableau ou une propriété dans expression1. L'affectation peut se faire par valeur ou par référence. L'affectation par valeur copie la valeur réelle de expression2 et la stocke dans expression1. L'affectation par valeur est utilisé lorsque expression2 est une valeur primitive (son type de données est Boolean, Number, int, uint ou String). L'affectation par référence stocke une référence à expression2 dans expression1. L'affectation par référence est généralement utilisée avec l'opérateur new. L'opérateur new crée un objet en mémoire et une référence à cet emplacement en mémoire est affectée à une variable.

Remarque : dans ActionScript 3.0, toutes les valeurs (y compris les primitives) sont des objets, et toutes les affectations s'effectuent par référence. Cependant, les objets primitifs ont des opérateurs spéciaux qui les autorisent à se comporter comme s'ils avaient été affectés par valeur.

Opérandes
expression1:* — Variable, élément de tableau ou propriété d'un objet.
expression2:* — Valeur de tout type.

Résultat
Object — Valeur affectée, expression2.

Exemple
Utilisation des exemples
L'exemple suivant utilise l'affectation par valeur pour affecter la valeur de 5 à la variable z.
var z:Number = 5;
L'exemple suivant utilise l'affectation par valeur pour affecter la valeur hello à la variable z :
var x:String;
x = "hello";
L'exemple suivant utilise l'affectation par référence pour créer la variable moonsOfJupiter, qui contient une référence au nouvel objet Array créé. L'affectation par valeur est ensuite utilisée pour copier la valeur « Callisto » dans le premier élément du tableau référencé par la variable moonsOfJupiter :
var moonsOfJupiter:Array = new Array();
moonsOfJupiter[0] = "Callisto";
L'exemple suivant utilise l'affectation par référence pour créer un objet et lui affecter une référence à la variable mercury. L'affectation par valeur est ensuite utilisée pour affecter la valeur 3030 à la propriété diameter de l'objet mercury :
var mercury:Object = new Object();
mercury.diameter = 3030; // in miles
trace(mercury.diameter); // 3030
Cet exemple reprend l'exemple précédent et crée une variable appelée merkur (l'appellation allemande de mercure) et lui affecte la valeur mercury. Deux variables faisant référence au même objet dans la mémoire sont ainsi créées, ce qui signifie que vous pouvez utiliser l'une ou l'autre pour accéder aux propriétés de cet objet. Nous pouvons ensuite modifier la propriété diameter pour utiliser les kilomètres au lieu des miles :
var merkur:Object = mercury;
merkur.diameter = 4878;  // in kilometers
trace(mercury.diameter); // 4878

Voir aussi

@ attribute identifier Opérateur  
Utilisation
 myXML.@attributeName 

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Identifie les attributs d'un objet XML ou XMLList. Par exemple, myXML.@id identifie les attributs appelés id pour l'objet XML myXML. Vous pouvez également employer la syntaxe suivante pour accéder aux attributs : myXML.attribute("id"), myXML["@id"] et myXML.@["id"]. La syntaxe myXML.@id est recommandée. Pour renvoyer un objet XMLList pour tous les noms d'attribut, utilisez @*. Pour renvoyer un attribut dont le nom est un mot réservé d'ActionScript, employez la méthode attribute() au lieu de l'opérateur @.

Opérandes
attributeName:* — Nom de l'attribut.

Exemple
Utilisation des exemples
Le premier exemple montre comment utiliser l'opérateur @ (signe arobase) pour identifier un attribut d'un élément :
var myXML:XML = 
    <item id = "42">
        <catalogName>Presta tube</catalogName>
        <price>3.99</price>
    </item>;

trace(myXML.@id); // 42
L'exemple suivant renvoie tous les noms d'attribut :
var xml:XML =<example id='123' color='blue'/>
 var xml2:XMLList = xml.@*;
 trace(xml2 is XMLList); // true
 trace(xml2.length());  // 2
 for (var i:int = 0; i < xml2.length(); i++)
 { 
    trace(typeof(xml2[i]));    // xml
    trace(xml2[i].nodeKind()); // attribute
    trace(xml2[i].name());     // id and color
 } 
L'exemple suivant renvoie un attribut dont le nom est un mot réservé dans ActionScript. Vous ne pouvez pas utiliser la syntaxe xml.@class (car class est un mot réservé d'ActionScript). Vous devez utiliser la syntaxe xml.attribute("class") :
var xml:XML = <example class='123'/>
trace(xml.attribute("class"));

Voir aussi

& bitwise AND Opérateur  
Utilisation
expression1 & expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Convertit expression1 et expression2 en entiers non signés de 32 bits, et exécute une opération Boolean AND sur chaque bit des paramètres de l'entier. Les nombres à virgule flottante sont convertis en entiers en supprimant les chiffres après la virgule. Le résultat est un nouvel entier de 32 bits.

Un entier positif est converti en valeur hexadécimale non signée avec une valeur maximale de 4294967295 ou 0xFFFFFFFF ; une valeur supérieure au maximum perd ses chiffres les plus significatifs lorsqu'elle est convertie, de sorte que la valeur soit toujours de 32 bits. Un nombre négatif est converti en valeur hexadécimale non signée à l'aide de la notation complément à deux, avec une valeur minimale de -2147483648 ou 0x800000000 ; tout nombre inférieur à cette valeur minimale est converti en complément à deux avec une plus grande précision avant de perdre ses chiffres les plus significatifs.

Le résultat est interprété en tant que nombre à complément à deux de 32 bits, de sorte que le résultat soit un entier compris entre -2147483648 et 2147483647.

Opérandes
expression1:Number — Nombre ou expression évalué sous forme de nombre.
expression2:Number — Nombre ou expression évalué sous forme de nombre.

Résultat
int — Résultat de l'opération au niveau du bit.

Exemple
Utilisation des exemples
L'exemple suivant exécute une opération ET au niveau du bit de 13 (1101 en binaire) et 11 (1011 en binaire) en comparant les représentations des bits des nombres. L'entier résultant est composé d'une série de bits, tous à 1 uniquement si les bits des deux opérandes de la même position sont à 1.
var insert:Number = 13; 
var update:Number = 11; 
trace(insert & update); // 9 (or 1001 binary) 
L'opération ET au niveau du bit de 13 (1101 en binaire) et 11 (1011 en binaire) donne 9 car les première et dernière positions des deux nombres contiennent le nombre 1.
  1101
& 1011
  ----
  1001

Les exemples suivants illustrent le comportement de la conversion de la valeur renvoyée :

trace(0xFFFFFFFF); // 4294967295 
trace(0xFFFFFFFF & 0xFFFFFFFF); // -1 
trace(0xFFFFFFFF & -1); // -1 
trace(4294967295 & -1); // -1 
trace(4294967295 & 4294967295); // -1 

Voir aussi

&= bitwise AND assignment Opérateur  
Utilisation
expression1 &= expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Affecte à expression1 la valeur de expression1 & expression2. Par exemple, les deux expressions suivantes sont équivalentes :

x &= y; 
x = x & y; 

Opérandes
expression1:Number — Nombre ou expression évalué sous forme de nombre.
expression2:Number — Nombre ou expression évalué sous forme de nombre.

Résultat
int — Valeur de expression1 & expression2.

Exemple
Utilisation des exemples
L'exemple suivant affecte la valeur 9 à x :
var x:Number = 15; 
var y:Number = 9; 
trace(x &= y); // 9 

Voir aussi

<< bitwise left shift Opérateur  
Utilisation
expression1 << shiftCount

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Convertit expression1 et shiftCount en entiers de 32 bits et décale tous les bits de expression1 vers la gauche en fonction du nombre spécifié par l'entier résultant de la conversion de shiftCount. Les positions de bits qui sont vidées suite à cette opération sont remplies par des 0 et les bits déplacés vers la gauche sont supprimés. Le fait de décaler une valeur d'une unité vers la gauche revient à la multiplier par 2.

Un nombre à virgule flottante est converti en entier en supprimant tous les chiffres après la virgule. Un entier positif est converti en valeur hexadécimale non signée avec une valeur maximale de 4294967295 ou 0xFFFFFFFF ; une valeur supérieure au maximum perd ses chiffres les plus significatifs lorsqu'elle est convertie, de sorte que la valeur soit toujours de 32 bits. Un nombre négatif est converti en valeur hexadécimale non signée à l'aide de la notation complément à deux, avec une valeur minimale de -2147483648 ou 0x800000000 ; tout nombre inférieur à cette valeur minimale est converti en complément à deux avec une plus grande précision avant de perdre ses chiffres les plus significatifs.

Le résultat est interprété en tant que nombre à complément à deux de 32 bits, de sorte que le résultat soit un entier compris entre -2147483648 et 2147483647.

Si le résultat est un entier négatif, une erreur se produit à l'exécution si vous tentez d'affecter le résultat à une variable de type uint. Bien qu'ActionScript ne possède pas d'opérateur de « décalage gauche au niveau du bit non signé », vous pouvez obtenir le même résultat et éviter l'erreur d'exécution en utilisant uint(expression1 << shiftCount) :

var num1:uint = 0xFF;
var num2:uint = uint(num1 << 24); // uint() prevents runtime error

Opérandes
expression1:Number — Nombre ou expression à décaler vers la gauche.
shiftCount:Number — Nombre ou expression à convertir en entier compris entre 0 et 31.

Résultat
int — Résultat de l'opération au niveau du bit.

Exemple
Utilisation des exemples
Dans l'exemple suivant, l'entier 1 est décalé de 10 bits vers la gauche :
x = 1 << 10
Le résultat du décalage à gauche au niveau du bit est 1024, car le 1 décimal équivaut au 1 binaire, le 1 binaire décalé à gauche de 10 est la valeur binaire 10000000000 et la valeur binaire 10000000000 correspond au 1024 décimal :
   00000000001 binaire 
<<     10 décimal
--------------
   10000000000 binaire est égal à 1024 décimal 

Dans l'exemple suivant, l'entier 7 est décalé de 8 bits vers la gauche :

x = 7 << 8
Le résultat du décalage à gauche au niveau du bit est 1792, car le 7 décimal équivaut au 111 binaire, le 111 binaire décalé à gauche de 8 bits est la valeur binaire 11100000000 et la valeur binaire 11100000000 correspond au 1792 décimal :
   00000000111 binaire 
<<      8 décimal
--------------
   11100000000 binaire est égal à 1792 décimal 

L'instruction trace suivante montre le décalage de trois positions vers la gauche que les bits ont subi :

// 1 binary == 0001 
// 8 binary == 1000 
trace(1 << 3); // 8 

Voir aussi

<<= bitwise left shift and assignment Opérateur  
Utilisation
expression1 <<= expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Effectue un décalage vers la gauche (<<=) au niveau du bit et stocke ensuite le contenu dans expression1. Les deux expressions suivantes sont équivalentes :

A <<= B
A = (A << B)

Opérandes
expression1:Number — Nombre ou expression à décaler vers la gauche.
expression2:Number — Nombre ou expression à convertir en entier compris entre 0 et 31.

Résultat
int — Résultat de l'opération au niveau du bit.

Exemple
Utilisation des exemples
L'exemple suivant a recours au décalage vers la gauche au niveau du bit et à l'opérateur d'affectation (<<=) pour décaler tous les bits d'une unité vers la gauche :
var x:Number = 4; 
// Shift all bits one slot to the left. 
x <<= 1; 
trace(x); // 8 
// 4 decimal = 0100 binary 
// 8 decimal = 1000 binary 

Voir aussi

~ bitwise NOT Opérateur  
Utilisation
~expression

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Convertit l'expression en un entier signé de 32 bits, puis applique un complément à un au niveau du bit. Ainsi, tout bit 0 devient 1 et inversement. Le résultat est un nouvel entier signé de 32 bits. Cet opérateur est également connu comme complément d'opérateur du 1 ou opérateur de complément au niveau du bit.

Par exemple, la valeur hexadécimale 0x7777 est représentée de la façon suivante en binaire :

0111011101110111

La négation au niveau du bit de cette valeur, ~0x7777, renvoie :

1000100010001000

En hexadécimal, ceci se traduit par 0x8888. Par conséquent, ~0x7777 est 0x8888.

Les opérateurs au niveau du bit sont principalement utilisés pour représenter les bits indicateurs (valeurs Boolean contractées sur 1 bit).

Un nombre à virgule flottante est converti en entier en supprimant tous les chiffres après la virgule. Un entier positif est converti en valeur hexadécimale non signée avec une valeur maximale de 4294967295 ou 0xFFFFFFFF ; une valeur supérieure au maximum perd ses chiffres les plus significatifs lorsqu'elle est convertie, de sorte que la valeur soit toujours de 32 bits. Un nombre négatif est converti en valeur hexadécimale non signée à l'aide de la notation complément à deux, avec une valeur minimale de -2147483648 ou 0x800000000 ; tout nombre inférieur à cette valeur minimale est converti en complément à deux avec une plus grande précision avant de perdre ses chiffres les plus significatifs.

Le résultat est interprété en tant que nombre à complément à deux de 32 bits, de sorte que le résultat soit un entier compris entre -2147483648 et 2147483647.

Opérandes
expression:Number — Nombre à convertir.

Résultat
int — Résultat de l'opération au niveau du bit.

Exemple
Utilisation des exemples
L'exemple suivant montre l'utilisation de l'opérateur NOT (~) au niveau du bit avec des bits indicateurs :
var ReadOnlyFlag:int = 0x0001; // defines bit 0 as the read-only flag 
var flags:int = 0; 
trace(flags); 
/* To set the read-only flag in the flags variable, 
   the following code uses the bitwise OR: 
*/
flags |= ReadOnlyFlag; 
trace(flags); 
/* To clear the read-only flag in the flags variable, 
   first construct a mask by using bitwise NOT on ReadOnlyFlag. 
   In the mask, every bit is a 1 except for the read-only flag. 
   Then, use bitwise AND with the mask to clear the read-only flag. 
   The following code constructs the mask and performs the bitwise AND: 
*/ 
flags &= ~ReadOnlyFlag; 
trace(flags); 
// 0 1 0 

Voir aussi

| bitwise OR Opérateur  
Utilisation
expression1 | expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Convertit expression1 et expression2 en entiers non signés de 32 bits et insère un 1 à chaque position de bit, où les bits correspondant de expression1 ou expression2, sont de 1.

Un nombre à virgule flottante est converti en entier en supprimant tous les chiffres après la virgule. Un entier positif est converti en valeur hexadécimale non signée avec une valeur maximale de 4294967295 ou 0xFFFFFFFF ; une valeur supérieure au maximum perd ses chiffres les plus significatifs lorsqu'elle est convertie, de sorte que la valeur soit toujours de 32 bits. Un nombre négatif est converti en valeur hexadécimale non signée à l'aide de la notation complément à deux, avec une valeur minimale de -2147483648 ou 0x800000000 ; tout nombre inférieur à cette valeur minimale est converti en complément à deux avec une plus grande précision avant de perdre ses chiffres les plus significatifs.

Le résultat est interprété en tant que nombre à complément à deux de 32 bits, de sorte que le résultat soit un entier compris entre -2147483648 et 2147483647.

Opérandes
expression1:Number — Nombre.
expression2:Number — Nombre.

Résultat
int — Résultat de l'opération au niveau du bit.

Exemple
Utilisation des exemples
L'exemple suivant illustre une opération OR (|) au niveau du bit :
// 15 decimal = 1111 binary 
var a:Number = 15; 
// 9 decimal = 1001 binary 
var b:Number = 9; 
// 1111 | 1001 = 1111 
trace(a | b); // returns 15 decimal (1111 binary) 
Ne pas confondre le | simple (OU au niveau du bit) avec ||(OU logique).

Voir aussi

|= bitwise OR assignment Opérateur  
Utilisation
expression1 |= expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Affecte à expression1 la valeur de expression1 | expression2. Par exemple, les deux instructions suivantes sont équivalentes :

x |= y; 
x = x | y; 

Opérandes
expression1:Number — Nombre à convertir.
expression2:Number — Nombre à convertir.

Résultat
int — Résultat de l'opération au niveau du bit.

Exemple
Utilisation des exemples
L'exemple suivant utilise l'opérateur OR (|=) d'affectation au niveau du bit :
// 15 decimal = 1111 binary 
var a:Number = 15; 
// 9 decimal = 1001 binary 
var b:Number = 9; 
// 1111 |= 1001 = 1111 
trace(a |= b); // returns 15 decimal (1111 binary) 

Voir aussi

>> bitwise right shift Opérateur  
Utilisation
expression >> shiftCount

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Convertit expression et shiftCount en entiers de 32 bits et décale tous les bits de expression vers la droite en fonction du nombre spécifié par l'entier résultant de la conversion de shiftCount. Les bits décalés vers la droite sont supprimés. Pour préserver le signe de l'expression d'origine, les bits situés à gauche sont remplacés par des 0 si le bit le plus significatif (le plus à gauche) de expression est 0, et par des 1 si le bit le plus significatif est 1. Le décalage vers la droite d'une valeur d'une unité équivaut à une division par 2 et au rejet du reste.

Un nombre à virgule flottante est converti en entier en supprimant tous les chiffres après la virgule. Un entier positif est converti en valeur hexadécimale non signée avec une valeur maximale de 4294967295 ou 0xFFFFFFFF ; une valeur supérieure au maximum perd ses chiffres les plus significatifs lorsqu'elle est convertie, de sorte que la valeur soit toujours de 32 bits. Un nombre négatif est converti en valeur hexadécimale non signée à l'aide de la notation complément à deux, avec une valeur minimale de -2147483648 ou 0x800000000 ; tout nombre inférieur à cette valeur minimale est converti en complément à deux avec une plus grande précision avant de perdre ses chiffres les plus significatifs.

Le résultat est interprété en tant que nombre à complément à deux de 32 bits, de sorte que le résultat soit un entier compris entre -2147483648 et 2147483647.

Opérandes
expression:Number — Nombre ou expression à décaler vers la droite.
shiftCount:Number — Nombre ou expression à convertir en entier compris entre 0 et 31.

Résultat
int — Résultat de l'opération au niveau du bit.

Exemple
Utilisation des exemples
L'exemple suivant convertit 65535 en entier de 32 bits et le décale de 8 bits vers la droite, ce qui donne la valeur décimale 255 :
var a:Number = 65535 >> 8; 
trace(a); // 255
En effet, l'équivalent binaire de 65535 est 00000000000000001111111111111111 (seize zéros, suivis de seize uns). Le décalage vers la droite provoque la perte des 8 bits les moins significatifs (les plus à droite). 65535 étant positif, les positions de bit libérées par le décalage (les 8 bits les plus à gauche) sont remplies avec des 0. Le résultat binaire est 00000000000000000000000011111111 (24 zéros, suivis de 8 uns), qui représente l'entier 255 de 32 bits.
    00000000000000001111111111111111 binaire (65535 décimal)
>>      8 décimal
--------------------
    00000000000000000000000011111111 binaire (255 décimal)
L'exemple suivant convertit -8 en entier de 32 bits et le décale de 1 bit vers la droite, ce qui donne la valeur décimale -4 :
var a:Number = -8 >> 1;
trace(a); // -4
En effet, l'équivalent binaire de -8 est 11111111111111111111111111111000 (29 uns, suivis de 3 zéros). Le décalage d'un bit vers la droite provoque la perte du bit le moins significatif (le plus à droite). -8 étant un entier négative, la position libérée par le décalage (le bit le plus à gauche) est remplie avec un 1. Le résultat binaire est 11111111111111111111111111111100 (30 uns, suivis par 2 zéros), qui représente l'entier -4 de 32 bits.
    11111111111111111111111111111000 binaire (-8 décimal)
>>                                1 décimal
--------------------
    11111111111111111111111111111100 binaire (-4 décimal)

Voir aussi

>>= bitwise right shift and assignment Opérateur  
Utilisation
expression >>= shiftCount

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Effectue un décalage au niveau du bit vers la droite et stocke le résultat dans expression.

Les deux instructions suivantes sont équivalentes :

A >>= B; 
A = (A >> B);

Opérandes
expression:Number — Nombre ou expression à décaler vers la droite.
shiftCount:Number — Nombre ou expression à convertir en entier compris entre 0 et 31.

Résultat
int — Résultat de l'opération au niveau du bit.

Exemple
Utilisation des exemples
Le code suivant utilise l'opérateur (>>=) de décalage droit au niveau du bit et d'affectation :
function convertToBinary(numberToConvert:Number):String { 
    var result:String = ""; 
    for (var i = 0; i < 32; i++) { 
        // Extract least significant bit using bitwise AND. 
        var lsb:Number = numberToConvert & 1; 
        // Add this bit to the result.
        result = (lsb ? "1" : "0")+result; 
        // Shift numberToConvert right by one bit, to see next bit. 
        numberToConvert >>= 1; 
    } 
    return result; 
} 
trace(convertToBinary(479)); 
// Returns the string 00000000000000000000000111011111. 
// This string is the binary representation of the decimal number 479.

Voir aussi

>>> bitwise unsigned right shift Opérateur  
Utilisation
expression >>> shiftCount

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Identique à l'opérateur de décalage vers la droite au niveau du bit (>>), à la différence qu'il ne conserve pas le signe de l'expression d'origine car les bits de gauche sont toujours remplacés par des 0.

Un nombre à virgule flottante est converti en entier en supprimant tous les chiffres après la virgule. Un entier positif est converti en valeur hexadécimale non signée avec une valeur maximale de 4294967295 ou 0xFFFFFFFF ; une valeur supérieure au maximum perd ses chiffres les plus significatifs lorsqu'elle est convertie, de sorte que la valeur soit toujours de 32 bits. Un nombre négatif est converti en valeur hexadécimale non signée à l'aide de la notation complément à deux, avec une valeur minimale de -2147483648 ou 0x800000000 ; tout nombre inférieur à cette valeur minimale est converti en complément à deux avec une plus grande précision avant de perdre ses chiffres les plus significatifs.

Le résultat est interprété comme un entier de 32 bits non signé, de sorte que le résultat soit un entier compris entre 0 et 4294967295.

Remarque : ActionScript ne possède pas d'opérateur de « décalage gauche au niveau du bit non signé » complémentaire, mais vous pouvez obtenir le même résultat en utilisant uint(expression << shiftCount).

Opérandes
expression:Number — Nombre ou expression à décaler vers la droite.
shiftCount:Number — Nombre ou expression à convertir en entier compris entre 0 et 31.

Résultat
uint — Résultat de l'opération au niveau du bit.

Exemple
Utilisation des exemples
L'exemple suivant convertit -1 en entier de 32 bits et le décale de 1 bit vers la droite :
var a:Number = -1 >>> 1; 
trace(a); // 2147483647 
Ceci est dû au fait que -1 en décimal équivaut à 11111111111111111111111111111111 en binaire (trente-deux 1), et que lorsque vous effectuez un décalage de 1 bit vers la droite (non signé), le bit le moins significatif (le plus à droite) est supprimé, et le bit le plus significatif (le plus à gauche) est remplacé par la valeur 0. Le résultat obtenu est 01111111111111111111111111111111 en binaire, soit l'entier 32 bits 2147483647.

Voir aussi

>>>= bitwise unsigned right shift and assignment Opérateur  
Utilisation
expression >>>= shiftCount

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Effectue un décalage droite au niveau du bit non signé et stocke le résultat dans expression. Les deux instructions suivantes sont équivalentes :

A >>>= B; 
A = (A >>> B); 

Opérandes
expression:Number — Nombre ou expression à décaler vers la droite.
shiftCount:Number — Nombre ou expression à convertir en entier compris entre 0 et 31.

Résultat
uint — Résultat de l'opération au niveau du bit.

Exemple
Utilisation des exemples
L'exemple suivant convertit -1 en entier de 32 bits et le décale de 1 bit vers la droite :
var a:Number = -1;
a >>>= 1; 
trace(a); // 2147483647 
Ceci est dû au fait que -1 en décimal équivaut à 11111111111111111111111111111111 en binaire (trente-deux 1), et que lorsque vous effectuez un décalage de 1 bit vers la droite (non signé), le bit le moins significatif (le plus à droite) est supprimé, et le bit le plus significatif (le plus à gauche) est remplacé par la valeur 0. Le résultat obtenu est 01111111111111111111111111111111 en binaire, soit l'entier 32 bits 2147483647.

Voir aussi

^ bitwise XOR Opérateur  
Utilisation
expression1 ^ expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Convertit expression1 et expression2 en entiers non signés de 32 bits et insère un 1 à chaque position de bit, où les bits correspondant de expression1 ou expression2, mais pas des deux, sont de 1.

Un nombre à virgule flottante est converti en entier en supprimant tous les chiffres après la virgule. Un entier positif est converti en valeur hexadécimale non signée avec une valeur maximale de 4294967295 ou 0xFFFFFFFF ; une valeur supérieure au maximum perd ses chiffres les plus significatifs lorsqu'elle est convertie, de sorte que la valeur soit toujours de 32 bits. Un nombre négatif est converti en valeur hexadécimale non signée à l'aide de la notation complément à deux, avec une valeur minimale de -2147483648 ou 0x800000000 ; tout nombre inférieur à cette valeur minimale est converti en complément à deux avec une plus grande précision avant de perdre ses chiffres les plus significatifs.

Le résultat est interprété en tant que nombre à complément à deux de 32 bits, de sorte que le résultat soit un entier compris entre -2147483648 et 2147483647.

Opérandes
expression1:Number — Nombre ou expression évalué sous forme de nombre.
expression2:Number — Nombre ou expression évalué sous forme de nombre.

Résultat
int — Résultat de l'opération au niveau du bit.

Exemple
Utilisation des exemples
L'exemple suivant applique l'opérateur XOR au niveau du bit aux décimales 15 et 9 et affecte le résultat à la variable a :
// 15 decimal = 1111 binary 
// 9 decimal = 1001 binary 
var a:Number = 15 ^ 9; 
trace(a); 
// 1111 ^ 1001 = 0110 
// returns 6 decimal (0110 binary) 

Voir aussi

^= bitwise XOR assignment Opérateur  
Utilisation
expression1 ^= expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Affecte à expression1 la valeur de expression1 ^ expression2. Par exemple, les deux instructions suivantes sont équivalentes :

x ^= y 
x = x ^ y 

Opérandes
expression1:Number — Nombre ou expression évalué sous forme de nombre.
expression2:Number — Nombre ou expression évalué sous forme de nombre.

Résultat
int — Résultat de l'opération au niveau du bit.

Exemple
Utilisation des exemples
L'exemple suivant illustre l'opération (^=) d'affectation XOR au niveau du bit :
// 15 decimal = 1111 binary 
var a:Number = 15; 
// 9 decimal = 1001 binary 
var b:Number = 9; 
trace(a ^= b); // returns 6 decimal (0110 binary) 

Voir aussi

/*..*/ block comment delimiter Opérateur  
Utilisation
/* comment */
/* comment
   comment */

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Délimite une ou plusieurs lignes de commentaires de script. Les caractères qui s'affichent entre le premier (/*) et le dernier séparateur (*/) sont interprétés comme des commentaires et sont ignorées par le compilateur d'ActionScript. Pour délimiter plusieurs lignes successives de commentaires, utilisez ces séparateurs ; pour une seule ligne, choisissez le délimiteur //.

Si vous omettez le séparateur de bloc de commentaires fermant (*/) ou si vous tentez d'imbriquez des commentaires, vous obtiendrez un message d'erreur. Lorsque vous utilisez un séparateur ouvrant (/*), le premier séparateur fermant (*/) suivant termine le commentaire, quel que soit le nombre de séparateurs ouvrant placés avant lui.

Opérandes
comment:* — Tout caractère.

Exemple
Utilisation des exemples
Le script suivant utilise des séparateurs de bloc de commentaires au début du script :
/* records the X and Y positions of 
the ball and bat movie clips */ 
var ballX:Number = ball_mc._x; 
var ballY:Number = ball_mc._y; 
var batX:Number = bat_mc._x; 
var batY:Number = bat_mc._y; 
Dans l'exemple suivant, la tentative d'imbrication de plusieurs commentaires provoque un message d'erreur :
/* This is an attempt to nest comments. 
/* But the first closing tag will be paired 
with the first opening tag */ 
and this text will not be interpreted as a comment */ 

Voir aussi

{ } braces (XML) Opérateur  
Utilisation
 myXML = <{tagName} {attributeName} = {attributeValue}>{content}</{tagName}>

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Evalue une expression utilisée dans un initialiseur XML ou XMLList. Un initialiseur XML ou XMLList est une valeur littérale affectée à une variable de type XML ou XMLList. Une expression qui est délimitée par les opérateurs XML { et } peut être utilisée dans un initialiseur XML ou XMLList au lieu de noms ou de valeurs littérales. Une expression peut être utilisée à la place de tagName, attributeName, attributeValue et content.

Opérandes
myXML:* — Objet XML ou XMLList.
tagName:* — Expression qui renvoie le nom d'une balise XML.
attributeName:* — Expression qui renvoie le nom d'un attribut XML.
attributeValue:* — Expression qui renvoie la valeur d'un attribut XML.
content:* — Expression qui renvoie le contenu d'une balise XML.

Exemple
Utilisation des exemples
L'exemple suivant montre comment employer les opérateurs { et } lors de la définition d'un littéral XML :
var tagname:String = "item"; 
var attributename:String = "id"; 
var attributevalue:String = "5"; 
var content:String = "Chicken"; 
var x:XML = <{tagname} {attributename}={attributevalue}>{content}</{tagname}>; 
trace(x.toXMLString()); // <item id="5">Chicken</item>

Voir aussi

[ ] brackets (XML) Opérateur  
Utilisation
 myXML[expression]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Accède à une propriété ou un attribut d'un objet XML ou XMLList. L'opérateur accolades vous permet d'accéder aux noms des propriétés inaccessibles avec l'opérateur point (.).

Opérandes
myXML:* — Objet XML ou XMLList.
expression:* — Expression qui renvoie le nom d'une balise ou d'un attribut XML.

Exemple
Utilisation des exemples
L'exemple suivant indique comment utiliser les opérateurs [ et ] pour accéder à une propriété XML qui n'est pas accessible avec l'opérateur point en raison du tiret qui figure dans le nom de la balise :
var myXML:XML = <a><foo-bar>44</foo-bar></a>;
trace(myXML["foo-bar"]);

Voir aussi

, comma Opérateur  
Utilisation
(expression1, expression2[, expressionN... ])

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Evalue expression1, puis expression2, et ainsi de suite. Cet opérateur est utilisé principalement avec l'instruction for loop et est généralement utilisé avec l'opérateur parenthèses ().

Opérandes
expression1:* — Expression à évaluer.
expression2:* — Expression à évaluer.
expressionN:* — Nombre quelconque d'expressions supplémentaires à évaluer.

Résultat
Object — Valeurs des expressions évaluées.

Exemple
Utilisation des exemples
L'exemple suivant utilise l'opérateur virgule (,) dans une boucle for :
for (i = 0, j = 0; i < 3 && j < 3; i++, j+=2) { 
    trace("i = " + i + ", j = " + j); 
} 
// output: 
// i = 0, j = 0 
// i = 1, j = 2
L'exemple suivant utilise l'opérateur virgule (,) sans l'opérateur parenthèses pour indiquer que l'opérateur virgule a une priorité inférieure à celle de l'opérateur d'affectation (=) :
var v:Number = 0; 
v = 4, 5, 6; 
trace(v); // 4 
L'exemple suivant utilise l'opérateur virgule (,) avec des parenthèses pour indiquer que l'opérateur virgule renvoie la valeur de la dernière expression :
var v:Number = 0; 
v = (4, 5, 6); 
trace(v); // 6 
L'exemple suivant utilise l'opérateur virgule (,) sans parenthèses pour indiquer que l'opérateur virgule provoque l'évaluation séquentielle de toutes les expressions. La première expression, v + 4, est affectée à la variable v, car l'opérateur d'affectation (=) est prioritaire par rapport à l'opérateur virgule. La deuxième expression, z++, est évaluée et zest incrémentée d'une unité.
var v:Number = 0; 
var z:Number = 0; 
v = v + 4 , z++, v + 6; 
trace(v); // 4 
trace(z); // 1 
L'exemple suivant est identique au précédent à la différence qu'il contient des parenthèses qui modifient l'ordre des opérations de sorte que l'opérateur virgule soit évalué avant l'opérateur d'affectation (=) :
var v:Number = 0; 
var z:Number = 0; 
v = (v + 4, z++, v + 6); 
trace(v); // 6 
trace(z); // 1 

Voir aussi

+ concatenation Opérateur  
Utilisation
expression1 + expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Concatène (combine) des chaînes. Si l'une des expressions est une chaîne, toutes les autres sont converties en chaînes et concaténées.

Si les deux expressions sont des nombres, cet opérateur ce comporte comme un opérateur d'addition.

Opérandes
expression1:String — Chaîne à concaténer.
expression2:String — Chaîne à concaténer.

Résultat
String — Chaîne concaténée.

Exemple
Utilisation des exemples
L'exemple suivant concatène deux chaînes.
var lastName:String = "Cola"; 
var instrument:String = "Drums"; 
trace(lastName + " plays " + instrument); // Cola plays Drums 
Cet exemple montre que, si une expression est une chaîne, toutes les autres sont converties en chaînes et concaténées :
trace("Number " + 8 + 0); // Number 80
L'exemple suivant montre que les sommes numériques à droite d'une expression de type String ne sont pas calculées car elles sont converties en chaînes :
var a:String = 3 + 10 + "asdf"; 
trace(a); // 13asdf 
var b:String = "asdf" + 3 + 10; 
trace(b); // asdf310 

Voir aussi

+ concatenation (XMLList) Opérateur  
Utilisation
expression1 + expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Concatène (combine) des valeurs XML ou XML dans un objet XMLList. Un objet XMLList est renvoyé uniquement si les deux opérandes sont des valeurs XML ou XMLList.

Opérandes
expression1:* — Valeur XML ou XMLList.
expression2:* — Valeur XML ou XMLList.

Résultat
XMLList — Chaîne XMLList concaténée.

Exemple
Utilisation des exemples
L'exemple suivant montre comment utiliser l'opérateur XMLList (+) (concaténation) :
var x1:XML = 
        <employee id = "42">
            <firstName>Joe</firstName>
            <lastName>Smith</lastName>
        </employee>;

var x2:XML = 
        <employee id = "43">
            <firstName>Susan</firstName>
            <lastName>Jones</lastName>
        </employee>;

var myXMLList:XMLList = x1 + x2;
    
trace(myXMLList.toXMLString()); 

L'instruction trace produit le résultat suivant :

<employee id = "42">
    <firstName>Joe</firstName>
    <lastName>Smith</lastName>
</employee>
<employee id = "43">
    <firstName>Susan</firstName>
    <lastName>Jones</lastName>
</employee>
    

Voir aussi

+= concatenation assignment Opérateur  
Utilisation
expression1 += expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Affecte à expression1 la valeur de expression1 + expression2. Par exemple, les deux instructions suivantes ont le même résultat :

x += y; 
x = x + y;
Toutes les règles de l'opérateur de concaténation (+) s'appliquent à l'opérateur d'affectation de la concaténation (+=). L'utilisation de l'affectation de concaténation pour la propriété text de TextField (telle que someTextField.text += moreText est beaucoup moins efficace que TextField.appendText(), en particulier avec un TextField qui contient un montant considérable de contenu.

Opérandes
expression1:String — Chaîne.
expression2:String — Chaîne.

Résultat
Number — Résultat de la concaténation.

Exemple
Utilisation des exemples
Cet exemple utilise l'opérateur += avec une expression de chaîne :
var x1:String = "My name is "; 
x1 += "Gilbert"; 
trace(x1); // My name is Gilbert 

Voir aussi

+= concatenation assignment (XMLList) Opérateur  
Utilisation
expression1 += expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Affecte à expression1, qui est un objet XMLList, la valeur de expression1 + expression2. Par exemple, les deux instructions suivantes ont le même résultat :

x += y; 
x = x + y; 
Toutes les règles de l'opérateur XMLList de concaténation (+) s'appliquent à l'opérateur XMLList d'affectation de concaténation (+=).

Opérandes
expression1:XMLList — Objet XMLList auquel vous ajoutez une nouvelle valeur.
expression2:* — Valeur XML ou XMLList.

Exemple
Utilisation des exemples
L'exemple suivant montre comment utiliser l'opérateur XMLList (+=) d'affectation de concaténation :
var x1:XML = <location>Athens</location>;    
var x2:XML = <location>Paris</location>;        
myXMLList = x1 + x2;

var x3:XML = <location>Springfield</location>;
myXMLList += x3;
            
trace(myXMLList.toXMLString());

L'instruction trace produit le résultat suivant :

<location>Athens</location>
    
<location>Paris</location>    

<location>Springfield</location>

Voir aussi

?: conditional Opérateur  
Utilisation
expression1 ? expression2 : expression3

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Evalue expression1, et si la valeur de expression1 est true, le résultat reprend la valeur de expression2. Sinon, le résultat reprend la valeur de expression3.

Opérandes
expression1:Boolean — Expression qui renvoie une valeur Boolean ; généralement une expression de comparaison, telle que x < 5.
expression2:* — Valeur de tout type.
expression3:* — Valeur de tout type.

Résultat
* — Valeur de expression2 ou expression3.

Exemple
Utilisation des exemples
L'instruction suivante affecte la valeur de la variable x à la variable z, car la première expression renvoie true :
var x:Number = 5; 
var y:Number = 10; 
var z = (x < 6) ? x: y; 
trace(z); // returns 5
L'exemple suivant illustre une instruction conditionnelle abrégée :
var timecode:String = (new Date().getHours() < 11) ? "AM" : "PM"; 
trace(timecode); 
Cette même instruction conditionnelle peut également être écrite de manière non abrégée, comme dans l'exemple suivant :
if (new Date().getHours() < 11) { 
    var timecode:String = "AM"; 
} else { 
    var timecode:String = "PM"; 
}
trace(timecode); 

Voir aussi

-- decrement Opérateur  
Utilisation
--expression
expression--

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Soustrait 1 de l'opérande. L'opérande peut être une variable, un élément de tableau ou une propriété d'objet. La forme avant décrémentation de l'opérateur (--expression) soustraie 1 de expression et renvoie le résultat. La forme après décrémentation de l'opérateur (expression--) soustraie 1 de expression et renvoie la valeur initiale de expression (la valeur précédant la soustraction).

Opérandes
expression:Number — Nombre ou variable évalué sous forme de nombre.

Résultat
Number — Résultat de la valeur décrémentée.

Exemple
Utilisation des exemples
La forme de pré-décrémentation de l'opérateur décrémente x jusqu'à 2 (x- 1 = 2) et renvoie le résultat sous forme y :
var x:Number = 3; 
var y:Number = --x; // y is equal to 2
La forme de post-décrémentation de l'opérateur décrémente x jusqu'à 2 (x- 1 = 2) et renvoie la valeur d'origine de x en tant que résultat y :
var x:Number = 3; 
var y:Number = x--; // y is equal to 3
L'exemple suivant boucle de 10 à 1 et chaque itération diminue la variable du compteur i de 1 :
for (var i = 10; i > 0; i--) { 
    trace(i); 
}

Voir aussi

delete Opérateur  
Utilisation
 supprimer la référence

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Détruit la propriété objet spécifiée par reference. Le résultat est true si la propriété n'existe pas à la fin de l'opération, et false dans tous les autres cas. L'opérateur delete renvoie true s'il est appelé sur une propriété non existante ou une propriété dynamique non définie dans une classe.

L'opérateur delete peut échouer et renvoyer false si le paramètre reference ne peut pas être supprimé. Vous ne pouvez pas supprimer les propriétés fixes ni les variables qui sont déclarées avec l'instruction var. Une propriété fixe est une variable ou une méthode déclarée dans une définition de classe.

L'opérateur delete ne peut pas servir à détruire une propriété de classe, à moins que celle-ci soit dynamique et ajoutée à l'exécution. Les propriétés des classes scellées ne peuvent pas être détruites par delete. Définissez plutôt la propriété sur null.

Remarque : vous ne pouvez pas supprimer un objet, mais vous pouvez le rendre éligible pour le nettoyage en retirant toutes les références à l'objet. La référence la plus répandue à un objet est une variable qui le désigne. Vous pouvez supprimer une telle référence en définissant la variable sur null. Le nettoyeur de mémoire supprime tout objet qui n'a pas de références.

Opérandes
reference:* — Nom de la propriété à éliminer.

Résultat
Boolean — La valeur true si la suppression a réussi et false en cas d'échec.

Exemple
Utilisation des exemples
L'exemple suivant supprime une propriété d'un objet :
// create the new object "account" 
var account:Object = new Object(); 
// assign property name to the account 
account.name = "Jon"; 
// delete the property 
delete account.name; 
trace(account.name); // undefined

// delete a nonexistent property
var fooDeleted:Boolean = delete account.foo;
trace(fooDeleted); // true

L'exemple suivant supprime la valeur d'un élément de tableau, mais la valeur de la propriété length n'est pas modifiée :

var my_array:Array = new Array(); 
my_array[0] = "abc"; // my_array.length == 1 
my_array[1] = "def"; // my_array.length == 2 
my_array[2] = "ghi"; // my_array.length == 3 
// my_array[2] is deleted, but Array.length is not changed 
delete my_array[2]; 
trace(my_array.length); // 3 
trace(my_array); // abc,def,

L'exemple suivant montre comment la valeur Boolean renvoyée par delete peut servir de condition pour une future exécution du code. Lorsqu'un élément a déjà été supprimé, tout nouvel appel de delete sur l'élément renvoie false.

var my_array:Array = [ "abc", "def", "ghi" ];
var deleteWasSuccessful:Boolean

deleteWasSuccessful = delete my_array[0];
if(deleteWasSuccessful) delete my_array[1];
deleteWasSuccessful = delete my_array[0];
if(deleteWasSuccessful) delete my_array[2];

trace(my_array) // outputs: undefined,undefined,ghi

Voir aussi

delete (XML) Opérateur  
Utilisation
 supprimer la référence

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Supprime les éléments ou les attributs XML spécifiés par reference.

Utilisé avec un opérande XMLList, le résultat de l'opérateur delete est toujours true car l'opérande XMLList fait systématiquement référence à un objet XMLList valide (bien qu'il puisse être vide).

Opérandes
reference:XMLList — Objet XMLList qui désigne les éléments ou attributs XML à supprimer.

Résultat
Boolean — Valeur de true si la suppression a réussi, false en cas d'échec.

Exemple
Utilisation des exemples
L'exemple suivant montre comment supprimer un attribut, puis un élément seul, puis plusieurs éléments :
 
var x1:XML = <x1>
                <a id = "52">AYY</a>
                <a>AYY 2 </a>
                <b>BEE</b>
                <c>CEE</c>
            </x1>;

trace(x1.toXMLString());
trace("___________");

delete x1.a.@id;

trace(x1.toXMLString());
trace("___________");

delete x1.b;

trace(x1.toXMLString());
trace("___________");

delete x1.a;

trace(x1.toXMLString());

Le résultat se présente comme suit :

<x1>
  <a id="52">AYY</a>
  <a>AYY 2</a>
  <b>BEE</b>
  <c>CEE</c>
</x1>
___________
<x1>
  <a>AYY</a>
  <a>AYY 2</a>
  <b>BEE</b>
  <c>CEE</c>
</x1>
___________
<x1>
  <a>AYY</a>
  <a>AYY 2</a>
  <c>CEE</c>
</x1>
___________
<x1>
  <c>CEE</c>
</x1>

L'exemple suivant montre comment supprimer tout le contenu d'un élément, y compris ses attributs et ses éléments enfant, sans supprimer l'élément lui-même :
 
var xml:XML = 
            <order>
                <item id="121">hamburger</item>
                <item id="122">fries</item>
                <item id="123">chocolate shake</item>
            </order>;
delete xml.item[1].*;
delete xml.item[1].@*;
trace(xml);

Le résultat se présente comme suit :

<order>
  <tem id="121">hamburger</item>
  <item/>
  <item id="123">chocolate shake</item>
</order>

.. descendant accessor Opérateur  
Utilisation
 myXML..childElement1..@attributeName 

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Navigue jusqu'aux éléments descendants d'un objet XML ou XMLList, ou (combiné avec l'opérateur @) détecte les attributs correspondants des descendants. Les éléments ou attributs correspondants ne doivent pas être des enfants directs de l'objet XML ou XMLList ; ils peuvent être à un niveau inférieur dans l'arborescence (par exemple des petits-enfants). Le résultat est un objet XMLList, car plusieurs éléments enfant ou attribut peuvent correspondre.

L'ordre des nœuds dans l'objet XMLList renvoyé est le résultat d'une première traversée approfondie. Considérons par exemple ce qui suit :

var myXML:XML = <a>
			<b>one
				<c> 
					<b>two</b> 
				</c> 
			</b>
			<b>three</b>
		</a>;

trace(myXML..b[0].toXMLString());
trace("______________");
trace(myXML..b[1].toXMLString());
trace("______________");
trace(myXML..b[2].toXMLString());

La sortie suivante donnerait ce résultat :

<b>
  one
  <c>
    <b>two</b>
  </c>
</b>
______________
<b>two</b>
______________
<b>three</b>

Pour renvoyer des descendants dont les noms correspondent à des mots réservés d'ActionScript, utilisez la méthode XML.descendants() au lieu de l'opérateur descendant (..), comme dans l'exemple suivant :

var xml:XML = 
<enrollees>
	<student id="239">
		<class name="Algebra" />
 		<class name="Spanish 2"/>
	</student>
	<student id="206">
		<class name="Trigonometry" />
 		<class name="Spanish 2" />
	</student>
 </enrollees>;
 trace(xml.descendants("class")); 
 

Opérandes
myXML:Object — Objet XML ou XMLList.
childElement1_or_attributeName — Nom d'une propriété XML ou nom d'un attribut.

Exemple
Utilisation des exemples
L'exemple suivant montre comment employer l'opérateur accesseur descendant (..) pour renvoyer les éléments enfant d'un objet XML et renvoyer un attribut d'un élément :
var myXML:XML = 
    <employees>
        <employee id = "42">
            <firstName>Billy</firstName>
            <lastName>Einstein</lastName>
        </employee>
        <employee id = "43">
            <firstName>Sally</firstName>
            <lastName>Shostakovich</lastName>
        </employee>
    </employees>
    
trace(myXML..firstName); 
    // <firstName>Billy</firstName>
    // <firstName>Sally</firstName>
                
trace(myXML..@id); //4243

Voir aussi

/ division Opérateur  
Utilisation
expression1 / expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Divise expression1 par expression2. Le résultat de l'opération de division est un nombre à virgule flottante comportant deux décimales.

Opérandes
expression:Number — Nombre ou variable évalué sous forme de nombre.

Résultat
Number — Résultat, en virgule flottante, de l'opération.

Exemple
Utilisation des exemples
L'exemple suivant montre que le résultat de la division par 0 change si le dividende est positif, négatif ou nul.
trace(3/0);   // Infinity
trace(-3/0);  // -Infinity
trace(0/0);   // NaN

Voir aussi

/= division assignment Opérateur  
Utilisation
expression1 /= expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Affecte à expression1 la valeur de expression1 / expression2. Par exemple, les deux instructions suivantes sont équivalentes :

x /= y; 
x = x / y;

Opérandes
expression1:Number — Nombre ou variable évalué sous forme de nombre.
expression2:Number — Nombre ou variable évalué sous forme de nombre.

Résultat
Number — Nombre.

Exemple
Utilisation des exemples
Le code suivant montre l'utilisation de l'opérateur d'affectation de division (/=) avec des variables et des nombres :
var a:Number = 10; 
var b:Number = 2; 
a /= b; trace(a); // 5 

Voir aussi

. dot Opérateur  
Utilisation
object.property_or_method

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Accède aux méthodes et aux variables de la classe, récupère et définit les propriétés de l'objet et délimite les packages ou les classes importé(e)s.

Opérandes
object:Object — Occurrence de classe. Cet objet peut être une occurrence de l'une des classes ActionScript intégrées ou d'une classe que vous définissez. Cet opérande figure toujours à gauche de l'opérateur point (.).
property_or_method:* — Nom d'une propriété ou d'une méthode associée à un objet. Toutes les méthodes et les propriétés valides pour les classes intégrées figurent dans les tableaux récapitulatifs des méthodes et des propriétés pour cette classe. Cet opérande figure toujours à droite de l'opérateur point (.).

Résultat
* — Variable, méthode ou propriété nommée à droite du point.

Exemple
Utilisation des exemples
L'exemple suivant utilise l'opérateur point comme séparateur lors de l'importation de la classe Timer.
import flash.utils.Timer;
L'exemple suivant crée un objet générique et utilise l'opérateur point pour ajouter une nouvelle propriété.
var obj:Object = new Object();
obj.propertyA = "hello";
trace(obj.propertyA);  // hello

Voir aussi

. dot (XML) Opérateur  
Utilisation
myXML.childElement
myXML.@attributeName 

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Navigue jusqu'aux éléments enfant d'un objet XML ou XMLList ou (combiné avec l'opérateur @) renvoie les attributs d'un objet XML ou XMLList. L'objet renvoyé est un objet XMLList car plusieurs éléments enfant ou attribut peuvent correspondre.

Pour renvoyer les éléments dont les noms correspondent Mots réservés d'ActionScript, utilisez la méthode XML.elements() ou XML.descendants() à la place du point XML (.) opérateur , comme indiqué dans l'exemple suivant :

var xml:XML = 
	<student id="206">
		<class name="Trigonometry" />
		<class name="Spanish 2" />
	</student>;
trace(xml.elements("class"));
trace(xml.descendants("class")); 

Opérandes
myXML:Object — Objet XML ou XMLList.
childElement:* — Nom d'une propriété XML.
attributeName:* — Nom d'un attribut.

Résultat
XMLList — Objet XMLList spécifié.

Exemple
Utilisation des exemples
L'exemple suivant montre comment employer l'opérateur point (.) pour revenir à un élément enfant d'un XML et renvoyer un attribut d'un élément :
var myXML:XML = 
    <employee id = "42">
        <firstName>Billy</firstName>
        <lastName>Einstein</lastName>
    </employee>;

trace(myXML.firstName); // Billy
trace(myXML.@id);       // 42

Voir aussi

== equality Opérateur  
Utilisation
expression1 == expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Vérifie si deux expressions sont égales. Le résultat est true lorsque les expressions sont égales.

Si les types de données des deux opérandes correspondent, la définition d'égalité dépend du type de données des opérandes :

Si les types de données des opérandes ne correspondent pas, le résultat est false, sauf dans les cas suivants :

Opérandes
expression1:Object — Nombre, chaîne, valeur Boolean, variable, objet, tableau ou expression.
expression2:Object — Nombre, chaîne, valeur Boolean, variable, objet, tableau ou expression.

Résultat
Boolean — Une valeur de true si les expressions sont égales et false dans tous les autres cas.

Exemple
Utilisation des exemples
L'exemple suivant a recours à l'opérateur d'égalité (==) avec une instruction if :
var a:String = "David"
var b:String = "David"; 
if (a == b) { 
    trace("David is David"); 
} 
Les exemples suivants montrent comment l'opérateur d'égalité effectue une conversion de type automatique lors de la comparaison par valeur. Les valeurs de chaîne sont converties en nombres :
var a:Number = 5; 
var b:String = "5"; 
trace(a == b); // true
Les valeurs Boolean sont converties en nombres, true étant converti en 1 et false en 0 :
var c:Number = 1; 
var d:Boolean = true; 
trace(c == d); // true
var e:Number = 0; 
var f:Boolean = false; 
trace(e == f); // true
Toutefois, les valeurs de chaîne n'étant pas converties en valeurs Boolean, le code suivant renvoie false:
var g:String = "true";
var h:Boolean = true;
trace(g == h); // false
Les exemples suivants affichent la comparaison par référence. Le premier exemple compare deux tableaux dont la longueur et les éléments sont identiques. L'opérateur d'égalité renvoie la valeur false pour ces deux tableaux. Les tableaux semblent égaux, cependant la comparaison par référence implique que firstArray et secondArray fassent référence au même tableau. Le deuxième exemple crée la variable thirdArray, qui pointe vers le même tableau que firstArray. L'opérateur d'égalité renvoie la valeur true pour ces deux tableaux, car les deux variables font référence au même tableau.
var firstArray:Array = new Array("one", "two", "three"); 
var secondArray:Array = new Array("one", "two", "three"); 
trace(firstArray == secondArray); // false 
/* Arrays are only considered equal 
if the variables refer to the same array. */
var thirdArray:Array = firstArray; 
trace(firstArray == thirdArray); // true 

Voir aussi

> greater than Opérateur  
Utilisation
expression1 > expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Compare deux expressions et détermine si expression1 est supérieur à expression2. Dans l'affirmative, le résultat est true. Si expression1 est supérieur ou égal à expression2, le résultat est false.

Si les deux opérandes sont de type String, ils sont comparés en ordre alphabétique ; toutes les majuscules ont priorité sur les minuscules. Sinon, les opérandes sont tout d'abord convertis en nombres, puis comparés.

Opérandes
expression1:Object — Chaîne, entier ou nombre à virgule flottante.
expression2:Object — Chaîne, entier ou nombre à virgule flottante.

Résultat
Boolean — Une valeur de true si expression1 est supérieur à expression2. false dans tous les autres cas.

Exemple
Utilisation des exemples
L'exemple suivant montre que les chaînes sont comparées en ordre alphabétique, les majuscules étant prioritaires sur les minuscules :
var a:String = "first";
var b:String = "First";
trace(a > b); // true
L'exemple suivant indique comment les valeurs String et Boolean sont converties en nombres :
var c:Number = 5;
var d:String = "4";
trace(c > d); // true

var e: Number = 2;
var f:Boolean = true;
trace(e > f); // true

>= greater than or equal to Opérateur  
Utilisation
expression1 >= expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Compare deux expressions et détermines si expression1 est supérieur ou égal à expression2 (true), ou si expression1 est inférieur à expression2 (false).

Opérandes
expression1:Object — Chaîne, entier ou nombre à virgule flottante.
expression2:Object — Chaîne, entier ou nombre à virgule flottante.

Résultat
Boolean — Une valeur de true si expression1 est inférieur ou égal à expression2. false dans tous les autres cas.

Exemple
Utilisation des exemples
Dans l'exemple suivant, l'opérateur supérieur ou égal à (>=) est utilisé pour déterminer si l'heure est supérieure ou égale à 12 :
if (new Date().getHours() >= 12) { 
    trace("good afternoon"); 
} else { 
    trace("good morning"); 
}

Voir aussi

in Opérateur  
Utilisation
expression1 in expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Evalue si une propriété fait partie d'un objet spécifique. Pour utiliser l'opérateur in, spécifiez un nom de propriété comme premier opérande et un objet comme second opérande. Si l'objet que vous spécifiez contient une telle propriété, le résultat est true. false dans tous les autres cas.

Si l'objet spécifié est un objet Array, vous pouvez utiliser l'opérateur in pour vérifier si un numéro d'index particulier est valide. Si vous transmettez un entier comme premier opérande, le résultat est true si l'index est compris dans la plage des numéros d'index valides, et false dans les autres cas.

Résultat
Boolean — Une valeur de true si expression1 est une propriété de l'objet représenté par expression2 et falsedans les autres cas.

Exemple
Utilisation des exemples
L'exemple suivant utilise l'opérateur in pour indiquer que PI est une propriété de l'objet Math, tandis que myProperty n'en est pas une.
trace("PI" in Math);         // true
trace("myProperty" in Math); // false

L'exemple suivant a recours à l'opérateur in pour indiquer que les nombres 0, 1 et 2 sont des numéros d'index valides dans l'objet myArray, contrairement au nombre 3.

public var myArray:Array = ["zero", "one", "two"];
trace(0 in myArray); // true
trace(1 in myArray); // true
trace(2 in myArray); // true
trace(3 in myArray); // false

Voir aussi

++ increment Opérateur  
Utilisation
++expression
 expression++

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Ajoute 1 à une expression. L'expression peut être une variable, un élément de tableau ou une propriété objet. La forme pré-incrément de l'opérateur (++expression) ajoute 1 à expression et renvoie le résultat. La forme post-incrément de l'opérateur (expression++) ajoute 1 à expression et renvoie la valeur initiale de expression (avant l'addition).

Opérandes
expression:Number — Nombre ou variable évalué sous forme de nombre.

Résultat
Number — Résultat de l'incrémentation.

Exemple
Utilisation des exemples
L'exemple suivant utilise ++ en tant qu'opérateur de pré-incrémentation dans une boucle while pour montrer que la valeur ajoutée au tableau est celle qui a été incrémentée :
var preInc:Array = new Array(); 
var i:int = 0; 
while (i < 10) { 
    preInc.push(++i); 
} 
trace(preInc); // 1,2,3,4,5,6,7,8,9,10 
L'exemple suivant utilise ++ en tant qu'opérateur de post-incrémentation dans une boucle while pour montrer que la valeur ajoutée au tableau est la valeur initiale :
 
var postInc:Array = new Array(); 
var i:int = 0; 
while (i < 10) { 
   postInc.push(i++); 
} 
trace(postInc); // 0,1,2,3,4,5,6,7,8,9 
L'exemple suivant utilise ++ en tant qu'opérateur de post-incrémentation pour qu'une boucle while s'exécute à cinq reprises :
var i:int = 0; 
while (i++ < 5) { 
    trace("this is execution " + i); 
} 
/* output: 
   this is execution 1 
   this is execution 2 
   this is execution 3 
   this is execution 4 
   this is execution 5 
*/

Voir aussi

!= inequality Opérateur  
Utilisation
expression1 != expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Recherche l'inverse de l'opérateur d'égalité (==). Si expression1 est égal à expression2, le résultat est false. Comme pour l'opérateur d'égalité (==), la définition de l'égalité dépend des types de données comparés.

Si les types de données des deux opérandes correspondent, la définition d'égalité dépend du type de données des opérandes :

Si les types de données des opérandes ne correspondent pas, l'opérateur d'inégalité (!=) renvoie true, sauf dans les cas suivants :

Opérandes
expression1:Object — Nombre, chaîne, valeur Boolean, variable, objet, tableau ou fonction.
expression2:Object — Nombre, chaîne, valeur Boolean, variable, objet, tableau ou fonction.

Résultat
Boolean — Une valeur de true si l'expressions n'est pas égale et false dans tous les autres cas.

Exemple
Utilisation des exemples
L'exemple suivant affiche le résultat de l'opérateur d'inégalité (!=) :
trace(5 != 8); // true 
trace(5 != 5); // false 
L'exemple suivant illustre l'utilisation de l'opérateur d'inégalité (!=) dans une instruction if :
var a:String = "David";
var b:String = "Fool";
if (a != b) { 
    trace("David is not a fool"); 
}
L'exemple suivant illustre la comparaison par référence avec deux fonctions :
var a:Function = function() { trace("foo"); }; 
var b:Function = function() { trace("foo"); }; 
a(); // foo 
b(); // foo 
trace(a != b); // true 
a = b; 
a(); // foo 
b(); // foo 
trace(a != b); // false
L'exemple suivant illustre la comparaison par référence avec deux tableaux :
var a:Array = [ 1, 2, 3 ]; 
var b:Array = [ 1, 2, 3 ]; 
trace(a);      // 1,2,3 
trace(b);      // 1,2,3 
trace(a != b); // true 
a = b; 
trace(a);      // 1,2,3 
trace(b);      // 1,2,3 
trace(a != b); // false

Voir aussi

instanceof Opérateur  
Utilisation
expression instanceof function

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Evalue si la chaîne de prototype d'une expression comprend l'objet prototype de function. L'opérateur instanceof permet la compatibilité ascendante avec ECMAScript édition 3, et peut s'avérer pratique pour les programmeurs expérimentés qui choisissent d'utiliser l'héritage par prototype avec des fonctions constructeur à la place des classes.

Pour vérifier si l'objet appartient à un type de données spécifique, employez l'opérateur is.

Lors d'une utilisation conjointe avec des classes, l'opérateur instanceof est similaire à l'opérateur is dans la mesure où la chaîne de prototype d'une classe inclut toutes ses superclasses. Les interfaces, cependant, ne sont pas incluses dans les chaînes de prototype, de sorte que l'opérateur instanceof renvoie toujours false lorsqu'il est utilisé avec des interfaces, tandis que l'opérateur is renvoie true si un objet appartient à une classe qui implémente l'interface spécifiée.

Remarque : l'opérateur ActionScript is est l'équivalent de l'opérateur Java instanceof.

Opérandes
expression:Object — Objet qui contient la chaîne de prototype à évaluer.
function:Object — Objet fonction (ou classe).

Résultat
Boolean — Renvoie true si la chaîne de prototype de expression inclut l'objet prototype de function et falsedans tous les autres cas.

Exemple
Utilisation des exemples
L'exemple suivant crée une occurrence de la classe Sprite appelée mySprite et utilise l'opérateur instanceof pour tester si la chaîne de prototype de mySprite comprend les objets prototype des classes Sprite et DisplayObject. Le résultat est true avec la classe Sprite et la classe DisplayObject car les objets prototype de Sprite et DisplayObject font partie de la chaîne de prototype de mySprite.
var mySprite:Sprite = new Sprite();
trace(mySprite instanceof Sprite);        // true
trace(mySprite instanceof DisplayObject); // true
L'exemple suivant utilise l'interface IbitmapDrawable pour montrer que l'opérateur instanceof ne fonctionne pas avec des interfaces. L'opérateur is renvoie true car la classe DisplayObject, qui est une super-classe de la classe Sprite, implémente l'interface IBitmapDrawable.
var mySprite:Sprite = new Sprite();
trace(mySprite instanceof IBitmapDrawable); // false
trace(mySprite is IBitmapDrawable);         // true

Voir aussi

is Opérateur  
Utilisation
expression1 is expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Evalue si un objet est compatible avec un certain type de données ou une certaine classe ou interface. Utilisez l'opérateur is de préférence à l'opérateur instanceof pour les comparaisons de type. Vous pouvez également utiliser l'opérateur is pour vérifier si un objet implémente une interface.

Résultat
Boolean — Une valeur de true si expression1 est compatible avec le type de données, la classe ou l'interface spécifiée dans expression2, et false dans tous les autres cas.

Exemple
Utilisation des exemples
L'exemple suivant crée une occurrence de la classe Sprite appelée mySprite et utilise l'opérateur is pour tester si mySprite est une occurrence des classes Sprite et DisplayObject et si elle implémente l'interface IEventDispatcher.
import flash.display.*;
import flash.events.IEventDispatcher;

var mySprite:Sprite = new Sprite();
trace(mySprite is Sprite);           // true
trace(mySprite is DisplayObject);    // true
trace(mySprite is IEventDispatcher); // true

Voir aussi

< less than Opérateur  
Utilisation
expression1 < expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Compare deux expressions et détermine si expression1 est inférieur à expression2. Dans l'affirmative, le résultat est true. Si expression1 est supérieur ou égal à expression2, le résultat est false.

Si les deux opérandes sont de type String, ils sont comparés en ordre alphabétique ; toutes les majuscules ont priorité sur les minuscules. Sinon, les opérandes sont tout d'abord convertis en nombres, puis comparés.

Opérandes
expression1:Object — Chaîne, entier ou nombre à virgule flottante.
expression2:Object — Chaîne, entier ou nombre à virgule flottante.

Résultat
Boolean — Une valeur de true si expression1 est inférieur à expression2. false dans tous les autres cas.

Exemple
Utilisation des exemples
Les exemples suivants affichent les résultats true et false pour les comparaisons numériques et de chaîne :
trace(5 < 10); // true 
trace(2 < 2);            // false 
trace(10 < 3);           // false 
trace("Allen" < "Jack"); // true 
trace("Jack" < "Allen"); // false 
trace("11" < "3");       // true 
trace("11" < 3);         // false (numeric comparison) 
trace("C" < "abc");      // true 
trace("A" < "a");        // true 

<= less than or equal to Opérateur  
Utilisation
expression1 <= expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Compare deux expressions et détermine si expression1 est inférieur ou égal à expression2. Dans l'affirmative, le résultat est true. Si expression1 est supérieur à expression2, le résultat est false.

Si les deux opérandes sont de type String, ils sont comparés en ordre alphabétique ; toutes les majuscules ont priorité sur les minuscules. Sinon, les opérandes sont tout d'abord convertis en nombres, puis comparés.

Opérandes
expression1:Object — Chaîne, entier ou nombre à virgule flottante.
expression2:Object — Chaîne, entier ou nombre à virgule flottante.

Résultat
Boolean — Une valeur de true si expression1 est inférieur à expression2. false dans tous les autres cas.

Exemple
Utilisation des exemples
Les exemples suivants affichent les résultats true et false pour les comparaisons numériques et de chaîne :
trace(5 <= 10); // true 
trace(2 <= 2);            // true 
trace(10 <= 3);           // false 
trace("Allen" <= "Jack"); // true 
trace("Jack" <= "Allen"); // false 
trace("11" <= "3");       // true 
trace("11" <= 3);         // false (numeric comparison) 
trace("C" <= "abc");      // true 
trace("A" <= "a");        // true 

// line comment delimiter Opérateur  
Utilisation
// comment

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Signale le début d'un commentaire de script. Les caractères qui apparaissent entre le séparateur de commentaires (//) et le caractère de fin de ligne sont interprétés en tant que commentaires et ignorés. Utilisez ce séparateur pour les commentaires d'une ligne. Pour les commentaires sur plusieurs lignes, utilisez les séparateurs /* et */.

Opérandes
comment:* — Tout caractère.

Exemple
Utilisation des exemples
L'exemple suivant présente une seule ligne de commentaire :
// Any text following a line comment delimiter is ignored during compilation

Voir aussi

&& logical AND Opérateur  
Utilisation
expression1 && expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Renvoie expression1 s'il a la valeur false ou peut être converti en false, expression2 dans tous les autres cas. Parmi les valeurs qui peuvent être converties en false, figurent 0, NaN, null et undefined. Si vous utilisez un appel de fonction tel que expression2, la fonction n'est pas appelée si expression1 renvoie false.

Si les deux opérandes sont de type Boolean, le résultat est true uniquement si les deux opérandes sont true, comme dans le tableau suivant :

Expression Valeur renvoyée
true && true true
true && false false
false && false false
false && true false

Opérandes
expression1:* — Valeur ou expression de tout type.
expression2:* — Valeur de l'expression de tout type.

Résultat
* — Valeur Boolean si les deux opérandes sont de type Boolean. Dans le cas contraire, le résultat est la valeur de l'une des expressions.

Exemple
Utilisation des exemples
L'exemple suivant utilise l'opérateur ET logique (&&) pour effectuer un test permettant de déterminer si un joueur a gagné la partie. Les variables turns et score sont mises à jour lorsqu'un joueur prend son tour ou marque des points pendant le jeu. Le script génère le message "Vous avez gagné !" lorsque le score du joueur atteint ou dépasse la valeur 75 en trois tours ou moins.
var turns:Number = 2; 
var score:Number = 77; 
if ((turns <= 3) && (score >= 75)) { 
    trace("You Win the Game!"); 
} else { 
    trace("Try Again!"); 
} 

Voir aussi

&&= logical AND assignment Opérateur  
Utilisation
expression1 &&= expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Affecte à expression1 la valeur de expression1 && expression2. Par exemple, les deux instructions suivantes sont équivalentes :

x &&= y; 
x = x && y; 

Opérandes
expression1:* — Valeur de tout type.
expression2:* — Valeur de tout type.

Résultat
* — Valeur Boolean si les deux opérandes sont membres du type de données Boolean. Dans le cas contraire, le résultat sera la valeur de l'une des deux expressions.

Exemple
Utilisation des exemples
L'exemple suivant modifie une variable appelée myTag si cette variable ne renvoie pas false. Cette technique profite du fait que l'opérateur ET (&&) renvoie expression1 si expression1 renvoie false, elle renvoie la valeur expression2 dans tous les autres cas. Si myTag dispose déjà d'une valeur qui renvoie true, myVar est modifié pour ressembler à une balise XML. Cependant, si myVar contient une valeur qui renvoie false, telle que les valeurs null, "" (chaîne vide) et undefined entre autres, myVar reste inchangé.
var myVar:String = 'tag';
myVar &&= "<" + myVar + "/>";
trace (myVar); // output: <tag/>
Le même effet peut être obtenu avec une instruction if, comme indiqué dans l'exemple suivant :
var myVar:String = 'tag';
if (myVar != '') {
  myVar = "<" + myVar + "/>";
}
trace (myVar); // output: <tag/>
L'avantage de l'utilisation de l'instruction if est que le code est plus lisible, tandis que l'opérateur ET d'affectation logique (&&=) est à préférer si vous ne pouvez pas spécifier la valeur par défaut exacte d'un type de données.

Voir aussi

! logical NOT Opérateur  
Utilisation
!expression

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Inverse la valeur Boolean d'une variable ou d'une expression. Si expression est une variable avec la valeur true absolue ou convertie, la valeur de !expression est false. Si l'expression x && y renvoie false, l'expression !(x && y) renvoie true.

Les expressions suivantes illustrent le résultat de l'utilisation de l'opérateur logique NON (!) :

Opérandes
expression:Boolean — Expression ou variable qui renvoie une valeur Boolean.

Résultat
Boolean — Résultat Boolean de l'opération logique.

Exemple
Utilisation des exemples
Dans l'exemple suivant, la variable happy est définie sur false. La condition if évalue la condition !happy, et si la condition est true, l'instruction trace() renvoie une chaîne.
var happy:Boolean = false; 
if (!happy) { 
    trace("don't worry, be happy"); // don't worry, be happy 
} 
L'instruction trace s'exécute car !false égale true.

Voir aussi

|| logical OR Opérateur  
Utilisation
expression1 || expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Renvoie expression1 s'il a la valeur true ou peut être converti en true, expression2 dans tous les autres cas. Si vous utilisez un appel de fonction tel que expression2, la fonction n'est pas appelée si expression1 renvoie true.

Si les deux opérandes sont de type Boolean, le résultat est true si l'une des expressions ou les deux sont true. Le résultat est false uniquement si les deux expressions sont false, comme l'indique le tableau suivant :

Expression Valeur renvoyée
true || true true
true || false true
false || false false
false || true true

Opérandes
expression1:* — Valeur de tout type.
expression2:* — Valeur de tout type.

Résultat
* — Valeur Boolean si les deux opérandes sont membres du type de données Boolean. Dans le cas contraire, le résultat sera la valeur de l'une des deux expressions.

Exemple
Utilisation des exemples
L'exemple suivant exploite l'opérateur OU logique (||) dans une instruction if. La deuxième expression renvoie true, ce qui donne un résultat final de true :
var a:Number = 10; 
var b:Number = 250; 
var start:Boolean = false; 
if ((a > 25) || (b > 200) || (start)) { 
    trace("the logical OR test passed"); // the logical OR test passed 
} 
Le message « test OU logique réussi » s'affiche car l'une des conditions de l'instruction ifest true (b > 200).

L'exemple suivant illustre la façon dont des résultats inattendus peuvent être obtenus si vous utilisez un appel de fonction en deuxième opérande. Si l'expression à gauche de l'opérateur renvoie true, ce résultat est renvoyé sans évaluer l'expression de droite (la fonction fx2() n'est pas appelée).

function fx1():Boolean { 
    trace("fx1 called"); 
    return true; 
} 
function fx2():Boolean { 
    trace("fx2 called"); 
    return true; 
} 
if (fx1() || fx2()) { 
    trace("IF statement entered");
}

Voir aussi

||= logical OR assignment Opérateur  
Utilisation
expression1 ||= expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Affecte à expression1 la valeur de expression1 || expression2. Par exemple, les deux instructions suivantes sont équivalentes :

x ||= y; 
x = x || y; 

Opérandes
expression1:* — Valeur de tout type.
expression2:* — Valeur de tout type.

Résultat
* — Valeur Boolean si les deux opérandes sont membres du type de données Boolean. Dans le cas contraire, le résultat sera la valeur de l'une des deux expressions.

Exemple
Utilisation des exemples
L'exemple suivant affecte une valeur par défaut à une variable déclarée auparavant et appelée myVar. Cette technique profite du fait que l'opérateur OU logique (||) renvoie expression1 si expression1 renvoie true, elle renvoie la valeur expression2 dans tous les autres cas. Si myVar contient déjà une valeur qui renvoie true, myVar reste inchangé. Cependant, si myVar contient une valeur qui renvoie false, telle que les valeurs null, "" (chaîne vide) et undefined entre autres, myVar reçoit la valeur "default".
myVar ||= "default";

Voir aussi

% modulo Opérateur  
Utilisation
expression1 % expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Calcule le reste de expression1 divisé par expression2. Si l'un des opérandes n'est pas numérique, l'opérateur modulo (%) tente de le convertir en nombre.

Le signe du résultat de l'opération modulo correspond au signe du dividende (le premier nombre). Par exemple, -4 % 3 et -4 % -3 renvoient tous deux -1.

Opérandes
expression1:Number — Nombre ou expression évaluée sous forme de nombre. Une chaîne qui ne contient que des caractères numériques est évaluée en nombre.
expression2:Number — Nombre ou expression évaluée sous forme de nombre. Une chaîne qui ne contient que des caractères numériques est évaluée en nombre.

Résultat
Number — Résultat de l'opération arithmétique.

Exemple
Utilisation des exemples
L'exemple numérique suivant utilise l'opérateur modulo (%) :
trace(12 % 5);    // 2 
trace(4.3 % 2.1); // 0.0999999999999996 
trace(4 % 4);     // 0 
La première instruction trace renvoie 2, plutôt que 12/5 ou 2,4 car l'opérateur modulo (%) renvoie uniquement le reste. La deuxième instruction trace renvoie 0,0999999999999996 au lieu de la valeur 0,1 attendue en raison des limites d'exactitude des nombres à virgule flottante en calcul binaire.

Voir aussi

%= modulo assignment Opérateur  
Utilisation
expression1 %= expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Affecte à expression1 la valeur de expression1 % expression2. Les deux instructions suivantes sont équivalentes :

x %= y; 
x = x % y; 

Opérandes
expression1:Number — Nombre ou expression évalué sous forme de nombre.
expression2:Number — Nombre ou expression évalué sous forme de nombre.

Résultat
Number — Résultat de l'opération arithmétique.

Exemple
Utilisation des exemples
L'exemple suivant affecte la valeur 4 à la variable a :
var a:Number = 14; 
var b:Number = 5; 
a %= b;
trace(a); // 4 

Voir aussi

* multiplication Opérateur  
Utilisation
expression1 * expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Multiplie deux expressions numériques. Lorsque les deux expressions sont des entiers, le produit est un entier. Lorsque l'une ou les deux expressions sont des nombres à virgule flottante, le produit est un nombre à virgule flottante.

Opérandes
expression1:Number — Nombre ou expression évalué sous forme de nombre.
expression2:Number — Nombre ou expression évalué sous forme de nombre.

Résultat
Number — Entier ou nombre à virgule flottante.

Exemple
Utilisation des exemples
L'instruction suivante multiplie les entiers 2 et 3 pour produire l'entier 6 :
trace(2*3); // 6 
Cette instruction multiplie les nombres à virgule flottante 2,0 et 3,1416 pour produire 6,2832, nombre à virgule flottante :
trace(2.0 * 3.1416); // 6.2832 

Voir aussi

*= multiplication assignment Opérateur  
Utilisation
expression1 *= expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Affecte à expression1 la valeur de expression1 * expression2. Par exemple, les deux expressions suivantes sont équivalentes :

x *= y 
x = x * y 

Opérandes
expression1:Number — Nombre ou expression évalué sous forme de nombre.
expression2:Number — Nombre ou expression évalué sous forme de nombre.

Résultat
Number — Valeur de expression1 * expression2 . Si une expression ne peut pas être convertie en valeur numérique, elle renvoie NaN (non numérique).

Exemple
Utilisation des exemples
L'exemple suivant affecte la valeur 50 à la variable a :
var a:Number = 5; 
var b:Number = 10; 
trace(a *= b); // 50 
La deuxième et la troisième ligne de l'exemple suivant calculent les expressions situées sur le côté droit du signe égal et en affecte les résultats à c et d :
var i:Number = 5; 
var c:Number = 4 - 6; 
var d:Number = i + 2; 
trace(c *= d); // -14 

Voir aussi

:: name qualifier Opérateur  
Utilisation
namespace::property
namespace::method()
namespace::xmlObject.property
namespace::xmlObject.@attribut

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Permet d'identifier l'espace de noms d'une propriété, d'une méthode, d'une propriété ou d'un attribut XML.

Opérandes
namespace:Object — Espace de nom d'identification.
propertyName:Object — Propriété, méthode, propriété XML ou attribut XML à identifier.

Exemple
Utilisation des exemples
L'exemple suivant utilise l'opérateur :: pour identifier les deux méthodes qui ont le même nom dans deux espaces de noms différents :
public class NamespaceExample extends Sprite {
    public namespace French;
    public namespace Hawaiian;
    public function NamespaceExample() {
        trace(Hawaiian::hello()); // aloha
        trace(French::hello()); // bonjour
    }
    Hawaiian function hello():String {
        return "aloha";
    }

    French function hello():String { 
        return "bonjour";
    }
}
L'exemple suivant utilise l'opérateur :: pour identifier les propriétés XML dont les espaces de noms sont spécifiés :
var soap:Namespace = new Namespace("http://schemas.xmlsoap.org/wsdl/soap/");
var w:Namespace = new Namespace("http://weather.example.org/forecast");
var myXML:XML = 
    <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"> 
     <soap:Body>
      <w:forecast xmlns:w="http://weather.example.org/forecast">
       <w:city>Quito</w:city>
       <w:country>Ecuador</w:country>
       <date>2006-01-14</date>
      </w:forecast>
      </soap:Body>
    </soap:Envelope>;
    
trace(myXML.soap::Body.w::forecast.w::city); // Quito

Voir aussi

new Opérateur  
Utilisation
new constructor(parameters)

Versions du moteur d'exécution: Flash Player 5

Instancie une occurrence de classe. L'opérateur new peut être utilisé avec une classe ou une variable de type classe pour créer une occurrence de classe. L'opérateur new est souvent utilisé avec un objet de classe pour créer une occurrence de classe. Par exemple, l'instruction new Sprite() crée une occurrence de la classe Sprite.

L'opérateur new peut également être utilisé pour associer une classe à un actif intégré, c'est-à-dire un objet externe comme une image, un son ou une police, compilé dans un fichier SWF. Chaque ressource intégrée est représentée par une classe de ressources intégrées unique. Pour accéder à une ressource intégrée, vous devez utiliser l'opérateur new pour créer une occurrence de la classe associée. Ensuite, vous pouvez appeler les propriétés et méthodes appropriées de la classe de la ressource intégrée pour manipuler celle-ci.

Si vous préférez définir des classes avec des objets Function à la place du mot-clé class, utilisez l'opérateur new pour créer des objets basés sur des fonctions constructeur. Ne confondez pas les fonctions constructeur avec les méthodes constructeur d'une classe. Une fonction constructeur est un objet Function défini avec le mot-clé function, mais qui ne fait pas partie de la définition d'une classe. Si vous utilisez des fonctions constructeur pour créer des objets, vous devez choisir l'héritage par prototype au lieu de l'héritage de classe.

Opérandes
constructor:* — Classe, fonction ou variable contenant une valeur de type Class.
parameters:* — Un ou plusieurs paramètres, séparés par des virgules.

Exemple
Utilisation des exemples
L'exemple suivant crée la classe Book et utilise l'opérateur new pour créer les objets book1 et book2.
class Book {
  var bName:String;
  var bPrice:Number;
  
  public function Book(nameParam:String, priceParam:Number){
    bName = nameParam;
    bPrice = priceParam;
  }
}

var book1:Book = new Book("Confederacy of Dunces", 19.95);
var book2:Book = new Book("The Floating Opera", 10.95);
trace(book1); // [object Book]
L'exemple suivant utilise l'opérateur new pour créer un objet Array avec 18 éléments :
var golfCourse:Array = new Array(18);

Voir aussi

{} object initializer Opérateur  
Utilisation
object = {nom1 : valeur1, nom2 : valeur2,... nomN : valeurN}

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Crée un objet et l'initialise avec les paires de propriétés name et value spécifiées. L'utilisation de cet opérateur a le même effet que la syntaxe new Object et le renseignement des paires de propriétés avec l'opérateur d'affectation. Le prototype du nouvel objet est génériquement appelé Object.

Cet opérateur est également utilisé pour marquer des blocs de code contigu associés avec des instructions de contrôle du flux (for, while, if, else, switch) et des fonctions.

Opérandes
object:Object — Objet à créer.
name1,2,...N:Object — Noms des propriétés.
value1,2,...N:Object — Valeurs correspondantes pour chaque propriété name.

Résultat
Object — Un objet Object.

Exemple
Utilisation des exemples
La première ligne du code suivant crée un objet vide à l'aide de l'opérateur ({}) initialiseur d'objet ; la deuxième ligne crée un nouvel objet à l'aide d'une fonction constructeur :
var object:Object = {}; 
var object:Object = new Object(); 
L'exemple suivant crée un objet account et initialise les propriétés name, address, city, state, zip et balance avec les valeurs d'accompagnement :
var account:Object = {name:"Adobe Systems, Inc.", address:"601 Townsend Street", city:"San Francisco", state:"California", zip:"94103", balance:"1000"}; 
for (i in account) { 
    trace("account."+i+" = "+account[i]); 
} 
L'exemple suivant indique comment imbriquer un tableau et des initialiseurs d'objet :
var person:Object = {name:"Gina Vechio", children:["Ruby", "Chickie", "Puppa"]}; 
L'exemple de code suivant utilise les informations de l'exemple précédent et produit le même résultat à l'aide d'une fonction constructeur :
var person:Object = new Object(); 
person.name = "Gina Vechio"; 
person.children = new Array(); 
person.children[0] = "Ruby"; 
person.children[1] = "Chickie"; 
person.children[2] = "Puppa"; 

Voir aussi

() parentheses Opérateur  
Utilisation
(expression1[, expression2])
(expression1, expression2)
function ( parameter1,..., parameterN) 

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Regroupe un ou plusieurs paramètres, évalue les expressions de façon séquentielle ou entoure un ou plusieurs paramètres et les transmet en tant qu'arguments à une fonction placée avant les parenthèses.

Utilisation 1 : Contrôle l'ordre d'exécution des opérateurs. Les parenthèses remplacent la séquence normale et entraînent l'évaluation des expressions entre parenthèses en premier. Lorsque des parenthèses sont imbriquées, le contenu de celles de plus bas niveau est évalué en premier.

Utilisation 2 : Evalue une série d'expressions, séparées par des virgules, dans l'ordre et renvoie le résultat de l'expression finale.

Utilisation 3 : Entoure un ou plusieurs paramètres et les transmet à la fonction qui précède les parenthèses.

Opérandes
expression1:Object — Expression pouvant inclure des nombres, des chaînes, des variables ou du texte.
expression2:Object — Expression pouvant inclure des nombres, des chaînes, des variables ou du texte.
function:Function — Fonction à appliquer au contenu des parenthèses.
parameter1...parameterN:Object — Série de paramètres à exécuter avant de transmettre les résultats sous forme d'arguments à la fonction située hors des parenthèses.

Exemple
Utilisation des exemples
Utilisation 1 : Les instructions suivantes présente l'utilisation des parenthèses pour contrôler l'ordre d'exécution des expressions :
trace((2 + 3) * (4 + 5)); // 45 
trace(2 + (3 * (4 + 5))); // 29
trace(2 + (3 * 4) + 5);   // 19
trace(2 + (3 * 4) + 5);   // 19
Utilisation 2 : L'exemple suivant évalue la fonction foo(), puis bar() et renvoie les résultats de l'expression a + b :
var a:Number = 1; 
var b:Number = 2; 
function foo() { 
  a += b; 
} 
function bar() { 
  b *= 10; 
} 
trace((foo(), bar(), a + b)); // 23 
Utilisation 3 : L'exemple suivant illustre l'utilisation des parenthèses avec des fonctions :
var today:Date = new Date(); 
trace(today.getFullYear()); // outputs current year 
function traceParameter(param):void { 
  trace(param); 
} 
traceParameter(2 * 2); // 4 

Voir aussi

( ) parentheses (XML) Opérateur  
Utilisation
myXML.(expression)

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Evalue une expression dans du code ECMAScript pour une construction XML (E4X). Par exemple, myXML.(lastName == "Smith") identifie les éléments XML appelés lastName et la valeur "Smith". Le résultat est un objet XMLList.

Opérandes
myXML:* — Objet XML ou XMLList.
expression:* — Expression définissant les éléments correspondants.

Résultat
XMLList — Objet XMLList désigné par les parenthèses.

Exemple
Utilisation des exemples
L'exemple suivant montre comment utiliser des parenthèses pour identifier des éléments et des attributs :
var myXML:XML = 
    <employees>
        <employee id = "42">
            <firstName>Joe</firstName>
            <lastName>Smith</lastName>
        </employee>
        <employee id = "43">
            <firstName>Susan</firstName>
            <lastName>Jones</lastName>
        </employee>
        <employee id = "44">
            <firstName>Anne</firstName>
            <lastName>Smith</lastName>
        </employee>
    </employees>;
    
trace(myXML.employee.(lastName == "Smith").@id.toXMLString()); 
    // 42
    // 44
                
trace(myXML.employee.(Number(@id) > 42).@id.toXMLString()); 
    // 43
    // 44

Voir aussi

/ RegExp delimiter Opérateur  
Utilisation
/modèle/indicateurs

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Lorsqu'ils entourent des caractères, indiquent que ceux-ci ont une valeur littérale et doivent être traités en tant qu'expression régulière (RegExp) et non pas en tant que variable, chaîne ou tout autre élément ActionScript. Cependant, sachez que deux caractères de barre oblique (//) indiquent le début d'un commentaire.

Opérandes
pattern:String — Séquence d'un ou plusieurs caractères, définissant le modèle de l'expression régulière.
flags:String — Une séquence de zéro ou plusieurs des caractères suivants : g(pour l'indicateur global), i (pour l'indicateur ignoreCase), s (pour l'indicateur dotall), x (pour l'indicateur extended).

Exemple
Utilisation des exemples
L'exemple suivant utilise des barres obliques (/) pour définir la valeur d'une variable de type RegExp (l'indicateur i est défini pour ignorer le respect de la casse en cas de correspondance) :
var myRegExp:RegExp = /foo-\d+/i; 
trace(myRegExp.exec("ABC Foo-32 def.")); // Foo-32 

Voir aussi

=== strict equality Opérateur  
Utilisation
expression1 === expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Teste l'égalité de deux expressions, mais sans conversion automatique des données. Le résultat est true lorsque les deux expressions sont égales, types de données inclus.

L'opérateur d'égalité stricte (===) est identique à l'opérateur d'égalité (==) de trois façons :

L'opérateur d'égalité stricte (===) ne diffère de l'opérateur d'égalité (==) que par deux aspects : L'opérateur d'égalité stricte génère des résultats différents dans ActionScript 3.0 que dans ActionScript 2.0 dans deux cas qui impliquent les valeurs primitives (par exemple, var x:Number = 1) avec des objets primitifs (par exemple, var x:Number = new Number(1)). En effet, ActionScript 3.0 supprime la distinction entre valeurs primitives et objets enveloppe primitifs.

Tout d'abord, les comparaisons entre les valeurs et les objets primitifs qui contiennent la même valeur renvoient true dans ActionScript 3.0, mais false dans les versions précédentes. Dans les versions précédentes, le type de données d'une valeur primitive est Boolean, Number, or String, vu que le type de données d'un objet primitif est toujours Object et non Boolean, Number ou String. Cette différence a des conséquences : le code suivant donne false dans les précédentes versions d'ActionScript car les types de données des opérandes ne correspondent pas, mais il donne true dans ActionScript 3.0 car le type des valeurs primitives est Boolean, Number, int, uint ou String, quelles soient enveloppées dans un objet ou non.

var num1:Number = 1;
var num2:Number = new Number(1);
trace(num1 === num2); // true in ActionScript 3.0, false in ActionScript 2.0
			
Ensuite, les comparaisons entre deux objets primitifs qui contiennent la même valeur renvoient true dans ActionScript 3.0, mais false dans les versions précédentes.
var num1:Number = new Number(1);
var num2:Number = new Number(1);
trace(num1 == num2);  // true in ActionScript 3.0, false in ActionScript 2.0
trace(num1 === num2); // true in ActionScript 3.0, false in ActionScript 2.0
Ceci est dû au fait que dans les versions précédentes d'ActionScript, les deux variables appartiennent au même type de données Object. Elles sont donc comparées par référence et le résultat est false pour les deux opérations d'égalité et d'égalité stricte. Cependant, dans ActionScript 3.0, les deux variables appartiennent au même type de données Number. Elles sont donc comparées par valeur et le résultat est true pour les deux opérations d'égalité et d'égalité stricte.

Opérandes
expression1:Object — Nombre, chaîne, valeur Boolean, variable, objet, tableau ou fonction.
expression2:Object — Nombre, chaîne, valeur Boolean, variable, objet, tableau ou fonction.

Résultat
Boolean — Résultat Boolean de la comparaison.

Exemple
Utilisation des exemples
L'exemple suivant démontre que l'égalité stricte (===) est identique à l'égalité (==) lorsque les valeurs et les types de données concordent :
var string1:String = "5"; 
var string2:String = "5"; 
trace(string1 == string2);  // true 
trace(string1 === string2); // true
L'exemple suivant montre que l'opérateur d'égalité stricte ne convertit pas le type de données String en Number, mais l'opérateur d'égalité (==) le fait :
// The equality (==) operator converts 5 to "5", but the strict equality operator does not
var string1:String = "5"; 
var num:Number = 5; 
trace(string1 == num);  // true 
trace(string1 === num); // false 
L'exemple suivant montre que l'opérateur d'égalité stricte ne convertit pas les valeurs Boolean en nombres, mais l'opérateur d'égalité le fait :
var num:Number = 1;
var bool:Boolean = true;
trace(num == bool);  // true 
trace(num === bool); // false
L'exemple suivant montre que l'opérateur d'égalité stricte convertit les types de données int et uint :
var num1:Number = 1;
var num2:int = 1;
var num3:uint = 1;
trace(num1 === num2); // true
trace(num1 === num3); // true
L'exemple suivant démontre que l'opérateur d'égalité stricte considère null et undefined comme différents, alors que l'opérateur d'égalité les traite comme étant égaux :
trace(null == undefined);  // true 
trace(null === undefined); // false 

Voir aussi

!== strict inequality Opérateur  
Utilisation
expression1 !== expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Recherche l'inverse exact de l'opérateur d'égalité stricte (===). L'opérateur d'inégalité stricte fonctionne de la même façon que l'opérateur d'inégalité, à la différence que seuls les types de données int et uint sont convertis.

Si expression1 est égal à expression2, et leurs types de données sont égaux, le résultat est false.

L'opérateur d'inégalité stricte (!==) est identique à l'opérateur d'inégalité (!=) de trois façons :

L'opérateur d'inégalité stricte ne diffère de l'opérateur d'inégalité (!=) que par deux aspects :

Opérandes
expression1:Object — Nombre, chaîne, valeur Boolean, variable, objet, tableau ou fonction.
expression2:Object — Nombre, chaîne, valeur Boolean, variable, objet, tableau ou fonction.

Résultat
Boolean — Résultat Boolean de la comparaison.

Exemple
Utilisation des exemples
Les commentaires du code suivant présentent la valeur renvoyée des opérations qui utilisent les opérateurs d'égalité (==), d'égalité stricte (===) et d'inégalité stricte (!==) :
var s1:String = "5"; 
var s2:String = "5"; 
var s3:String = "Hello"; 
var n:Number = 5; 
var b:Boolean = true; 
trace(s1 == s2);  // true 
trace(s1 == s3);  // false 
trace(s1 == n);   // true 
trace(s1 == b);   // false 
trace(s1 === s2); // true 
trace(s1 === s3); // false 
trace(s1 === n);  // false 
trace(s1 === b);  // false 
trace(s1 !== s2); // false 
trace(s1 !== s3); // true 
trace(s1 !== n);  // true 
trace(s1 !== b);  // true 

Voir aussi

" string delimiter Opérateur  
Utilisation
 "text" 

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Lorsqu'ils entourent des caractères, indiquent que ces caractères ont une valeur littérale et sont considérés comme une chaîne, et non pas en tant que variable, valeur numérique ou tout autre élément ActionScript.

Opérandes
text:String — Séquence de zéros ou de plusieurs caractères.

Exemple
Utilisation des exemples
L'exemple suivant a recours à des guillemets (") pour indiquer que la variable yourGuess est la chaîne littérale "Prince Edward Island" et non pas le nom d'une variable.
var yourGuess:String = "Prince Edward Island"; 
submit_btn.onRelease = function() { trace(yourGuess); }; 
// Prince Edward Island

Voir aussi

- subtraction Opérateur  
Utilisation
-expression
 expression1 - expression2

Versions du moteur d'exécution: Flash Player 9

Utilisé pour la négation ou la soustraction.

Utilisation 1 : Pour la négation, l'opérateur inverse le signe d'une expression numérique.

Utilisation 2 : Pour la soustraction, l'opérateur effectue une soustraction arithmétique sur les deux expressions numériques, en soustrayant expression2 de expression1. Lorsque les deux expressions sont des entiers, la différence est un entier. Lorsque l'une ou les deux expressions sont des nombres à virgule flottante, la différence est un nombre à virgule flottante.

Opérandes
expression1:Number — Nombre ou expression évalué sous forme de nombre.
expression2:Number — Nombre ou expression évalué sous forme de nombre.

Résultat
Number — Entier ou nombre à virgule flottante.

Exemple
Utilisation des exemples
Utilisation 1 : L'instruction suivante inverse le signe de l'expression 2 + 3 :
trace(-(2 + 3)); // -5 
Utilisation 2 : L'instruction suivante soustrait l'entier 2 de l'entier 5 :
trace(5 - 2); // 3 
Le résultat est 3 qui correspond à un entier.

L'instruction suivante soustrait le nombre à virgule flottante 1,5 du nombre à virgule flottante 3,25 :

trace(3.25 - 1.5); // 1.75 
Le résultat, 1,75, correspond à un nombre à virgule flottante.

Voir aussi

-= subtraction assignment Opérateur  
Utilisation
expression1 -= expression2

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Affecte à expression1 la valeur de expression1 - expression2. Par exemple, les deux instructions suivantes sont équivalentes :

x -= y ;
x = x - y;

Les expressions de type String doivent être converties en nombres. Sinon, le résultat est NaN (non numérique).

Opérandes
expression1:Number — Nombre ou expression évalué sous forme de nombre.
expression2:Number — Nombre ou expression évalué sous forme de nombre.

Résultat
Number — Résultat de l'opération arithmétique.

Exemple
Utilisation des exemples
L'exemple suivant a recours à l'opérateur d'affectation de soustraction (-=) pour soustraire 10 de 5 et en affecter le résultat dans la variable x :
var x:Number = 5; 
var y:Number = 10; 
x -= y; 
trace(x); // -5 
L'exemple suivant indique comment convertir des chaînes en nombres :
var x:String = "5"; 
var y:String = "10"; 
x -= y; 
trace(x); // -5 

Voir aussi

: type Opérateur  
Utilisation
[modifiers] var variableName:type
function functionName():type { ... }
function functionName(parameter1:type, ..., parameterN:type) [:type]{ ... } 

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Utilisé pour affecter un type aux données ; cet opérateur spécifie le type de variable, le type de renvoi de la fonction ou le type de paramètre de la fonction. Lorsqu'il est utilisé dans une déclaration une affectation de variable, cet opérateur spécifie le type de variable. Lorsqu'il fait partie d'une déclaration ou d'une définition de fonction, cet opérateur spécifie le type de renvoi de la fonction. Lorsqu'il est utilisé avec un paramètre de fonction dans une définition de fonction, cet opérateur spécifie le type de variable attendu pour ce paramètre.

La vérification du type se produit toujours à l'exécution. Toutefois, lorsque le compilateur est réglé sur le mode strict, tous les types sont également vérifiés à la compilation et des erreurs sont générées en cas d'incompatibilités. Les incompatibilités peuvent se produire pendant les opérations d'affectation, les appels de fonction et les ruptures de référence des membres de classe avec l'opérateur (.).

Les types utilisables incluent tous les types d'objet natifs, les classes et les interfaces que vous avez définis, ainsi que void. Les types natifs reconnus sont Boolean, Number, int, uint et String. Toutes les classes intégrées sont également prises en charge en tant que types natifs.

Si vous n'affectez aucun type aux données, la variable, valeur renvoyée par la fonction ou paramètre de fonction, est considérée comme étant sans type, ce qui signifie qu'elle peut être de tout type. Si vous souhaitez indiquer clairement votre intention d'utiliser une valeur sans type, utilisez le caractère (*) astérisque comme annotation de type. Utilisé comme annotation de type, le caractère astérisque revient à laisser une variable, valeur renvoyée par la fonction ou paramètre de fonction, sans type.

Opérandes
variableName:* — Identificateur pour une variable.
type:* — - Type de données natif, nom de classe que vous avez défini ou nom d'interface.
functionName:Function — - Identificateur pour une fonction.
parameter:* — - Identificateur pour un paramètre de fonction.

Exemple
Utilisation des exemples
Utilisation 1 : L'exemple suivant déclare une variable publique intitulée userName de type String et lui affecte une chaîne vide :
var userName:String = ""; 
Utilisation 2 : L'exemple suivant indique comment spécifier le type de renvoi d'une fonction en définissant une fonction intitulée randomInt() qui spécifie son type de renvoi comme int :
function randomInt(integer:int):int { 
    return Math.round(Math.random()*integer); 
} 
trace(randomInt(8)); 
Utilisation 3 : L'exemple suivant définit une fonction intitulée squareRoot() qui prend un paramètre intitulé val de type Number et renvoie la racine carrée de val, également de type Number :
function squareRoot(val:Number):Number { 
    return Math.sqrt(val); 
} 
trace(squareRoot(121)); 

Voir aussi

typeof Opérateur  
Utilisation
typeof expression

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Evalue expression et renvoie une chaîne spécifiant son type de données. Le résultat est limité à six valeurs de chaînes possibles : booleanfunctionnumberobjectstringxml. Si vous appliquez cet opérateur à une occurrence de classe définie par l'utilisateur, le résultat est la chaîne object. L'opérateur typeof permet la compatibilité ascendante. Utilisez l'opérateur is pour vérifier la compatibilité des types de données.

Opérandes
expression:Object — Objet à évaluer.

Résultat
String — Représentation de chaîne du type de expression. Le tableau suivant affiche les résultats de l'opérateur typeof pour chaque type d'expression.

Type d'expression Résultat
Array object
Boolean boolean
Function function
int number
Number number
Object object
String string
uint number
XML xml
XMLList xml

Exemple
Utilisation des exemples
L'exemple suivant montre le résultat de l'utilisation de typeof sur différents objets et valeurs.
trace(typeof Array); // object
trace(typeof Date);  // object
trace(typeof 3);     // number
L'exemple suivant montre que, dans ActionScript 3.0, le type de données d'un objet primitif est identique, que vous lui affectiez une valeur littérale ou que vous utilisiez l'opérateur new pour créer l'objet. Ceci diffère des versions précédentes d'ActionScript où l'opérateur typeof renvoyait objectpour la variable b :
var a:String = "sample";
var b:String = new String("sample");
trace(typeof a); // string
trace(typeof b); // string 

Voir aussi

void Opérateur  
Utilisation
void expression

Versions du moteur d'exécution: Flash Player 9

Evalue une expression, puis supprime sa valeur en renvoyant undefined. L'opérateur void est souvent employé dans les comparaisons qui utilisent l'opérateur ==pour tester les valeurs non définies.

Opérandes
expression:Object — Expression à évaluer.

Résultat
* — Valeur de undefined.

Voir aussi

< > XML literal tag delimiter Opérateur  
Utilisation
 myXML= <{tagName} {attributeName} = {attributeValue}>{content}</{tagName}>

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: Flash Player 9

Définit une balise XML dans un littéral XML. Utilisez la barre oblique / pour définir la balise fermante.

Opérandes
myXML:* — Objet XML ou XMLList.
tagName:* — Expression qui renvoie le nom d'une balise XML.
attributeName:* — Expression qui renvoie le nom d'un attribut XML.
attributeValue:* — Expression qui renvoie la valeur d'un attribut XML.
content:* — Expression qui renvoie le contenu d'une balise XML.

Exemple
Utilisation des exemples
L'exemple suivant montre comment employer les opérateurs < et > lors de la définition d'un littéral XML :
var x:XML = <item id= "324">cola</item>; 

Voir aussi