Fonctions sur les chaînes
Fonctions de manipulation, de recherche et de mise en forme du texte.
len
(text) Renvoie la longueur, c’est-à-dire le nombre de caractères, d’une chaîne.
| Paramètres | | text | string | Chaîne à mesurer | |
| Valeur renvoyée | nombre |
| Exemples | |
left
(text, count) Renvoie les N premiers caractères d’une chaîne.
| Paramètres | | text | string | Chaîne source | | count | number | Nombre de caractères à extraire | |
| Valeur renvoyée | string |
| Exemples | left("ProcessMind", 7) → Process |
| Voir aussi | |
right
(text, count) Renvoie les N derniers caractères d’une chaîne.
| Paramètres | | text | string | Chaîne source | | count | number | Nombre de caractères à extraire | |
| Valeur renvoyée | string |
| Exemples | right("ProcessMind", 4) → Mind |
| Voir aussi | |
mid
(text, start, count) Renvoie une sous-chaîne extraite du milieu d’une chaîne, à partir d’une position commençant à 1, sur le nombre de caractères indiqué.
| Paramètres | | text | string | Chaîne source | | start | number | Position de départ (base 1) | | count | number | Nombre de caractères à extraire | |
| Valeur renvoyée | string |
| Exemples | mid("ProcessMind", 8, 4) → Mind mid("Hello World", 1, 5) → Hello |
| Voir aussi | |
lower
(text) Convertit une chaîne en minuscules.
| Paramètres | | text | string | Chaîne à convertir | |
| Valeur renvoyée | string |
| Exemples | |
| Voir aussi | |
upper
(text) Convertit une chaîne en majuscules.
| Paramètres | | text | string | Chaîne à convertir | |
| Valeur renvoyée | string |
| Exemples | |
| Voir aussi | |
proper
(text) Convertit une chaîne en casse titre en mettant la première lettre de chaque mot en majuscule.
| Paramètres | | text | string | Chaîne à convertir | |
| Valeur renvoyée | string |
| Exemples | proper("hello world") → Hello World proper("HELLO WORLD") → Hello World |
| Voir aussi | |
trim
(text) Supprime les espaces au début et à la fin d’une chaîne.
| Paramètres | | text | string | Chaîne à nettoyer | |
| Valeur renvoyée | string |
| Exemples | |
| Voir aussi | |
trimStart
(text) Supprime les espaces au début d’une chaîne.
| Paramètres | | text | string | Chaîne à nettoyer | |
| Valeur renvoyée | string |
| Exemples | trimStart(" hello") → hello |
| Voir aussi | |
trimEnd
(text) Supprime les espaces à la fin d’une chaîne.
| Paramètres | | text | string | Chaîne à nettoyer | |
| Valeur renvoyée | string |
| Exemples | trimEnd("hello ") → hello |
| Voir aussi | |
replace
(text, search, replacement) Remplace chaque occurrence d’une chaîne recherchée par une chaîne de remplacement.
| Paramètres | | text | string | Chaîne source | | search | string | Chaîne à rechercher | | replacement | string | Chaîne de remplacement | |
| Valeur renvoyée | string |
| Exemples | replace("Hello World", "World", "ProcessMind") → Hello ProcessMind replace("a-b-c", "-", "_") → a_b_c |
concat
(text1, text2, ...?) Concatène deux chaînes ou plus.
| Paramètres | | text1 | string | Première chaîne | | text2 | string | Deuxième chaîne | | ... (facultatif) | string | Chaînes supplémentaires, jusqu’à 6 au total | |
| Valeur renvoyée | string |
| Exemples | concat("Hello", " ", "World") → Hello World |
| Remarques | Vous pouvez également utiliser l’opérateur + pour concaténer des chaînes. |
contains
(text, search) Vérifie si une chaîne contient une autre chaîne.
| Paramètres | | text | string | Chaîne dans laquelle effectuer la recherche | | search | string | Chaîne à rechercher | |
| Valeur renvoyée | booléen |
| Exemples | contains("ProcessMind", "Mind") → true contains("Hello", "xyz") → false |
| Voir aussi | |
startsWith
(text, prefix) Vérifie si une chaîne commence par un préfixe donné.
| Paramètres | | text | string | Chaîne à vérifier | | prefix | string | Préfixe à rechercher | |
| Valeur renvoyée | booléen |
| Exemples | startsWith("ProcessMind", "Process") → true |
| Voir aussi | |
endsWith
(text, suffix) Vérifie si une chaîne se termine par un suffixe donné.
| Paramètres | | text | string | Chaîne à vérifier | | suffix | string | Suffixe à rechercher | |
| Valeur renvoyée | booléen |
| Exemples | endsWith("ProcessMind", "Mind") → true |
| Voir aussi | |
indexOf
(text, search) Renvoie la position, à partir de 1, de la première occurrence de la sous-chaîne, ou 0 si elle est introuvable.
| Paramètres | | text | string | Chaîne dans laquelle effectuer la recherche | | search | string | Chaîne à rechercher | |
| Valeur renvoyée | nombre |
| Exemples | indexOf("ProcessMind", "Mind") → 8 indexOf("Hello", "xyz") → 0 |
| Voir aussi | |
find
(search, text) Alias de indexOf. Renvoie la position, à partir de 1, de la première occurrence de la sous-chaîne.
| Paramètres | | search | string | Chaîne à rechercher | | text | string | Chaîne dans laquelle effectuer la recherche | |
| Valeur renvoyée | nombre |
| Exemples | find("Mind", "ProcessMind") → 8 |
| Remarques | Notez que l’ordre des paramètres est inversé par rapport à indexOf. |
| Voir aussi | |
padLeft
(text, length, char?) Complète une chaîne à gauche jusqu’à atteindre une longueur donnée.
| Paramètres | | text | string | Chaîne à compléter | | length | number | Longueur cible | | char (facultatif) | string | Caractère à utiliser pour le remplissage (par défaut: " " (espace)) | |
| Valeur renvoyée | string |
| Exemples | padLeft("42", 5, "0") → 00042 |
| Voir aussi | |
padRight
(text, length, char?) Complète une chaîne à droite jusqu’à atteindre une longueur donnée.
| Paramètres | | text | string | Chaîne à compléter | | length | number | Longueur cible | | char (facultatif) | string | Caractère à utiliser pour le remplissage (par défaut: " " (espace)) | |
| Valeur renvoyée | string |
| Exemples | padRight("Hi", 5, ".") → Hi... |
| Voir aussi | |
Sujets associés