String  - AS3

Entier indiquant le nombre de caractères dans l’objet String spécifié.

Tous les index de chaîne étant de base zéro, l’index du dernier caractère pour une chaîne x est x.length - 1.

Plus d’exemples

Crée un objet String initialisé sur la chaîne spécifiée.

Remarque : les littéraux de chaîne utilisant moins de temps système que les objets String et étant généralement plus faciles à utiliser, il est recommandé de faire appel à eux plutôt qu’à la classe String, sauf si vous avez une bonne raison d’utiliser un objet String plutôt qu’un littéral de chaîne.

Plus d’exemples

Renvoie le caractère correspondant à la position spécifiée par le paramètre index. Si index n’est pas un nombre compris entre 0 et string.length - 1, une chaîne vide est renvoyée.

Cette méthode est similaire à String.charCodeAt(), sauf que la valeur renvoyée est un caractère, plutôt qu’un code de caractère entier 16 bits.

Paramètres

Plus d’exemples

Eléments de l’API associés

Renvoie le code numérique du caractère Unicode correspondant à l’index spécifié. Si index n’est pas un nombre compris entre 0 et string.length - 1, NaN est renvoyé.

Cette méthode est similaire à String.charAt(), sauf que la valeur renvoyée est un code de caractère entier 16 bits, pas le caractère en tant que tel.

Paramètres

Plus d’exemples

Eléments de l’API associés

Ajoute les arguments fournis à la fin de l’objet String en les convertissant en chaînes si besoin est, et renvoie la chaîne obtenue. La valeur d’origine de l’objet String source n’est pas modifiée.

Paramètres

Plus d’exemples

Renvoie une chaîne comprenant les caractères représentés par les codes de caractère Unicode dans les paramètres.

Paramètres

Plus d’exemples

Recherche la chaîne et renvoie la position de la première occurrence de val détectée au niveau de ou après startIndex dans la chaîne appelante. Cet index commence à partir de zéro, ce qui signifie que le premier caractère d’une chaîne est considéré comme étant à l’index 0, et non pas à l’index 1. Si val n’est pas détecté, la méthode renvoie -1.

Paramètres

Plus d’exemples

Eléments de l’API associés

Recherche la chaîne de droite à gauche et renvoie l’index de la dernière occurrence de val détectée avant startIndex. L’index commence à zéro, ce qui signifie que le premier caractère occupe la position d’index 0 et le dernier, string.length - 1. Si val n’est pas détecté, la méthode renvoie -1.

Paramètres

Plus d’exemples

Eléments de l’API associés

Compare l’ordre de tri de deux chaînes ou plus et renvoie le résultat de la comparaison sous forme d’entier. Bien que cette méthode soit conçue pour traiter la comparaison en fonction des paramètres régionaux en vigueur, l’implémentation d’ActionScript 3.0 ne produit pas un résultat différent des autres comparaisons de chaînes, telles que les opérateurs d’égalité (==) ou d’inégalité (!=). Si les chaînes sont équivalentes, la valeur renvoyée est 0. Si la valeur de la chaîne d’origine est inférieure à la valeur de la chaîne spécifiée par other, la valeur renvoyée est un entier négatif, dont la valeur absolue représente le nombre de caractères qui séparent les deux valeurs de chaîne. Si la valeur de la chaîne d’origine est supérieure à other, la valeur renvoyée est un entier positif, dont la valeur absolue représente le nombre de caractères qui séparent les deux valeurs de chaîne.

Paramètres

Met en correspondance le paramètre pattern spécifié et la chaîne.

Paramètres

Plus d’exemples

Eléments de l’API associés

Compare les critères (pattern) spécifiés à la chaîne et renvoie une nouvelle chaîne dans laquelle la première correspondance de pattern est remplacée par le contenu spécifié par repl. Le paramètre pattern peut être une chaîne ou une expression régulière. Le paramètre repl peut être une chaîne ou une fonction. S’il s’agit d’une fonction, la chaîne renvoyée par la fonction est insérée à la place de la correspondance. La chaîne d’origine n’est pas modifiée.

Dans l’exemple suivant, seule la première occurrence de « sh » (le respect de la casse étant activé) est remplacée :

    var myPattern:RegExp = /sh/;  
    var str:String = "She sells seashells by the seashore.";
    trace(str.replace(myPattern, "sch"));  
       // She sells seaschells by the seashore.

Dans l’exemple suivant, toutes les occurrences de « sh » (le respect de la casse étant activé) sont remplacées, car l’indicateur g (global) est défini dans l’expression régulière :

    var myPattern:RegExp = /sh/g;  
    var str:String = "She sells seashells by the seashore.";
    trace(str.replace(myPattern, "sch"));  
       // She sells seaschells by the seaschore.

