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 Lite 2.0

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

// Valeurs d'index du littéral de chaîne
// Index positif : 0 1 2 3 4
// Chaîne : L o r e m
// Index négatif : -5 -4 -3 -2 -1

var my_str:String = "Lorem";

// Application de la fonction slice sur le premier caractère
trace("slice(0,1): "+my_str.slice(0, 1)); // Renvoie : slice(0,1): L
trace("slice(-5,1): "+my_str.slice(-5, 1)); // Renvoie : slice(-5,1): L

// Application de la fonction slice sur les trois caractères du milieu
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

// Découpes renvoyant des chaînes vides parce que le début est situé à //droite de la fin de la chaîne
trace("slice(1,1): "+my_str.slice(1, 1)); // slice(1,1):
trace("slice(3,2): "+my_str.slice(3, 2)); // slice(3,2):
trace("slice(-2,2): "+my_str.slice(-2, 2)); // slice(-2,2):

// Les découpes omettant le paramètre end utilisent String.length, qui est //égal à 5
trace("slice(0): "+my_str.slice(0)); // slice(0): Lorem
trace("slice(3): "+my_str.slice(3)); // slice(3): em

Vous trouverez également un exemple dans le fichier Strings.fla du dossier HelpExamples. La liste suivante présente les chemins type vers ce dossier :

Voir aussi

substr (méthode String.substr), substring (méthode String.substring)