String, objet

Article
08/10/2011

Permet de manipuler et mettre en forme des chaînes de texte, ainsi que définir et localiser des sous-chaînes à l'intérieur de chaînes.

function String([stringLiteral : String])

Arguments

stringLiteral
Facultatif. Tout groupe de caractères Unicode.

Notes

Les objets String peuvent être créés de manière implicite à l'aide de littéraux de chaîne. Les objets String créés de cette manière (appelés chaînes « primitives ») sont traités différemment des objets String créés au moyen de l'opérateur new. Même si vous pouvez lire des propriétés et appeler des méthodes sur des chaînes primitives, vous ne pouvez pas créer des nouvelles propriétés ni leur ajouter de méthodes.

Les séquences d'échappement peuvent être utilisées dans des littéraux de chaîne pour représenter des caractères spéciaux qui ne peuvent pas être utilisés directement dans une chaîne, tels que le caractère de saut de ligne ou les caractères Unicode. Lors de la compilation d'un script, chaque séquence d'échappement figurant dans un littéral de chaîne est convertie dans les caractères qu'elle représente. Pour plus d'informations, consultez Données de chaîne.

JScript définit également un type de données String, qui présente des propriétés et des méthodes différentes de l'objet String. Vous ne pouvez pas créer des propriétés ou ajouter des méthodes aux variables de type de données String alors que vous pouvez le faire pour des instances de l'objet String.

L'objet String interagit avec le type de données String (qui est identique au type de données System.String). Cela signifie qu'un objet String peut appeler les méthodes et propriétés du type de données String et à l'inverse, qu'un type de données String peut appeler les méthodes et propriétés de l'objet String. Pour plus d'informations, consultez String. Par ailleurs, les objets String sont acceptés par des fonctions qui utilisent des types de données String et inversement.

Le type de données d'un objet String est Object et non String.

Exemple 1

Ce script montre que la propriété length peut être lue et la méthode toUpperCase appelée, mais qu'il est en revanche impossible de définir, sur la chaîne primitive, la propriété personnalisée myProperty :

var primStr : Object = "This is a string";
print(primStr.length);           // Read the length property.
print(primStr.toUpperCase());    // Call a method.
primStr.myProperty = 42;         // Set a new property.
print(primStr.myProperty);       // Try to read it back.

Le résultat généré par ce script est le suivant :

16
THIS IS A STRING
undefined

Exemple 2

Pour les objets String créés avec l'instruction new, il est possible de définir des propriétés personnalisées :

var newStr : Object = new String("This is also a string");
print(newStr.length);           // Read the length property.
print(newStr.toUpperCase());    // Call a method.
newStr.myProperty = 42;         // Set a new property.
print(newStr.myProperty);       // Try to read it back.

Le résultat généré par ce script est le suivant :