Dans l’exemple suivant, toutes les occurrences de « sh » sont remplacées, car l’indicateur g (global) est défini dans l’expression régulière et les correspondances ne respectent pas la casse, car l’indicateur i (ignoreCase) est défini :

    var myPattern:RegExp = /sh/gi;  
    var str:String = "She sells seashells by the seashore.";
    trace(str.replace(myPattern, "sch"));  
       // sche sells seaschells by the seaschore.

Paramètres

var str:String = "flip-flop";
    var pattern:RegExp = /(\w+)-(\w+)/g;
    trace(str.replace(pattern, "$2-$1")); // flop-flip

    var str1:String = "abc12 def34";
    var pattern:RegExp = /([a-z]+)([0-9]+)/;
    var str2:String = str1.replace(pattern, replFN);
    trace (str2);   // 12abc 34def
    
    function replFN():String {
      return arguments[2] + arguments[1];
    }

    {"abc12", "abc", "12", 0, "abc12 def34"}

    {"def34", "def", "34", 6, "abc123 def34"}

Plus d’exemples

Eléments de l’API associés

Recherche le paramètre pattern spécifié et renvoie l’index de la première sous-chaîne correspondante. Si aucune sous-chaîne correspondante n’est détectée, la méthode renvoie -1.

Paramètres

Plus d’exemples

Eléments de l’API associés

Renvoie une chaîne qui contient le caractère startIndex et tous les autres caractères jusqu’au caractère endIndex, ce dernier n’étant pas inclus. L’objet String d’origine n’est pas modifié. Si le paramètre endIndex 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 startIndex est identique au caractère indexé par endIndex ou s’il se trouve à droite de ce caractère, la méthode renvoie une chaîne vide.

Paramètres

Plus d’exemples

Eléments de l’API associés

Divise un objet String en un tableau de sous-chaînes en le divisant à chaque occurrence du paramètre delimiter spécifié.

Si le paramètre delimiter est une expression régulière, seule la première correspondance à une position donnée de la chaîne est prise en compte, même si un retour en arrière est susceptible de détecter une sous-chaîne non vide à cette position. Par exemple :

     var str:String = "ab";
     var results:Array = str.split(/a*?/); // results == ["","b"]
     
     results = str.split(/a*/); // results == ["","b"].)

Si le paramètre delimiter est une expression régulière contenant des parenthèses de regroupement, à chaque détection d’une correspondance de delimiter, les résultats, y compris tout résultat non défini, des parenthèses de regroupement sont rassemblés dans le tableau de sortie. Par exemple :

     var str:String = "Thi5 is a tricky-66 example.";
     var re:RegExp = /(\d+)/;
     var results:Array = str.split(re);
         // results == ["Thi","5"," is a tricky-","66"," example."]

Si le paramètre limit est spécifié, le nombre d’éléments du tableau renvoyé ne dépasse pas le nombre spécifié.

Si le paramètre delimiter est une chaîne vide, une expression régulière vide ou une expression régulière qui peut correspondre à une chaîne vide, chaque caractère de la chaîne est renvoyé en tant qu’élément du tableau.

Si le paramètre delimiter n’est pas défini, l’ensemble de la chaîne est placé dans le premier élément du tableau renvoyé.

Paramètres

Plus d’exemples

Eléments de l’API associés

Renvoie une sous-chaîne dont le premier caractère correspond à la position startIndex indiquée et dont la longueur est spécifiée par len. La chaîne d’origine n’est pas modifiée.

Paramètres

Plus d’exemples

Renvoie une chaîne composée du caractère spécifié par startIndex et de tous les caractères suivants jusqu’à endIndex - 1. Si endIndex n’est pas spécifié, String.length est utilisé. Si la valeur de startIndex est égale à la valeur endIndex, la méthode renvoie une chaîne vide. Si la valeur de startIndex est supérieure à la valeur de endIndex, les paramètres sont automatiquement permutés avant que la fonction ne s’exécute. La chaîne d’origine n’est pas modifiée.

Paramètres

Plus d’exemples

Renvoie une copie de cette chaîne, dont tous les caractères majuscules ont été convertis en minuscules. La chaîne d’origine n’est pas modifiée. Bien que cette méthode soit conçue pour traiter la conversion en fonction des paramètres régionaux en vigueur, l’implémentation d’ActionScript 3.0 ne produit pas un résultat différent de la méthode toLowerCase().

Eléments de l’API associés

