join (méthode Array.join)

public join([delimiter:String]) : String

Convertit les éléments d'un tableau en chaînes, insère le séparateur spécifié entre les éléments, les concatène, puis renvoie la chaîne obtenue. Un tableau imbriqué est toujours séparé par une virgule (,), et non pas par le séparateur transmis à la méthode join().

Disponibilité : ActionScript 1.0 ; Flash Lite 2.0

Paramètres

delimiter:String [facultatif] - Un caractère ou une chaîne séparant les éléments du tableau dans la chaîne renvoyée. Si vous omettez ce paramètre, une virgule (,) est utilisée en tant que séparateur par défaut.

Valeur renvoyée

String - Chaîne.

Exemple

L'exemple suivant crée un tableau incluant trois éléments : Earth, Moon et Sun. Il relie ensuite le tableau trois fois, d'abord à l'aide du séparateur par défaut (une virgule [,] et un espace), puis à l'aide d'un tiret (-) et enfin d'un signe plus (+).

var a_array:Array = new Array("Earth","Moon","Sun")
trace(a_array.join()); 
// Affiche Earth,Moon,Sun.
trace(a_array.join(" - ")); 
// Affiche Earth - Moon - Sun.
trace(a_array.join(" + ")); 
// Affiche Earth + Moon + Sun.

L'exemple suivant crée un tableau incorporé qui contient deux tableaux. Le premier tableau inclut trois éléments : Europa, Io et Callisto. Le deuxième tableau inclut deux éléments : Titan et Rhea. Il relie le tableau à l'aide d'un signe plus (+) mais les éléments de chaque tableau incorporé restent séparés par des virgules (,).

var a_nested_array:Array = new Array(["Europa", "Io", "Callisto"], ["Titan", "Rhea"]);
trace(a_nested_array.join(" + "));
// Renvoie Europa,Io,Callisto + Titan,Rhea.

Voir aussi

split (méthode String.split)