public substr(start:Number, length:Number) : String

Renvoie les caractères dans une chaîne à partir de l’index spécifié dans le paramètre start par le nombre de caractères spécifié dans le paramètre length. La méthode substr ne modifie pas la chaîne spécifiée par my_str; elle renvoie une nouvelle chaîne.

Disponibilité : ActionScript 1.0 ; Flash Player 5

start:Number - Entier qui indique la position du premier caractère à utiliser pour créer la sous-chaîne à partir de my_str. Si start correspond à un nombre négatif, la position de départ est déterminée à partir de la fin de la chaîne, -1 représentant le dernier caractère.

length:Number - Nombre de caractères de la sous-chaîne en cours de création. Si le paramètre length n’est pas spécifié, la sous-chaîne contient tous les caractères, du début à la fin de la chaîne.

String - Sous-chaîne de la chaîne spécifiée.

L’exemple suivant crée une nouvelle chaîne, my_str et utilise substr() pour renvoyer le deuxième mot de cette chaîne ; tout d’abord avec un paramètre start positif, puis un paramètre start négatif :

var my_str:String = new String("Hello world");
var mySubstring:String = new String();
mySubstring = my_str.substr(6,5);
trace(mySubstring); // output: world
 
mySubstring = my_str.substr(-5,5);
trace(mySubstring); // output: world

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

• Windows : lecteur d’amorçage\Program Files\Macromedia\Flash 8\Samples and Tutorials\Samples\ActionScript
• Macintosh : disque dur Macintosh/Applications/Macromedia Flash 8/Samples and Tutorials/Samples/ActionScript