Renvoie une copie de cette chaîne, dont tous les caractères minuscules ont été convertis en majuscules. La chaîne d’origine n’est pas modifiée. Bien que cette méthode soit conçue pour traiter la conversion en fonction des paramètres régionaux en vigueur, l’implémentation d’ActionScript 3.0 ne produit pas un résultat différent de la méthode toUpperCase().

Eléments de l’API associés

Renvoie une copie de cette chaîne, dont tous les caractères majuscules ont été convertis en minuscules. La chaîne d’origine n’est pas modifiée.

Cette méthode convertit tous les caractères (pas seulement A-Z) pour lesquels il existe des équivalents minuscules Unicode :

     var str:String = " JOSÉ BARÇA";
     trace(str.toLowerCase()); // josé barça

Ces mappages de casse sont définis sur la page Unicode Character Database (disponible en anglais uniquement).

Plus d’exemples

Eléments de l’API associés

Renvoie une copie de cette chaîne, dont tous les caractères minuscules ont été convertis en majuscules. La chaîne d’origine n’est pas modifiée.

Cette méthode convertit tous les caractères (pas seulement a-z) pour lesquels il existe des équivalents majuscules Unicode :

     var str:String = "José Barça";
     trace(str.toUpperCase()); // JOSÉ BARÇA

Ces mappages de casse sont définis sur la page Unicode Character Database (disponible en anglais uniquement).

Plus d’exemples

Eléments de l’API associés

Valeur primitive d’une occurrence de String. Cette méthode est conçue pour convertir un objet String en une valeur de chaîne primitive. Etant donné que les moteurs d’exécution de Flash appellent automatiquement la méthode valueOf(), il est rarement nécessaire d’y faire explicitement appel.

1. Le constructeur de StringExample déclare plusieurs occurrences String locales, qui sont initialisées avec différentes chaînes et un nouvel objet StringHelper.
2. La classe StringHelper dispose des méthodes suivantes :
   • replace() : appelle les méthodes split() et join() de String pour supprimer une sous-chaîne de la chaîne transmise avec une nouvelle sous-chaîne.
   • trim() : appelle trimBack() et trimFront() à l’aide des chaînes transmises et renvoie la chaîne mise à jour.
   • trimFront() : supprime de façon récursive tous les caractères qui correspondent au caractère char, en commençant par le début de la chaîne et en allant vers sa fin, jusqu’à ce que le premier caractère de la chaîne ne corresponde pas à char et renvoie la chaîne mise à jour.
   • trimBack() : supprime de façon récursive tous les caractères qui correspondent au caractère char, en commençant par la fin de la chaîne et en allant vers l’arrière, jusqu’à ce que le dernier caractère de la chaîne ne corresponde pas à char et renvoie la chaîne mise à jour.
   • stringToCharacter() : renvoie le premier caractère de la chaîne qui lui a été transmise.
3. Trois chaînes sont ensuite produites à l’aide des variables déclarées avec un appel à la méthode replace() qui est utilisée pour produire la deuxième chaîne et trim() pour produire la troisième chaîne.

package {
    import flash.display.Sprite;

    public class StringExample extends Sprite {
        public function StringExample() {
            var companyStr:String = new String("     Company X");
            var productStr:String = "Product Z Basic     ";
            var emptyStr:String = " ";
            var strHelper:StringHelper = new StringHelper();

            var companyProductStr:String = companyStr + emptyStr + productStr;
            trace("'" + companyProductStr + "'");    // '     Company X Product Z Basic     '

            companyProductStr = strHelper.replace(companyProductStr, "Basic", "Professional");
            trace("'" + companyProductStr + "'");    // '     Company X Product Z Professional     '

            companyProductStr = strHelper.trim(companyProductStr, emptyStr);
            trace("'" + companyProductStr + "'");    // 'Company X Product Z Professional'
        }
    }
}

class StringHelper {
    public function StringHelper() {
    }

    public function replace(str:String, oldSubStr:String, newSubStr:String):String {
        return str.split(oldSubStr).join(newSubStr);
    }

    public function trim(str:String, char:String):String {
        return trimBack(trimFront(str, char), char);
    }

    public function trimFront(str:String, char:String):String {
        char = stringToCharacter(char);
        if (str.charAt(0) == char) {
            str = trimFront(str.substring(1), char);
        }
        return str;
    }

    public function trimBack(str:String, char:String):String {
        char = stringToCharacter(char);
        if (str.charAt(str.length - 1) == char) {
            str = trimBack(str.substring(0, str.length - 1), char);
        }
        return str;
    }

    public function stringToCharacter(str:String):String {
        if (str.length == 1) {
            return str;
        }
        return str.slice(0, 1);
    }
}