Contents Up Previous Next

Fonctions de String

Append
AppendChar
CompareTo
Contains
Copy
Format
LowerCase
ReplaceCharAt
Substring
Truncate
UpperCase
AsInt property
Chars property
Length propriété


Append

(Anciennement fonction globale StrCat, désormais obsolète)

String.Append(string str2)
Ajoute la string STR2 à la fin de la string spécifiée, et retourne le résultat.

NOTE : La nouvelle chaîne concaténée est retournée en tant que nouvelle chaîne distincte par cette fonction ; cela ne modifie PAS la string originale.

Exemple :

String montexte = "Hello";
montexte = montexte.Append("World");
Display(montexte);
affichera "HelloWorld".

Voir Aussi : String.AppendChar, String.Substring, String.Truncate


AppendChar

String.AppendChar(char extraChar)
Ajoute un simple caractère à la fin de la string spécifiée, et retourne le résultat.

NOTE : La nouvelle chaîne concaténée est retournée en tant que nouvelle chaîne distincte par cette fonction ; cela ne modifie PAS la string originale.

Exemple :

String montexte = "Hell";
montexte = montexte.AppendChar('o');
Display(montexte);
affichera "Hello".

Voir Aussi : String.Append


CompareTo

(Anciennement fonction globale StrCaseComp, désormais obsolète)
(Anciennement fonction globale StrComp, désormais obsolète)

String.CompareTo(string str2, optional bool caseSensitive)
Compare la string spécifiée à STR2. caseSensitive détermine si "Chien" et "chien" seront équivalent ou non ; la sensibilité à la casse est désactivée par défaut.

Retourne 0 si les strings sont identiques, sinon une valeur différente de zéro.

Exemple :

String montexte = "Hello";
if (montexte.CompareTo("World") == 0) {
  Display("Les strings correspondent !");
}
else {
  Display("Les strings ne correspondent pas.");
}
affichera "Les strings ne correspondent pas.".


Contains

(Anciennement fonction globale StrContains, désormais obsolète)

String.Contains(string extrait)
Vérifie si EXTRAIT est contenu à l'intérieur de la string spécifiée. Retourne la position du caractère où commence les texte si celui-ci est contenu, sinon -1.

Cette fonction n'est pas sensible à la casse ; c'est-à-dire que rechercher "sTRiN" dans "string de test" trouvera une correspondance.

Exemple :

String boisson = "Cette boisson contient de l'extrait de coca.";
int result = boisson.Contains("extrait de coca");

if (result == -1) {
  Display("La string ne contenait pas l'extrait.");
}
else {
  Display("L'extrait a été trouvé au caractère numéro %d de la string.", result);
}

Copy

(Anciennement fonction globale StrCopy, désormais obsolète)

String.Copy()
Retourne une nouvelle copie de la string spécifiée. Vous ne devriez normalement pas avoir besoin d'utiliser cette fonction, puisque les strings de nouveau type peuvent être définie à l'aide de l'opérateur =.

Exemple :

String machaine = "Ceci est une string de test.";
String nouvellechaine = machaine.Copy();
Display(nouvellechaine);
affichera "Ceci est une string de test.".


Format

(Anciennement fonction globale StrFormat, désormais obsolète)

static String.Format(string fmt, ...)
Traite la string FMT comme si elle était passée dans une fonction Display, mais au lieu de l'afficher à l'écran, elle est retournée en tant que nouvelle string.

Vous pouvez donc insérer des valeurs de variables dans le message. Pour plus d'information, voyez la section string formatting.

NOTE : Cette fonction est static, ce qui signifie que vous ne pouvez pas l'appeler sur une variable chaîne existante, mais que vous devez utiliser String.Format() à la place.

Exemple :

int sante = 10;
String texte = String.Format("%d", sante);
créera une chaîne de caractères contenant "10".

Voir Aussi : Display


LowerCase

(Anciennement fonction globale StrToLowerCase, désormais obsolète)

String.LowerCase()
Retourne une version minuscule de la string spécifiée.

NOTE : La nouvelle string est retournée par cette fonction ; cela ne modifie PAS la string originale.

Exemple :

String machaine = "CECI est une string de test";
String minuscules = machaine.LowerCase();
Display("Ancienne : %s, Nouvelle : %s", machaine, minuscules);
affichera "Ancienne : CECI est une string de test, Nouvelle : ceci est une string de test".

Voir Aussi : String.UpperCase


