Guide de reference du langage ActionScript 2.0 - PowWeb

slice (méthode String.slice)
public slice(start:Number, end:Number) : String
Renvoie une chaîne qui contient le caractère start et tous les autres caractères jusqu'au
caractère end, ce dernier n'étant pas inclus. L'objet String d'origine n'est pas modifié. Si le
paramètre end n'est pas spécifié, la fin de la sous-chaîne correspond à la fin de la chaîne. Si le
caractère indexé par start est identique au caractère indexé par end ou s'il trouve à droite de
ce caractère, la méthode renvoie une chaîne vide.
Disponibilité : ActionScript 1.0 ; Flash Player 5
Paramètres
start:Number - Index basé sur zéro du point de départ de la découpe. Si start correspond à
un nombre négatif, le point de départ est déterminé à partir de la fin de la chaîne, -1
représentant le dernier caractère.
end:Number - Entier correspondant à 1+ l'index du point de terminaison de la découpe. Le
caractère indexé par le paramètre end n'est pas inclus dans la chaîne extraite. Si ce paramètre
est omis, String.length est utilisé. Si end correspond à un nombre négatif, le point de
terminaison est calculé à partir de la fin de la chaîne, -1 représentant le dernier caractère.
Valeur renvoyée
String - Sous-chaîne de la chaîne spécifiée.
Exemple
L'exemple suivant crée une variable, my_str, lui affecte une valeur de type chaîne, puis
appelle la méthode slice() avec différentes valeurs pour les paramètres start et end. Tout
appel à slice() figure dans une instruction trace() qui affiche son résultat dans le panneau
de sortie.
// Index values for the string literal
// positive index: 0 1 2 3 4
// string: L o r e m
// negative index: -5 -4 -3 -2 -1
var my_str:String = "Lorem";
// slice the first character
trace("slice(0,1): "+my_str.slice(0, 1)); // output: slice(0,1): L
trace("slice(-5,1): "+my_str.slice(-5, 1)); // output: slice(-5,1): L
// slice the middle three characters
trace("slice(1,4): "+my_str.slice(1, 4)); // slice(1,4): ore
trace("slice(1,-1): "+my_str.slice(1, -1)); // slice(1,-1): ore
1174 Chapitre 2: Classes ActionScript