(Anciennement fonction globale StrCat, désormais obsolète)
String.Append(string str2)
Accole la chaîne de caractères (string) STR2 à la fin de la chaîne de caractères
(string) spécifiée, et retourne le résultat de l'opération.
IMPORTANT : Le résultat de ce collage est retourné en tant qu'une nouvelle
chaîne de caractères (string) par cette commande. La chaîne originale NE SERA PAS
modifiée. Par exemple, le script suivant ne fera rien :
montexte.Append("World");
ce que vous désireriez plutôt serait :
montexte = montexte.Append("World"); \\ \\
Exemple :
String montexte = "Hello"; montexte = montexte.Append("World"); Display(montexte);
ce qui affichera “HelloWorld”.
Voir aussi : String.AppendChar,
String.Substring, String.Truncate
String.AppendChar(char extraChar)Ajoute un simple caractère à la fin du texte spécifié, et retourne le résultat.
String montexte = "Hell"; montexte = montexte.AppendChar('o'); Display(montexte);
ce qui affichera “Hello”.
Voir aussi : String.Append
(Anciennement fonction globale StrCaseComp, désormais obsolète)
(Anciennement fonction globale StrComp, désormais obsolète)
String.CompareTo(string str2, optional bool caseSensitive)
Compare le texte spécifié à STR2. caseSensitive détermine si “Chien” et “chien”
sont équivalents ; par défaut, la sensibilité à la casse n'est pas prise en compte.
Retourne 0 si les textes sont identiques, un nombre inférieur à 0 si la chaîne précède STR2 dans l'ordre alphabétique,
et un nombre supérieur à 0 si la chaîne se trouve plus loin dans l'alphabet que STR2.
ASTUCE : Pour effectuer une comparaison susceptible à la casse de deux textes, il est plus
facile d'utiliser simplement l'opérateur ==.
Exemple :
String montexte = "Bonjour"; if (montexte.CompareTo("bonjour") == 0) { Display("Les textes correspondent avec insensibilité à la casse !"); } else { Display("Les textes ne correspondent pas avec insensibilité à la casse !"); } if (montexte == "bonjour") { Display("Les textes correspondent avec sensibilité à la casse !"); } else { Display("Les textes ne correspondent pas avec sensibilité à la casse !"); }
ce qui affichera “Les textes correspondent avec insensibilité à la casse !”, puis
“Les textes ne correspondent pas avec sensibilité à la casse !”.
(Anciennement fonction globale StrCopy, désormais obsolète)
String.Copy()
Retourne une copie de la chaîne spécifiée. En temps normal, vous n'en aurez pas
l'utilité, puisque les chaînes peuvent être définies en utilisant l'opérateur =.
Exemple :
String machaine = "Ceci est une chaîne-test."; String nouvellechaine = machaine.Copy(); Display(nouvellechaine);
affichera “Ceci est une chaîne-test.”.
bool String.EndsWith(string texteRecherche, optional bool caseSensitive)Retourne true si la chaîne se termine par texteRecherche , ou false sinon.
String maChaine = "Bonjour depuis le script !"; if (maChaine.EndsWith("script !")) { Display("Finit par script !"); }
affichera le message “Finit avec script !”.
Compatibilité : Supporté par AGS 3.1.0 et les versions plus récentes.
Voir aussi : String.IndexOf,
String.StartsWith
(Anciennement fonction globale StrFormat, désormais obsolète)
static String.Format(string fmt, ...)
Traite la chaîne FMT de la même façon que le fait la fonction Display
mais plutôt que de l'afficher à l'écran, retourne le résultat comme une nouvelle chaîne.
Vous pouvez ainsi insérer des valeurs de variables dans la chaîne. Pour plus d'informations,
voir la section syntaxe des chaînes de caractères.
NOTE : Cette fonction est statique, ce qui signifie que vous
ne devez pas l'appeler depuis une variable chaîne existante, mais
plutôt en utilisant directement String.Format().
Exemple :
int sante=10; String texte = String.Format("%d", sante);
créera une chaîne de texte contenant “10”.
Voir aussi : Display
(Anciennement fonction globale StrContains, désormais obsolète)
(Anciennement String.Contains, désormais obsolète)
String.IndexOf(string aiguille)
Verifie si AIGUILLE est contenue dans la chaîne de texte testée. Retourne la position du caractère
correspondant si c'est le cas, ou -1 s'il n'y a pas de correspondance.
Cette fonction ne prend pas la casse en compte ; c'est-à-dire que chercher “cHaInE” dans “chaine de test”
retournerait bien une correspondance.
Exemple :
String botte = "Il y a une aiguille dans la botte de foin."; int resultat = botte.IndexOf("une aiguille"); if (resultat == -1) { Display("La chaîne ne contenait pas une aiguille."); } else { Display("une aiguille a été trouvée au caractère numéro %d dans la chaîne.", resultat); }
Voir aussi : String.EndsWith,
String.StartsWith
static bool String.IsNullOrEmpty(String chaineTestee)Renseigne si la chaîne est vide ou nulle. C'est un simple raccourci pour le test suivant :
if ((chaineTestee == null) || (chaineTestee == ""))
autrement dit, vous pouvez l'utiliser facilement pour vérifier si une chaîne contient du texte ou non.
NOTE : Cette fonction est statique, ce qui signifie que vous ne devez pas l'appeler
à partir d'une variable chaîne de caractère. Utilisez plutôt directement String.IsNullOrEmpty().
Voir l'exemple.
Exemple :
String maChaine; if (String.IsNullOrEmpty(maChaine)) { maChaine = "Du texte"; }
donnera la valeur “Du texte” à la variable maChaine si celle-ci est nulle ou vide (ce qui est le cas en l'occurrence).
Compatibilité : Supporté par AGS 3.0.1 et les versions plus récentes.
(Anciennement fonction globale StrToLowerCase, désormais obsolète)
String.LowerCase()
Retourne une version minuscule de la chaîne de texte spécifiée.
NOTE : Cette fonction retourne une nouvelle chaîne ;
elle NE MODIFIE PAS la chaîne originale.
Exemple :
String maChaine = "CECI est une chaîne de test"; String minuscule = maChaine.LowerCase(); Display("Ancienne : %s, nouvelle : %s", maChaine, minuscule);
affichera “Ancienne : CECI est une chaîne de test, nouvelle : ceci est une chaîne de test”.
Voir aussi : String.UpperCase
String.Replace(string texteCherche, string texteRemplacant, optional bool sensibleCasse)Crée une copie de cette chaîne, où toutes les occurrences de texteCherche sont remplacées par texteRemplacant .
String originale = "Salut depuis le script !"; String changee = originale.Replace("salut", "adieu"); Display("Ancienne : %s, nouvelle : %s", originale, changee);
affichera “Ancienne : Salut depuis le script !, nouvelle : adieu depuis le script !”.
Compatibilité : Supporté par AGS 3.1.0 et les versions plus récentes.
Voir aussi : String.ReplaceCharAt
(Anciennement fonction globale StrSetCharAt, désormais obsolète)
String.ReplaceCharAt(int index, char nouvelleLettre)
Remplace le caractère à la position INDEX dans la chaîne par NOUVELLELETTRE.
INDEX correspond à l'index du caractère dans la chaîne (où 0 renvoie au premier caractère,
et où la plus haute valeur possible correspond à la longueur de la chaîne moins 1).
NOTE : Cette fonction retourne une nouvelle chaîne ; l'ancienne chaîne N'EST PAS MODIFIÉE par cette fonction.
Exemple :
String machaine = "Salut"; String changee = machaine.ReplaceCharAt(2, 'm'); Display("Ancienne : %s, nouvelle : %s", machaine, changee);
affichera “Ancienne : Salut, nouvelle : Samut”.
Voir aussi : String.Chars,
String.Replace
bool String.StartsWith(string texteCherche, optional bool sensibleCasse)Retourne true si la chaîne commence par texteCherche , ou false si ce n'est pas le cas.
String maChaine = "Salut depuis le script !"; if (maChaine.StartsWith("salut")) { Display("Commence par salut !"); }
affichera le message “Commence par salut !”.
Compatibilité : Supporté par AGS 3.1.0 et les versions plus récentes.
Voir aussi : String.EndsWith,
String.IndexOf
String.Substring(int index, int longueur)Retourne une partie de la chaîne, depuis le caractère index sur une longueur de longueur .
// longueur // spécifie combien de caractères vous voulez récupérer depuis cette position.\\ \\
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
String.Truncate(int longueur)Retourne une version de la chaîne qui aura été coupée à longueur caractères.
String machaine = "Hello World!"; String tronquee = machaine.Truncate(4); Display("Originale : %s, Tronquee : %s", machaine, tronquee);
affichera “Originale : Hello World!, Tronquee : Hell”.
Voir aussi : String.Append, String.Substring
(Anciennement fonction globale StrToUpperCase, désormais obsolète)
String.UpperCase()
Retourne une version majuscule de la chaîne spécifiée.
NOTE : Cette fonction retourne une nouvelle chaîne ; l'ancienne chaîne N'EST PAS MODIFIÉE par cette fonction.
Exemple :
String machaine = "CECI est une chaine de test"; String majuscules = machaine.UpperCase(); Display("Ancienne : %s, nouvelle : %s", machaine, majuscules);
affichera “Ancienne : CECI est une chaine de test, nouvelle : CECI EST UNE CHAINE DE TEST”.
Voir aussi : String.LowerCase
readonly float String.AsFloat;Convertit une chaîne en nombre flottant (à virgules), et retourne cette valeur. Retourne 0.0 si la chaîne ne contient pas un nombre.
String texte1, texte2; float nombre1,nombre2; texte1 = "57.362"; texte2 = "Salut"; nombre1 = texte1.AsFloat; nombre2 = texte2.AsFloat;
définira la valeur de nombre1 à 57.362 et de nombre2 à 0.0.
Cette fonction est pratique pour traiter le texte entré par l'utilisateur.
NOTE : Pour convertir un flottant en chaîne de caractères, vous pouvez utiliser
la commande String.Format.
Voir aussi : Game.InputBox,
String.AsInt,
String.Format
(Anciennement fonction globale StringToInt, désormais obsolète)
readonly int String.AsInt;
Convertit la chaîne de texte en nombre entier, et retourne cette valeur.
Retourne 0 si la chaîne ne contient pas un nombre.
Exemple :
String texte1, texte2; int nombre1,nombres2; texte1 = "53"; texte2 = "Salut"; nombre1 = texte1.AsInt; nombre2 = texte2.AsInt;
définira la valeur de nombre1 à 53 et celle de nombre2 à 0.
Cette fonction est utile pour traiter le texte entré par l'utilisateur.
NOTE : Pour convertir un entier en chaîne de texte, vous pouvez utiliser
la commande String.Format.
Voir aussi : Game.InputBox, String.AsFloat,
String.Format
(Anciennement fonction globale StrGetCharAt, désormais obsolète)
readonly char String.Chars[position];
Retourne le caractère à POSITION dans la chaîne.
POSITION est la position du caractère dans la chaîne (où 0 correspond au tout
premier caractère, et où la plus haute valeur possible correspond à la longueur
de la chaîne moins 1)
Si POSITION vaut plus que la longueur de la chaîne, la fonction retourne 0.
NOTE : Le tableau Chars est en lecture seule. Si vous désirez
changer l'un des caractères dans la chaîne, utilisez String.ReplaceCharAt.
Exemple :
String texte = "Voici ma chaine."; Display("La 4eme lettre est : %c", texte.Chars[3]);
affichera “La 4eme lettre est : s”.
Voir aussi : String.Length,
String.ReplaceCharAt
(Anciennement fonction globale StrLen, désormais obsolète)
readonly int String.Length;
Retourne la longueur de la chaîne, c'est-à-dire le nombre de caractères qu'elle contient.
Exemple :
String texte = "Voici ma chaine."; Display("Longueur: %d", texte.Length);
affichera “Longueur: 18”.