Routines de type StringHandling
Les routines de type StringHandling contiennent différentes fonctions qui vous permettent d'effectuer différents types d'opérations et de vérifications (basées sur des méthodes Java) sur des expressions alphanumériques.
Vous pouvez accéder à ces fonctions en double-cliquant sur le nœud StringHandling dans le dossier des routines système dans la vue Repository.
Fonction |
Description |
Syntaxe |
---|---|---|
ALPHA |
Vérifie si l'expression est triée par ordre alphabétique. Retourne le booléen true si l'ordre alphabétique est vérifié, et false, dans le cas inverse. |
StringHandling.ALPHA("chaîne à vérifier") |
IS_ALPHA |
Vérifie si l'expression ne contient que des caractères alphabétiques. Retourne le booléen true si l'ordre alphabétique est vérifié, et false, dans le cas inverse. |
StringHandling.IS_ALPHA("chaîne à vérifier") |
CHANGE |
Remplace un élément d'une chaîne de caractères par l'élément de remplacement défini et retourne la nouvelle chaîne. |
StringHandling.CHANGE("chaîne à vérifier", "chaîne à remplacer","chaîne de remplacement") |
COUNT |
Retourne le nombre d'occurrences d'une sous-chaîne dans une chaîne de caractères. |
StringHandling.COUNT("chaîne à vérifier", "chaîne à compter") |
DOWNCASE |
Convertit toutes les majuscules d'une expression en minuscules et retourne la nouvelle chaîne. |
StringHandling.DOWNCASE("chaîne à convertir") |
UPCASE |
Convertit toutes les minuscules d'une expression en majuscules et retourne la nouvelle chaîne. |
StringHandling.UPCASE("chaîne à convertir") |
DQUOTE |
Entoure une expression de guillemets doubles. |
StringHandling.DQUOTE("chaîne à traiter") |
EREPLACE |
Remplace toutes les sous-chaînes de caractères correspondant à l'expression régulière donnée, dans l'ancienne chaîne de caractères par le remplacement donné et retourne une nouvelle chaîne de caractères. |
StringHandling.EREPLACE(oldStr, regex, replacement) |
Index |
Retourne la position, dans une chaîne de caractères, du premier caractère de la sous-chaîne recherchée. Si la sous-chaîne recherchée n'existe pas dans la chaine, -1 est retourné. |
StringHandling.INDEX("chaîne à vérifier", "sous-chaîne recherchée") |
LEFT |
Retourne une sous-chaîne correspondant aux n premiers caractères d'une chaîne de caractères. |
StringHandling.LEFT("chaîne à vérifier", nombre de caractères) |
RIGHT |
Retourne une sous-chaîne correspondant aux n derniers caractères d'une chaîne de caractères. |
StringHandling.RIGHT("chaîne à vérifier", nombre de caractères) |
LEN |
Retourne la longueur d'une chaîne de caractères. |
StringHandling.LEN("chaîne à vérifier") |
SPACE |
Retourne une chaîne faite du nombre de caractères vides indiqué. |
StringHandling.SPACE(nombre d'espaces à créer) |
SQUOTE |
Entoure une expression de guillemets simples. |
StringHandling.SQUOTE("chaîne à traiter") |
STR |
Retourne un caractère répété le nombre de fois indiqué. |
StringHandling.STR('caractère à générer', nombre de répétition) |
TRIM |
Supprime les espaces et les tabulations en début et fin d'une chaîne de caractères et retourne la nouvelle chaîne. |
StringHandling.TRIM("chaîne à traiter") |
BTRIM |
Supprime tous les espaces et les tabulations après le dernier caractère non vide d'une chaîne de caractères et retourne la nouvelle chaîne. |
StringHandling.BTRIM("chaîne à traiter") |
FTRIM |
Supprime tous les espaces et les tabulations jusqu'au premier caractère non vide d'une chaîne de caractères et retourne la nouvelle chaîne. |
StringHandling.FTRIM("chaîne à traiter") |
SUBSTR |
Retourne une partie d'une chaîne de caractères. Compte tous les caractères, y compris les blancs, en commençant au début de la chaîne de caractères. |
StringHandling.SUBSTR(string, start, length)
|
LTRIM |
Supprime les blancs ou les caractères au début d'une chaîne de caractères. |
StringHandling.LTRIM(string[, trim_set])
|
RTRIM |
Supprime les blancs ou les caractères à la fin d'une chaîne de caractères. |
StringHandling.RTRIM(string[, trim_set])
|
LPAD |
Convertit une chaîne de caractères en une chaîne d'une longueur spécifiée en ajoutant des blancs ou des caractères au début de la chaîne de caractères. |
StringHandling.LPAD(first_string, length[, second_string])
|
RPAD |
Convertit une chaîne de caractères en une chaîne d'une longueur spécifiée, en ajoutant des blancs ou des caractères à la fin de la chaîne. |
StringHandling.RPAD(first_string, length[, second_string])
|
INSTR |
Retourne la position d'un jeu de caractères dans une chaîne de caractères, en comptant de gauche à droite et à partir de 1. Notez que cette routine retourne 0 si la recherche n'obtient pas de résultat et NULL si la valeur de la recherche est NULL. |
StringHandling.INSTR(string, search_value, start, occurrence)
Par exemple, StringHandling.INSTR("Talend Technology", "e", 3, 2) démarre la recherche au troisième caractère l et retourne 7, la position du deuxième caractère e. |
INSTR |
Retourne la position d'un ensemble d'octets dans une chaîne de caractères, en comptant de gauche à droite et à partir de 1. Notez que cette routine retourne 0 si la recherche n'obtient pas de résultat et NULL si la valeur de la recherche est NULL. |
StringHandling.INSTR(byte[] string, byte[] search_value, start, occurrence)
|
TO_CHAR |
Convertit des valeurs numériques en chaînes de caractères textuelles. |
StringHandling.TO_CHAR(numeric_value) |
Exemple de vérification de tri alphabétique
Vous pouvez tester simplement la routine ALPHA, à l'aide d'un composant tJava par exemple, pour vérifier si la chaîne est triée dans l'ordre alphabétique :
System.out.println(StringHandling.ALPHA("abcdefg"));
La vérification retourne un booléen.
Exemple de vérification de type alphabétique
Vous pouvez tester simplement la routine IS_ALPHA, à l'aide d'un composant tJava par exemple, pour vérifier si la chaîne est de type alphabétique ou non :
System.out.println(StringHandling.IS_ALPHA("ab33cd"));
La vérification retourne un booléen.
Exemple de remplacement de chaîne
Vous pouvez tester simplement la routine CHANGE, à l'aide d'un composant tJava par exemple, pour contrôler le remplacement d'une chaîne par une autre :
System.out.println(StringHandling.CHANGE("hello world!", "world", "guy"));
La vérification retourne un booléen.
Exemple de vérification de chaîne
Vous pouvez tester simplement la routine INDEX, à l'aide d'un composant tJava par exemple, pour vérifier si la chaîne contient ou pas un caractère ou une chaîne de caractères :
System.out.println(StringHandling.INDEX("hello world!", "hello"));
System.out.println(StringHandling.INDEX("hello world!", "world"));
System.out.println(StringHandling.INDEX("hello world!", "!"));
System.out.println(StringHandling.INDEX("hello world", "?"));
La routine retourne un entier qui correspond à la position du premier caractère de la chaîne recherchée, ou du premier caractère de la sous-chaîne de caractères spécifiée. Sinon, la routine retourne -1 si la chaîne recherchée n'a pu être trouvée.
Exemple de calcul de longueur de chaîne
Vous pouvez tester simplement la routine LEN, à l'aide d'un composant tJava par exemple, pour contrôler la longueur d'une chaîne :
System.out.println(StringHandling.LEN("hello world!"));
La vérification retourne un entier correspondant à la longueur de la chaîne, y compris les espaces et caractères vides :
Exemple de nettoyage d'espaces inutiles
Vous pouvez tester simplement la routine FTRIM, à l'aide d'un composant tJava par exemple, afin de retirer, entre autres, une tabulation en tête de chaîne :
System.out.println(StringHandling.FTRIM(" Hello world !"));
La vérification retourne la chaîne nettoyée des espaces/tabulations présents en début de chaîne.