Thème "Textes"

   Ensemble des méthodes et macros disponibles dans le thème "Textes".

if ({text}.indexOf({pattern}) > -1) {
// TODO
}

Génère le code permettant de vérifier si un texte contient la chaîne de caractères souhaitée.

Exemple :
String text = "a"
if (text.indexOf("a") > -1) {
   report("Text contains a");
} else {
   report("Text doesn't contain a");
}

if (text.indexOf("b") > -1) {
   report("Text contains b");
} else {
   report("Text doesn't contain b");
}

if (text.indexOf("A") > -1) {
   report("Text contains A");
} else {
   report("Text doesn't contain A");
}

Variable/String text - Variable (de type String) ou chaîne de caractères qu'on souhaite tester.
Variable/String pattern - Variable (de type String) ou chaîne de caractères à rechercher dans la valeur spécifiée dans le paramètre.

1

String createString(char filler, int count)

Crée une chaîne (String) à l'aide de la répétition du caractère (char) spécifié.

Exemple :
String text = xtString.createString('a', 10);
report("Text : [$1]", text);    // Texte : [aaaaaaaaaa]

char filler - Caractère à utiliser pour créer le texte. Exemple : 'C'.
int count - Taille du texte à créer. Exemple 10.

String - Texte construit par répétition du caractère spécifié.

1

if ({text}.endsWith({endPattern})) {
// TODO
}

Génère le code permettant de vérifier si un texte se termine par la chaîne de caractères souhaitée.

Exemple :
String text = "abc";
if (text.endsWith("b")) {
   report("Text [$1] ends with \"b\"");
} else {
   report("Text [$1] doesn't end with \"b\"");
}

if (text.endsWith("a")) {
   report("Text [$1] ends with \"a\"");
} else {
   report("Text [$1] doesn't end with \"a\"");
}

Variable/String text - Variable (de type String) ou chaîne de caractères qu'on souhaite tester.
Variable/String pattern - Variable (de type String) ou chaîne de caractères à rechercher en fin de la valeur spécifiée dans le paramètre.

1

boolean isEmpty(String text)

Teste si un texte est vide ou ne contient que des espaces.

Exemple :
if (xtString.isEmpty("")) {
   report("Text \"\" is empty");
} else {
   report("Text \"\" isn't empty");
}

if (xtString.isEmpty(" ")) {
   report("Text \" \" is empty");
} else {
   report("Text \" \" isn't empty");
}

if (xtString.isEmpty("a")) {
   report("Text \"a\" is empty");
} else {
   report("Text \"a\" isn't empty");
}

String text - Texte à tester.

boolean - Vrai (True) si le texte est vide ou ne contient que des espaces.

1

boolean isNotEmpty(String text)

Teste si un texte n'est pas vide et contient au moins un caractère autre que le caractère espace.

Exemple :
if (xtString.isNotEmpty("")) {
   report("Text \"\" isn't empty");
} else {
   report("Text \"\" is empty");
}
if (xtString.isNotEmpty(" ")) {
   report("Text \" \" isn't empty");
} else {
   report("Text \" \" is empty");
}
if (xtString.isNotEmpty("a")) {
   report("Text \"a\" isn't empty");
} else {
   report("Text \"a\" is empty");
}

String text - Texte à tester.

boolean - Vrai (True) si le texte n'est pas vide et contient au moins un caractère autre que le caractère espace.

1

{text}.length()

Génère le code permettant de récupérer la taille d'une chaîne de caractères. La valeur de la méthode "length()", générée par cette macro, peut être stockée dans une variable de type int.

Exemple :
report("String length \"\" : [$1]", "".length());    // String length "" : [0]
report("String length \" \" : [$1]", " ".length());    // String length " " : [1]
report("String length \"abc\" : [$1]", "abc".length());    // String length "abc" : [3]

Variable/String text - Variable (de type String) ou chaîne de caractères dont on souhaite récupérer la longueur.

1

String lpad(String text, int size, char chr)

Ajoute ou supprime des caractères à gauche du texte spécifié pour atteindre la taille demandée.

Exemples :

char character = 'z';

text = "bat";
size = 3;
report("lpad : Original text [$1], size [$2], additional character [$3] ==> result [$4]", text, size, character, xtString.lpad(text, size, character));    // lpad : Original text [bat], size [3], additional character [z] ==> result [bat]

size = 5;
report("lpad : Original text [$1], size [$2], additional character [$3] ==> result [$4]", text, size, character, xtString.lpad(text, size, character));    // lpad : Original text [bat], size [5], additional character [z] ==> result [zzbat]

size = 1;
report("lpad : Original text [$1], size [$2], additional character [$3] ==> result [$4]", text, size, character, xtString.lpad(text, size, character));    // lpad : Original text [bat], size [1], additional character [z] ==> result [b]

size = -1;
try {
   report("lpad : Original text [$1], size [$2], additional character [$3] ==> result [$4]", text, size, character, xtString.lpad(text, size, character));    // Appel de la méthode en erreur car la taille est négative
} catch(XTException e) {
   report("Error when call lpad with negative size");
}

String text = null;
int size = 3;
report("lpad : Original text [$1], size [$2], additional character [$3] ==> result [$4]", text, size, character, xtString.lpad(text, size, character));    // lpad : Original text [null], size [3], additional character [z] ==> result [null]

text = "";
size = 3;
report("lpad : Original text [$1], size [$2], additional character [$3] ==> result [$4]", text, size, character, xtString.lpad(text, size, character));   // lpad : Original text [], size [3], additional character [z] ==> result [zzz]

