Fonctions sur les chaînes de caractères
Fonctions de manipulation, de recherche et de mise en forme du texte. Vous pouvez les essayer dans l’éditeur d’expressions avec un essai gratuit.
len
(text) Renvoie le nombre de caractères d’une chaîne.
| Paramètres | | text | string | Chaîne à mesurer | |
| Valeurs renvoyées | 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 | |
| Valeurs renvoyées | chaîne |
| Exemples | left("ProcessMind", 7) → Processus |
| 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 | |
| Valeurs renvoyées | chaîne |
| 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 (à partir de 1) | | count | number | Nombre de caractères à extraire | |
| Valeurs renvoyées | chaîne |
| Exemples | mid("ProcessMind", 8, 4) → Mind mid("Hello World", 1, 5) → Bonjour |
| Voir aussi | |
lower
(text) Convertit une chaîne en minuscules.
| Paramètres | | text | string | Chaîne à convertir | |
| Valeurs renvoyées | chaîne |
| Exemples | |
| Voir aussi | |
upper
(text) Convertit une chaîne en majuscules.
| Paramètres | | text | string | Chaîne à convertir | |
| Valeurs renvoyées | chaîne |
| Exemples | |
| Voir aussi | |
proper
(text) Met en majuscule la première lettre de chaque mot d’une chaîne.
| Paramètres | | text | string | Chaîne à convertir | |
| Valeurs renvoyées | chaîne |
| 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 | |
| Valeurs renvoyées | chaîne |
| Exemples | |
| Voir aussi | |
trimStart
(text) Supprime les espaces au début d’une chaîne.
| Paramètres | | text | string | Chaîne à nettoyer | |
| Valeurs renvoyées | chaîne |
| Exemples | trimStart(" hello") → hello |
| Voir aussi | |
trimEnd
(text) Supprime les espaces à la fin d’une chaîne.
| Paramètres | | text | string | Chaîne à nettoyer | |
| Valeurs renvoyées | chaîne |
| 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 | |
| Valeurs renvoyées | chaîne |
| Exemples | replace("Hello World", "World", "ProcessMind") → Hello ProcessMind replace("a-b-c", "-", "_") → a_b_c |
concat
(text1, text2, ...?) Assemble 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 | |
| Valeurs renvoyées | chaîne |
| Exemples | concat("Hello", " ", "World") → Hello World |
| Remarques | Vous pouvez aussi utiliser l’opérateur + pour concaténer des chaînes. |
contains
(text, search) Vérifie si une chaîne en contient une autre.
| Paramètres | | text | string | Chaîne dans laquelle effectuer la recherche | | search | string | Chaîne à rechercher | |
| Valeurs renvoyées | booléen |
| Exemples | contains("ProcessMind", "Mind") → true contains("Hello", "xyz") → false |
| Voir aussi | |
startsWith
(text, prefix) Vérifie si une chaîne commence par le préfixe indiqué.
| Paramètres | | text | string | Chaîne à vérifier | | prefix | string | Préfixe à rechercher | |
| Valeurs renvoyées | booléen |
| Exemples | startsWith("ProcessMind", "Process") → true |
| Voir aussi | |
endsWith
(text, suffix) Vérifie si une chaîne se termine par le suffixe indiqué.
| Paramètres | | text | string | Chaîne à vérifier | | suffix | string | Suffixe à rechercher | |
| Valeurs renvoyées | booléen |
| Exemples | endsWith("ProcessMind", "Mind") → true |
| Voir aussi | |
indexOf
(text, search) Renvoie la position (à partir de 1) de la première occurrence d’une 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 | |
| Valeurs renvoyées | 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 d’une sous-chaîne.
| Paramètres | | search | string | Chaîne à rechercher | | text | string | Chaîne dans laquelle effectuer la recherche | |
| Valeurs renvoyées | 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?) Ajoute des caractères à gauche d’une chaîne pour atteindre la longueur indiquée.
| Paramètres | | text | string | Chaîne à compléter | | length | number | Longueur souhaitée | | char (facultatif) | string | Caractère de remplissage (par défaut: " " (espace)) | |
| Valeurs renvoyées | chaîne |
| Exemples | padLeft("42", 5, "0") → 00042 |
| Voir aussi | |
padRight
(text, length, char?) Ajoute des caractères à droite d’une chaîne pour atteindre la longueur indiquée.
| Paramètres | | text | string | Chaîne à compléter | | length | number | Longueur souhaitée | | char (facultatif) | string | Caractère de remplissage (par défaut: " " (espace)) | |
| Valeurs renvoyées | chaîne |
| Exemples | padRight("Hi", 5, ".") → Hi... |
| Voir aussi | |
Sujets connexes