substring (méthode String.substring)

public substring(start:Number, end:Number) : String

Renvoie une chaîne comprenant les caractères entre les points spécifiés par les paramètres start et end. 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 la valeur de start est égale à la valeur end, la méthode renvoie une chaîne vide. Si la valeur de start est supérieure à la valeur end, es paramètres sont automatiquement permutés avant que la fonction s'exécute et la valeur d'origine n'est pas modifiée.

Disponibilité : ActionScript 1.0 ; Flash Lite 2.0

Paramètres

start:Number - Entier qui indique la position du premier caractère à utiliser pour créer la sous-chaîne à partir de my_str. Les valeurs valides pour start vont de 0 à String.length - 1. Si start a une valeur négative, 0 est utilisé.

end:Number - Entier qui correspond à 1+ l'index du dernier caractère à extraire dans my_str. Les valeurs valides pour end vont de 1 à String.length. 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 ce paramètre correspond à une valeur négative, 0 est utilisé.

Valeur renvoyée

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

Exemple

L'exemple suivant indique comment utiliser substring():

var my_str:String = "Hello world";
var mySubstring:String = my_str.substring(6,11);
trace(mySubstring); // Renvoie : world

L'exemple suivant indique ce qui se produit lorsqu'un paramètre start négatif est utilisé :

var my_str:String = "Hello world";
var mySubstring:String = my_str.substring(-5,5);
trace(mySubstring); // Renvoie : Hello

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


 

M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire

Page en cours: http://livedocs.adobe.com/flashlite/2_fr/main/chapter2444.html