String text - Texte initial.
int size - Taille finale du texte (supérieur ou égale à 0).
char chr - Caractère pour compléter (si la taille du texte initiale est inférieure à la taille finale).

String - Texte formaté.

XTException - Si la taille finale est inférieure à 0.

1

String ltrim(String text)

Supprime les caractères "espaces" en début de texte.

Exemple :
L'appel xtString.ltrim("    Hello     ") renvoie la chaîne "Hello     ".

String text - Texte initial.

String - Texte sans les espaces devant.

1

String normalizeSpaces(String text)

Supprime les caractères "espaces" autour du texte spécifié, ainsi que les caractères "espaces" consécutifs dans le texte lui-même.

Exemple :
L'appel xtString.normalizeSpaces("   normalize   spaces around words     ") renvoie la chaîne "normalize spaces around words".

String text - Texte à transformer.

String - Texte modifié.

1

String rpad(String text, int size, char chr)

Ajoute ou supprime des caractères à gauche du texte spécifié pour atteindre la taille demandée.

Exemple :
int size = 3;
char character = 'z';
text = "bat";
size = 3;
report("rpad : Original text [$1], size [$2], additional character [$3] ==> result [$4]", text, size, character, xtString.rpad(text, size, character));    // rpad : Original text [bat], size [3], additional character [z] ==> result [bat]

size = 5;
report("rpad : Original text [$1], size [$2], additional character [$3] ==> result [$4]", text, size, character, xtString.rpad(text, size, character));    // rpad : Original text [bat], size [5], additional character [z] ==> result [batzz]

size = 1;
report("rpad : Original text [$1], size [$2], additional character [$3] ==> result [$4]", text, size, character, xtString.rpad(text, size, character));    // rpad : Original text [bat], size [1], additional character [z] ==> result [b]

size = -1;
try {
   report("rpad : Original text [$1], size [$2], additional character [$3] ==> result [$4]", text, size, character, xtString.rpad(text, size, character));   // Appel de la méthode en erreur car la taille est négative
} catch(XTException e) {
   report("Error when call rpad with negative size");
}
String text = null;
size = 3;
report("rpad : Original text [$1], size [$2], additional character [$3] ==> result [$4]", text, size, character, xtString.rpad(text, size, character));    // rpad : Original text [null], size [3], additional character [z] ==> result [null]

String text = "";
size = 3;
report("rpad : Original text [$1], size [$2], additional character [$3] ==> result [$4]", text, size, character, xtString.rpad(text, size, character));    // rpad : Original text [], size [3], additional character [z] ==> result [zzz]

String text - Texte initial.
int size - Taille finale du texte (supérieur ou égale à 0).
char chr - Caractère pour compléter (si la taille du texte initiale est inférieure à la taille finale).

String - Texte formaté.

XTException - Si la taille finale est inférieure à 0.

1

String rtrim(String text)

Supprime les caractères "espace" à la fin d'un texte.

Exemple :
L'appel xtString.rtrim("    trim     ") renvoie la chaîne "   trim"

String text - Texte initial.

String - Texte sans les espaces à la fin.

1

if ({text}.startsWith({startPattern})) {
// TODO
}

Génère le code permettant de vérifier si un texte commence par la chaîne de caractères souhaitée.

Exemple :
String text = "abc";
if (text.startsWith("b")) {
   report("Text [$1] starts with \"b\"");
} else {
   report("Text [$1] doesn't start with \"b\"");
}

if (text.startsWith("a")) {
   report("Text [$1] starts with \"a\"");
} else {
   report("Text [$1] doesn't start with \"a\"");
}

Variable/String text - Variable (de type String) ou chaîne de caractères qu'on souhaite tester.
Variable/String pattern - Variable (de type String) ou chaîne de caractères à rechercher au début de la valeur spécifiée dans le paramètre.

1

String substringUseLength(String text, int start, int length)

Extrait une chaîne de caractères d'un texte principal, en utilisant une position de départ et le nombre de caractères à extraire. La position de départ commence à partir de 0 et elle est elle-même incluse.

Exemple :
String text = "1234567890"; xtString.substringUseLength(text, 2, 5) renvoie la chaîne de caractères "34567".

String text - Texte initial.
int start - Position de départ.
int length - Taille à extraire.

String - Texte extrait.

XTException

1

{text}.substring({startIndex}, {endIndex})

Génère le code java permettant d'extraire une chaîne de caractères d'un texte principal. La sous-chaîne commence à partir de l'index de début et s'étend au caractère de l'index de fin moins 1. Ainsi, la longueur de la sous-chaîne est index de fin moins index de début. Les index commencent à partir de 0.

Exemple :
String text = "123456";
L'appel text.substring(1,5) renvoie la chaîne "2345".

Variable/String text - Variable (de type String) ou chaîne de caractères d'origine.
int startIndex - Index de départ, compris, pour extraire la sous-chaîne à partir de la chaîne d'origine.
int endIndex - Index de fin, non compris, pour extraire la sous-chaîne à partir de la chaîne d'origine.

String - Texte extrait.

IndexOutOfBoundsException - Si l'index de départ ou de fin est négatif,ou si l'index de début ou de fin est plus grand que la taille de la chaîne.

1

String truncateRight(String text, int size)

Tronque le texte à droite si sa taille excède celle demandée. Note : les sauts de ligne sont supprimés.

Exemple :
String text = "123456";
L'appel xtString.truncateRight(text, 5) produit la chaîne de caractères "12345".

String text - Texte à traiter.
int size - Taille maximale souhaitée.

String - Texte tronqué avec la taille spécifiée.

1