# 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.

Fonctions de la routine StringHandlingFonctions de la routine StringHandlingStringHandling

| 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)<br><br><ul> <li> <p> <span>string</span>&nbsp;: chaîne de caractères à rechercher.</p> </li> <li> <p> <span>start</span> : position dans la chaîne de caractères à partir de laquelle commencer à compter.</p> </li> <li> <p> <span>length</span> : nombre de caractères à retourner.</p> </li> </ul> |
| LTRIM | Supprime les blancs ou les caractères au début d'une chaîne de caractères. | StringHandling.LTRIM(string[, trim\_set])<br><br><ul> <li> <p> <span>string</span> : chaîne de caractères à modifier.</p> </li> <li> <p> <span>trim_set</span> : caractères à supprimer du début de la chaîne. 											<span>LTRIM</span> va comparer <span>trim_set</span> à la chaîne, caractère par caractère, en commençant par le côté gauche de la chaîne et supprimer les caractères jusqu'à ne plus trouver de caractère correspondant dans <span>trim_set</span>. Si ce paramètre n'est pas spécifié, <span>LTRIM</span> va supprimer tous les caractères blancs du début de la chaîne.</p> </li> </ul> |
| RTRIM | Supprime les blancs ou les caractères à la fin d'une chaîne de caractères. | StringHandling.RTRIM(string[, trim\_set])<br><br><ul> <li> <p> <span>string</span> : chaîne de caractères à modifier.</p> </li> <li> <p> <span>trim_set</span> : caractères à supprimer de la fin de la chaîne. <span>RTRIM</span> va comparer <span>trim_set</span> à la chaîne, caractère par caractère, en commençant par le côté droit de la chaîne et supprimer les caractères jusqu'à ne plus trouver de caractère correspondant dans <span>trim_set</span>. Si ce paramètre n'est pas spécifié, <span>RTRIM</span> va supprimer tous les caractères blancs de la fin de la chaîne.</p> </li> </ul> |
| 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])<br><br><ul> <li> <p> <span>first_string</span> : chaîne de caractères à modifier.</p> </li> <li> <p> <span>length</span> : longueur souhaitée pour la chaîne après remplissage.</p> </li> <li> <p> <span>second_string</span> : caractères à ajouter à gauche de <span>first_string</span>.</p> </li> </ul> |
| 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])<br><br><ul> <li> <p> <span>first_string</span> : chaîne de caractères à modifier.</p> </li> <li> <p> <span>length</span> : longueur souhaitée pour la chaîne après remplissage.</p> </li> <li> <p> <span>second_string</span> : caractères à ajouter à droite de <span>first_string</span>.</p> </li> </ul> |
| 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.<br><br>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)<br><br><ul> <li> <p> <span>string</span>&nbsp;: chaîne de caractères à rechercher.</p> </li> <li> <p> <span>search_value</span> : jeu de caractères à rechercher.</p> </li> <li> <p> <span>start</span> : position dans la chaîne de caractères à partir de laquelle commencer la recherche. La valeur par défaut est <span>1</span>, ce qui signifie rechercher à partir du premier caractère de la chaîne.</p> </li> <li> <p> <span>occurrence</span>&nbsp;: occurrences à rechercher.</p> </li> </ul><br><br>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.<br><br>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)<br><br><ul> <li> <p> <span>string</span>&nbsp;: chaîne de caractères à rechercher.</p> </li> <li> <p> <span>search_value</span> : jeu de caractères à rechercher.</p> </li> <li> <p> <span>start</span> : position dans la chaîne de caractères à partir de laquelle commencer la recherche. La valeur par défaut est <span>1</span>, ce qui signifie rechercher à partir du premier caractère de la chaîne.</p> </li> <li> <p> <span>occurrence</span>&nbsp;: occurrences à rechercher.</p> </li> </ul> |
| TO\_CHAR | Convertit des valeurs numériques en chaînes de caractères textuelles. | StringHandling.TO\_CHAR(numeric\_value) |

### Dans cette section

* [Exemple de vérification de tri alphabétique](https://help.qlik.com/talend/fr-FR/studio-user-guide/8.0-R2024-05/storing-string-in-alphabetical-order)
* [Exemple de vérification de type alphabétique](https://help.qlik.com/talend/fr-FR/studio-user-guide/8.0-R2024-05/checking-whether-string-is-alphabetical)
* [Exemple de remplacement de chaîne](https://help.qlik.com/talend/fr-FR/studio-user-guide/8.0-R2024-05/replacing-element-in-string)
* [Exemple de vérification de chaîne](https://help.qlik.com/talend/fr-FR/studio-user-guide/8.0-R2024-05/checking-position-of-specific-character-or-substring-within-string)
* [Exemple de calcul de longueur de chaîne](https://help.qlik.com/talend/fr-FR/studio-user-guide/8.0-R2024-05/calculating-length-of-string)
* [Exemple de nettoyage d'espaces inutiles](https://help.qlik.com/talend/fr-FR/studio-user-guide/8.0-R2024-05/deleting-blank-characters)