Cette page vous donne les différences entre la révision choisie et la version actuelle de la page.
string 14/03/2013 22:18 | string 21/03/2013 11:00 version actuelle | ||
---|---|---|---|
Ligne 8: | Ligne 8: | ||
String.Append(string str2) | String.Append(string str2) | ||
- | Accolle la chaîne de caractères (//string//) STR2 à la fin de la chaîne de caractères | + | 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.\\ \\ | (//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 | ** IMPORTANT : ** Le résultat de ce collage est retourné en tant qu'une nouvelle | ||
Ligne 244: | Ligne 244: | ||
====Replace==== | ====Replace==== | ||
- | String.Replace(string lookForText, string replaceWithText, | + | String.Replace(string texteCherche, string texteRemplacant, |
- | optional bool caseSensitive) | + | optional bool sensibleCasse) |
- | Crée une copie de cette chaîne, où toutes les occurrences de // lookForText // sont remplacées par // replaceWithText // .\\ \\ | + | Crée une copie de cette chaîne, où toutes les occurrences de // texteCherche // sont remplacées par // texteRemplacant // .\\ \\ |
- | // caseSensitive // vaut // false // par défaut, mais vous pouvez le passer comme true | + | // sensibleCasse // vaut // false // par défaut, mais vous pouvez le passer comme // true // |
- | de façon à ce que seules les occurrences dont la casse est la même que celle de // lookForText // soient remplacées.\\ \\ | + | de façon à ce que seules les occurrences dont la casse est la même que celle de // texteCherche // soient remplacées.\\ \\ |
** NOTE : ** Cette fonction retourne une nouvelle chaîne ; l'ancienne chaîne ** N'EST PAS MODIFIÉE ** par cette fonction. | ** NOTE : ** Cette fonction retourne une nouvelle chaîne ; l'ancienne chaîne ** N'EST PAS MODIFIÉE ** par cette fonction. | ||
Exemple : | Exemple : | ||
- | String original = "Hello from the script!"; | + | String originale = "Salut depuis le script !"; |
- | String changed = original.Replace("hello", "goodbye"); | + | String changee = originale.Replace("salut", "adieu"); |
- | Display("Old: %s, new: %s", original, changed); | + | Display("Ancienne : %s, nouvelle : %s", originale, changee); |
- | affichera "Old: Hello from the script!, new: goodbye from the script!".\\ \\ | + | affichera "Ancienne : Salut depuis le script !, nouvelle : adieu depuis le script !".\\ \\ |
// Compatibilité : // Supporté par ** AGS 3.1.0 ** et les versions plus récentes.\\ \\ | // Compatibilité : // Supporté par ** AGS 3.1.0 ** et les versions plus récentes.\\ \\ | ||
// Voir aussi : // [[String#ReplaceCharAt|String.ReplaceCharAt]]\\ \\ | // Voir aussi : // [[String#ReplaceCharAt|String.ReplaceCharAt]]\\ \\ | ||
Ligne 268: | Ligne 268: | ||
// (Anciennement fonction globale StrSetCharAt, désormais obsolète) // \\ \\ | // (Anciennement fonction globale StrSetCharAt, désormais obsolète) // \\ \\ | ||
- | String.ReplaceCharAt(int index, char newChar) | + | String.ReplaceCharAt(int index, char nouvelleLettre) |
- | Remplace le caractère à la position INDEX dans la chaîne par NEWCHAR.\\ \\ | + | 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, | 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).\\ \\ | et où la plus haute valeur possible correspond à la longueur de la chaîne moins 1).\\ \\ | ||
Ligne 276: | Ligne 276: | ||
Exemple : | Exemple : | ||
- | String mystring = "Hello"; | + | String machaine = "Salut"; |
- | String changed = mystring.ReplaceCharAt(2, 'm'); | + | String changee = machaine.ReplaceCharAt(2, 'm'); |
- | Display("Old: %s, new: %s", newstring, changed); | + | Display("Ancienne : %s, nouvelle : %s", machaine, changee); |
- | affichera "Old: Hello, new: Hemlo".\\ \\ | + | affichera "Ancienne : Salut, nouvelle : Samut".\\ \\ |
// Voir aussi : // [[String#Chars|String.Chars]], | // Voir aussi : // [[String#Chars|String.Chars]], | ||
[[String#Replace|String.Replace]]\\ \\ | [[String#Replace|String.Replace]]\\ \\ | ||
Ligne 290: | Ligne 290: | ||
====StartsWith==== | ====StartsWith==== | ||
- | bool String.StartsWith(string lookForText, optional bool caseSensitive) | + | bool String.StartsWith(string texteCherche, optional bool sensibleCasse) |
- | Retourne // true // si la chaîne commence par // lookForText // , ou // false // si ce n'est pas le cas.\\ \\ | + | Retourne // true // si la chaîne commence par // texteCherche // , ou // false // si ce n'est pas le cas.\\ \\ |
- | // caseSensitive // vaut // false // par défaut, mais vous pouvez le passer comme true pour que la fonction | + | // sensibleCasse // vaut // false // par défaut, mais vous pouvez le passer comme // true // pour que la fonction |
ne retourne // true // que lorsque la correspondance est sensible à la casse.\\ \\ | ne retourne // true // que lorsque la correspondance est sensible à la casse.\\ \\ | ||
Exemple : | Exemple : | ||
- | String myString = "Hello from the script!"; | + | String maChaine = "Salut depuis le script !"; |
- | if (myString.StartsWith("hello")) | + | if (maChaine.StartsWith("salut")) |
{ | { | ||
- | Display("Starts with hello!"); | + | Display("Commence par salut !"); |
} | } | ||
- | affichera le message "Starts with hello!".\\ \\ | + | affichera le message "Commence par salut !".\\ \\ |
- | // Compatibilité : // Supporté by ** AGS 3.1.0 ** et les versions plus récentes.\\ \\ | + | // Compatibilité : // Supporté par ** AGS 3.1.0 ** et les versions plus récentes.\\ \\ |
// Voir aussi : // [[String#EndsWith|String.EndsWith]], | // Voir aussi : // [[String#EndsWith|String.EndsWith]], | ||
[[String#IndexOf|String.IndexOf]]\\ \\ | [[String#IndexOf|String.IndexOf]]\\ \\ | ||
Ligne 314: | Ligne 314: | ||
====Substring==== | ====Substring==== | ||
- | String.Substring(int index, int length) | + | String.Substring(int index, int longueur) |
- | Retourne une partie de la chaîne, depuis le caractère // index // sur une longueur de // length //.\\ \\ | + | Retourne une partie de la chaîne, depuis le caractère // index // sur une longueur de // longueur //.\\ \\ |
// index // correspond à la position du caractère initial de la sous-chaîne que vous voulez récupérer, | // index // correspond à la position du caractère initial de la sous-chaîne que vous voulez récupérer, | ||
où 0 représente le tout premier caractère et (Longueur - 1) le dernier. | où 0 représente le tout premier caractère et (Longueur - 1) le dernier. | ||
- | // length // spécifie combien de caractères vous voulez récupérer depuis cette position.\\ \\ | + | // longueur // spécifie combien de caractères vous voulez récupérer depuis cette position.\\ \\ |
Exemple : | Exemple : | ||
- | String mystring = "Hello World!"; | + | String machaine = "Hello World!"; |
- | String substring = mystring.Substring(3, 5); | + | String souschaine = machaine.Substring(3, 5); |
- | Display("Original: %s, Substring: %s", mystring, substring); | + | Display("Originale : %s, Sous-chaine : %s", machaine, souschaine); |
- | affichera "Original: Hello World!, Substring: lo Wo".\\ \\ | + | affichera "Originale : Hello World!, Sous-chaine : lo Wo".\\ \\ |
// Voir aussi : // [[String#Append|String.Append]], [[String#String.Chars|String.Chars]]\\ \\ | // Voir aussi : // [[String#Append|String.Append]], [[String#String.Chars|String.Chars]]\\ \\ | ||
Ligne 335: | Ligne 335: | ||
====Truncate==== | ====Truncate==== | ||
- | String.Truncate(int length) | + | String.Truncate(int longueur) |
- | Retourne une version de la chaîne qui aura été coupée à // length // caractères.\\ \\ | + | Retourne une version de la chaîne qui aura été coupée à // longueur // caractères.\\ \\ |
** NOTE : ** Cette fonction retourne une nouvelle chaîne ; l'ancienne chaîne ** N'EST PAS MODIFIÉE ** par cette fonction.\\ \\ | ** NOTE : ** Cette fonction retourne une nouvelle chaîne ; l'ancienne chaîne ** N'EST PAS MODIFIÉE ** par cette fonction.\\ \\ | ||
Exemple : | Exemple : | ||
- | String mystring = "Hello World!"; | + | String machaine = "Hello World!"; |
- | String truncated = mystring.Truncate(4); | + | String tronquee = machaine.Truncate(4); |
- | Display("Original: %s, Truncated: %s", mystring, truncated); | + | Display("Originale : %s, Tronquee : %s", machaine, tronquee); |
- | affichera "Original: Hello World!, Truncated: Hell".\\ \\ | + | affichera "Originale : Hello World!, Tronquee : Hell".\\ \\ |
// Voir aussi : // [[String#Append|String.Append]], [[String#String.Substring|String.Substring]]\\ \\ | // Voir aussi : // [[String#Append|String.Append]], [[String#String.Substring|String.Substring]]\\ \\ | ||
Ligne 361: | Ligne 361: | ||
Exemple : | Exemple : | ||
- | String mystring = "THIS is a test string"; | + | String machaine = "CECI est une chaine de test"; |
- | String uppercased = mystring.UpperCase(); | + | String majuscules = machaine.UpperCase(); |
- | Display("Old: %s, new: %s", mystring, uppercased); | + | Display("Ancienne : %s, nouvelle : %s", machaine, majuscules); |
- | affichera "Old: THIS is a test string, new: THIS IS A TEST STRING".\\ \\ | + | affichera "Ancienne : CECI est une chaine de test, nouvelle : CECI EST UNE CHAINE DE TEST".\\ \\ |
// Voir aussi : // [[String#LowerCase|String.LowerCase]]\\ \\ | // Voir aussi : // [[String#LowerCase|String.LowerCase]]\\ \\ | ||
Ligne 376: | Ligne 376: | ||
readonly float String.AsFloat; | readonly float String.AsFloat; | ||
- | Convertie une chaîne en nombre flottant (à virgules), et retourne cette valeur. | + | Convertit une chaîne en nombre flottant (à virgules), et retourne cette valeur. |
Retourne 0.0 si la chaîne ne contient pas un nombre.\\ \\ | Retourne 0.0 si la chaîne ne contient pas un nombre.\\ \\ | ||
Exemple : | Exemple : | ||
- | String text1, text2; | + | String texte1, texte2; |
- | float number1,number2; | + | float nombre1,nombre2; |
- | text1 = "57.362"; | + | texte1 = "57.362"; |
- | text2 = "Hello"; | + | texte2 = "Salut"; |
- | number1 = text1.AsFloat; | + | nombre1 = texte1.AsFloat; |
- | number2 = text2.AsFloat; | + | nombre2 = texte2.AsFloat; |
- | définira la valeur de number1 à 57.362 et de number2 à 0.0. | + | 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.\\ \\ | 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 | ** NOTE : ** Pour convertir un flottant en chaîne de caractères, vous pouvez utiliser | ||
Ligne 404: | Ligne 404: | ||
readonly int String.AsInt; | readonly int String.AsInt; | ||
- | Convertie la chaîne de texte en nombre entier, et retourne cette valeur. | + | Convertit la chaîne de texte en nombre entier, et retourne cette valeur. |
Retourne 0 si la chaîne ne contient pas un nombre.\\ \\ | Retourne 0 si la chaîne ne contient pas un nombre.\\ \\ | ||
Exemple : | Exemple : | ||
- | String text1, text2; | + | String texte1, texte2; |
- | int number1,number2; | + | int nombre1,nombres2; |
- | text1 = "53"; | + | texte1 = "53"; |
- | text2 = "Hello"; | + | texte2 = "Salut"; |
- | number1 = text1.AsInt; | + | nombre1 = texte1.AsInt; |
- | number2 = text2.AsInt; | + | nombre2 = texte2.AsInt; |
- | définira la valeur de number1 à 53 et celle de number2 à 0. | + | définira la valeur de //nombre1// à 53 et celle de //nombre2// à 0. |
Cette fonction est utile pour traiter le texte entré par l'utilisateur.\\ \\ | 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 | ** NOTE : ** Pour convertir un entier en chaîne de texte, vous pouvez utiliser | ||
Ligne 440: | Ligne 440: | ||
Exemple : | Exemple : | ||
- | String text = "This is my string."; | + | String texte = "Voici ma chaine."; |
- | Display("The 4th character is: %c", text.Chars[3]); | + | Display("La 4eme lettre est : %c", texte.Chars[3]); |
- | affichera "The 4th character is: s".\\ \\ | + | affichera "La 4eme lettre est : s".\\ \\ |
// Voir aussi : // [[String#Length|String.Length]], | // Voir aussi : // [[String#Length|String.Length]], | ||
[[String#ReplaceCharAt|String.ReplaceCharAt]]\\ \\ | [[String#ReplaceCharAt|String.ReplaceCharAt]]\\ \\ | ||
Ligne 459: | Ligne 459: | ||
Exemple : | Exemple : | ||
- | String text = "This is my string."; | + | String texte = "Voici ma chaine."; |
- | Display("Length: %d", text.Length); | + | Display("Longueur: %d", texte.Length); |
- | affichera "Length: 18". | + | affichera "Longueur: 18". |
{{tag>français}} | {{tag>français}} |