ReplaceCharAt

(Anciennement fonction globale StrSetCharAt, désormais obsolète)

String.ReplaceCharAt(int index, char nouveauCaractere)
Change le caractère à la position INDEX dans la chaîne pour NOUVEAUCARACTERE.

INDEX est le numéro qui correspond à la position qu'occupe le caractère dans la chaîne (où 0 est le premier caractère, la plus grande valeur possible correspondant à la longueur de la string moins 1).

NOTE : La nouvelle string est retournée par cette fonction ; cela ne modifie PAS la string originale.

Exemple :

String machaine = "Balut";
String modifiee = machaine.ReplaceCharAt(0, 'S');
Display("Ancienne : %s, Nouvelle : %s", machaine, modifiee);
affichera : "Ancienne : Balut, Nouvelle : Salut".

Voir Aussi : String.Chars


Substring

String.Substring(int index, int longueur)
Retourne une partie de la chaîne, en commençant au caractère numéro index, avec une longueur de longueur caractères.

index est l'index du caractère de départ, où 0 est le premier caractère et (Longueur de la chaîne - 1) est le dernier. longueur spécifie combien de caractères sont récupérés.

Exemple :

String machaine = "Hello World !";
String souschaine = machaine.Substring(3, 5);
Display("Originale : %s, Sous-chaine : %s", machaine, souschaine);
affichera "Originale : Hello World !, Sous-chaine : lo Wo".

Voir Aussi : String.Append, String.Chars


Truncate

String.Truncate(int longueur)
Retourne uen version tronquée de la chaîne à longueur caractères de long.

NOTE : La nouvelle chaîne est retournée par cette fonction ; cela ne modifie PAS la string originale.

Exemple :

String machaine = "Hello World !";
String tronquee = mystring.Truncate(4);
Display("Originale : %s, Tronquée : %s", machaine, tronquee);
affichera "Originale : Hello World !, Tronquée : Hell".

Voir Aussi : String.Append, String.Substring


UpperCase

(Anciennement fonction globale StrToUpperCase, désormais obsolète)

String.UpperCase()
Retourne une version majuscule de la string spécifiée.

NOTE : La nouvelle chaîne est retournée par cette fonction ; cela ne modifie PAS la string originale.

Exemple :

String machaine = "CECI est une string de test";
String majuscules = machaine.UpperCase();
Display("Ancienne : %s, Nouvelle : %s", machaine, majuscules);
affichera "Ancienne : CECI est une string de test, Nouvelle : CECI EST UNE STRING DE TEST".

Voir Aussi : String.LowerCase


AsInt property

(Anciennement fonction globale StringToInt, désormais obsolète)

readonly int String.AsInt;
Convertie la chaîne en entier, et retourne la valeur obtenue. Retourne zéro si la chaîne ne contient pas un nombre.

Exemple :

String texte1, texte2;
int nombre1,nombre2;
texte1 = "53";
texte2 = "Salut";
nombre1 = texte1.AsInt;
nombre2 = texte2.AsInt;
donnera la valeur 53 à nombre1 et 0 à nombre2. Cette fonction est utile pour traiter des chaînes contenant du texte entré par l'utilisateur.

NOTE : Pour convertir un entier en chaîne, vous pouvez utiliser la commande String.Format.

Voir Aussi : Game.InputBox, String.Format


Chars property

(Anciennement fonction globale StrGetCharAt, désormais obsolète)

readonly char String.Chars[position];
Retourne le caractère qui se situe à la position POSITION dans la chaîne.

POSITION set l'index du caractère (où 0 est le premier caractère, la plus grande valeur possible étant Longueur moins 1).

Si POSITION est plus grande que la longueur de la chaîne, la fonction retournera 0.

NOTE : Le tableau Chars est en lecture seule. Si vous voulez changer un des caractères dan sla chaîne, utilisez String.ReplaceCharAt.

Exemple :

String texte = "Ceci est ma string.";
Display("Le quatrième caractère est : %c", text.Chars[3]);
affichera "Le quatrième caractère est : i".

Voir Aussi : String.Length, String.ReplaceCharAt


Length property

(Anciennement fonction globale StrLen, désormais obsolète)

readonly int String.Length;
Retourne la longueur de la chaîne, ce qui correspond au nombre de caractères qui la composent.

Exemple :

String texte = "Ceci est ma string.";
Display("Longueur : %d", texte.Length);
affichera "Longueur : 19".