diff --git a/scripts/docs/fr/070.fields/040.field-types/060.formula/fr-030.string-functions.md b/scripts/docs/fr/070.fields/040.field-types/060.formula/fr-030.string-functions.md index e69de29bb2..ffc4d7401e 100644 --- a/scripts/docs/fr/070.fields/040.field-types/060.formula/fr-030.string-functions.md +++ b/scripts/docs/fr/070.fields/040.field-types/060.formula/fr-030.string-functions.md @@ -0,0 +1,272 @@ +*** + +titre : 'Fonctions de chaîne' +description: 'Cet article explique diverses fonctions de chaîne pouvant être utilisées dans les champs de formule.' +balises : \['Champs', 'Types de champs', 'Formule'] +mots-clés : \['Champs', 'Types de champs', 'Formule', 'Créer un champ de formule', 'Fonctions de chaîne'] +--------------------------------------------------------------------------------------------------------- + +Cette aide-mémoire fournit un guide de référence rapide pour diverses fonctions basées sur des chaînes couramment utilisées dans l'analyse et la programmation de données. Chaque fonction est accompagnée de sa syntaxe, d'un exemple d'utilisation et d'une brève description. + +## CONCAT + +La fonction CONCAT concatène une ou plusieurs chaînes en une seule chaîne. + +#### Syntaxe + +```plaintext +CONCAT(text, [text,...]) +``` + +#### Sample + +```plaintext +CONCAT('John', ' ', 'Doe') => 'John Doe' +``` + +## GAUCHE + +La fonction LEFT récupère les premiers « n » caractères spécifiés depuis le début de la chaîne d’entrée. + +#### Syntaxe + +```plaintext +LEFT(text, count) +``` + +#### Échantillon + +```plaintext +LEFT('123-456-7890', 3) => '123' +``` + +## JUSTE + +La fonction LEN calcule et renvoie le nombre total de caractères présents dans la chaîne fournie. + +#### Syntaxe + +```plaintext +LEN(text) +``` + +#### Échantillon + +```plaintext +LEN('Product Description') => 19 +``` + +## INFÉRIEUR + +La fonction LOWER transforme tous les caractères de la chaîne d'entrée en minuscules + +#### Syntaxe + +```plaintext +LOWER(text) +``` + +#### Échantillon + +```plaintext +LOWER('User INPUT') => 'user input' +``` + +## MILIEU + +La fonction MID récupère une sous-chaîne de la chaîne d'entrée en commençant à la position spécifiée et en s'étendant sur le nombre de caractères spécifié. + +#### Syntaxe + +```plaintext +MID(text, position, [count]) +``` + +#### Échantillon + +```plaintext +MID('This is a sentence', 5, 3) => 'is ' +``` + +## REGEX\_EXTRACT + +La fonction REGEX\_EXTRACT recherche dans la chaîne d'entrée la première occurrence du modèle d'expression régulière spécifié et renvoie la sous-chaîne correspondante. + +#### Syntaxe + +```plaintext +REGEX_EXTRACT(text, pattern) +``` + +#### Échantillon + +```plaintext +REGEX_EXTRACT('Error: Something went wrong', 'Error: (.*)') => 'Something went wrong' +``` + +## REGEX\_MATCH + +La fonction REGEX\_MATCH évalue si la chaîne d'entrée correspond au modèle d'expression régulière spécifié, renvoyant 1 s'il y a une correspondance et 0 s'il n'y a pas de correspondance. + +#### Syntax + +```plaintext +REGEX_MATCH(text, pattern) +``` + +#### Échantillon + +```plaintext +REGEX_MATCH('123-45-6789', '\d{3}-\d{2}-\d{4}') => 1 +``` + +## REGEX\_REPLACE + +La fonction REGEX\_REPLACE identifie toutes les occurrences du modèle d'expression régulière spécifié dans la chaîne d'entrée et les remplace par la chaîne de remplacement fournie. + +#### Syntaxe + +```plaintext +REGEX_REPLACE(text, pattern, replacer) +``` + +#### Échantillon + +```plaintext +REGEX_REPLACE('Replace all bugs', 'bug', 'feature') => 'Replace all features' +``` + +## REPEAT + +La fonction REPEAT duplique la chaîne fournie le nombre de fois spécifié, facilitant la création de modèles ou de séquences répétés. + +#### Syntaxe + +```plaintext +REPEAT(text, count) +``` + +#### Échantillon + +```plaintext +REPEAT('😃', 3) => '😃😃😃' +``` + +## REMPLACER + +La fonction REPLACE identifie toutes les instances d'une sous-chaîne particulière dans la chaîne donnée et les remplace par une autre sous-chaîne spécifiée. + +#### Syntaxe + +```plaintext +REPLACE(text, srchStr, rplcStr) +``` + +#### Échantillon + +```plaintext +REPLACE('Replace old text', 'old', 'new') => 'Replace new text' +``` + +## DROITE + +La fonction RIGHT récupère les n derniers caractères de la fin de la chaîne d'entrée, vous permettant d'extraire une sous-chaîne en commençant par la droite. + +#### Syntaxe + +```plaintext +RIGHT(text, n) +``` + +#### Échantillon + +```plaintext +RIGHT('file_name.txt', 3) => 'txt' +``` + +## RECHERCHE + +La fonction SEARCH identifie la position de la sous-chaîne spécifiée dans la chaîne d'entrée, renvoyant l'index si elle est trouvée, et 0 sinon. + +#### Syntaxe + +```plaintext +SEARCH(text, srchStr) +``` + +#### Échantillon + +```plaintext +SEARCH('user@example.com', '@') => 5 +``` + +## SUBSTR + +La fonction SUBSTR extrait une sous-chaîne de la chaîne d'entrée, en commençant à la position spécifiée et en s'étendant éventuellement pour le nombre de caractères spécifié. + +#### Syntaxe + +```plaintext +SUBSTR(text, position, [count]) +``` + +#### Échantillon + +```plaintext +SUBSTR('Extract this text', 9, 4) => 'this' +``` + +## GARNITURE + +La fonction TRIM élimine tous les espaces de début ou de fin de la chaîne d'entrée. + +#### Syntaxe + +```plaintext +TRIM(text) +``` + +#### Échantillon + +```plaintext +TRIM(' Trim this ') => 'Trim this' +``` + +## SUPÉRIEUR + +La fonction UPPER transforme tous les caractères de la chaîne d'entrée en majuscules. + +#### Syntaxe + +```plaintext +UPPER(text) +``` + +#### Échantillon + +```plaintext +UPPER('title') => 'TITLE' +``` + +## URL + +La fonction URL vérifie si la chaîne d'entrée est une URL valide et la convertit en lien hypertexte + +#### Syntaxe + +```plaintext +URL(text) +``` + +#### Échantillon + +```plaintext +URL('https://www.example.com') => a clickable link for https://www.example.com +``` + +## Articles Liés + +* [Opérateurs numériques et logiques](015.operators.md) +* [Fonctions numériques](020.numeric-functions.md) +* [Fonctions de dates](040.date-functions.md) +* [Expressions conditionnelles](050.conditional-expressions.md)