substring, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Retourne la sous-chaîne située à la position spécifiée au sein d'un objet String.

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

Arguments

start
Obligatoire. Entier d'index de base zéro indiquant le début de la sous-chaîne désirée.
end
Obligatoire. Entier d'index de base zéro indiquant la fin de la sous-chaîne désirée.

Notes

La méthode substring retourne une chaîne contenant la sous-chaîne entre la position start et la position end (exclu).

Cette méthode utilise la plus petite valeur entre start et end comme position de début de la sous-chaîne. Par exemple, strvar.substring(0, 3) et strvar.substring(3, 0) retournent la même sous-chaîne.

Si la valeur start ou end est égale à NaN ou est négative, elle est remplacée par zéro.

La longueur de la sous-chaîne est égale à la valeur absolue de la différence entre les valeurs start et end. Par exemple, la longueur de la sous-chaîne retournée dans strvar.substring(0, 3) et strvar.substring(3, 0) est trois (3) dans les deux cas.

Exemple

L'exemple suivant illustre l'utilisation de la méthode substring.

function SubstringDemo(){
   var ss;                         //Declare variables.
   var s = "The rain in Spain falls mainly in the plain..";
   ss = s.substring(12, 17);   //Get substring.
   return(ss);                     //Return substring.
}