Substitute |
Substitution |
| Power Fx |
Syntaxe
|
Substitute( String, OldString, NewString [, InstanceNumber ] )
|
|
Substitute( SingleColumnTable, OldString, NewString [, InstanceNumber ] )
|
Paramètres
| Nom |
Description |
| String |
Ce paramètre représente la chaîne de texte dans laquelle vous souhaitez effectuer la substitution. |
| OldString |
Ce paramètre représente la sous-chaîne de texte que vous souhaitez remplacer dans la chaîne String. |
| NewString |
Ce paramètre représente la sous-chaîne de texte qui remplacera OldString dans la chaîne String. |
| InstanceNumber |
Ce paramètre est optionnel. Il représente le numéro d'occurrence spécifique de OldString à remplacer. Si omis, toutes les occurrences de OldString dans String seront remplacées. |
| SingleColumnTable |
Ce paramètre est une table à une seule colonne contenant des chaînes de texte dans lesquelles des remplacements seront effectués. |
Description
Cette fonction permet de remplacer une partie d'une chaîne de texte par une autre chaîne de caractères.
Remarques
- Utile pour la modification dynamique de chaînes de texte : La fonction Substitute est très pratique pour ajuster ou nettoyer dynamiquement des
chaînes de caractères. Elle permet, par exemple, de modifier des séparateurs, des mots-clefs, ou des formats sans modifier manuellement chaque valeur d'entrée.
- Remplace toutes les occurrences par défaut : Lorsque le paramètre InstanceNumber est omis, toutes les occurrences de OldString sont remplacées par
NewString. Cela permet d'effectuer des substitutions globales en une seule opération, ce qui est particulièrement utile pour les nettoyages de masse.
- Permet un contrôle précis avec InstanceNumber : En spécifiant le paramètre InstanceNumber, on peut choisir exactement quelle occurrence de OldString
sera remplacée. Cela donne une précision très utile lorsqu'il ne faut modifier qu'un seul élément dans une chaîne contenant des répétitions.
- Peut être appliquée à une table entière : Avec une SingleColumnTable, la fonction Substitute peut effectuer des remplacements sur chaque ligne
de la table. Cette fonctionnalité permet de nettoyer ou d'uniformiser en masse des données textuelles issues d'une collection ou d'une source externe.
- Très utile dans les traitements d'importation ou d'exportation : Lorsqu'on importe des données d'une source externe
(CSV, texte brut,...), les formats peuvent varier. Substitute permet de remplacer les caractères indésirables (comme des
tabulations, retours à la ligne ou symboles spécifiques) avant un traitement ultérieur.
- La recherche de correspondance est sensible à la casse : La fonction est sensible à la casse, c'est-à-dire qu'elle distingue les majuscules des
minuscules. Par exemple, Substitute("Texte", "texte", "mot") ne produira aucun changement. Il faut donc tenir compte de cette sensibilité lors de la substitution.
- Peut être utilisée pour construire des expressions plus complexes : Substitute peut être combinée avec d'autres fonctions de texte comme
Left, Right, Mid, ou Len pour créer des formules complexes de transformation
de texte. Elle s'intègre parfaitement dans des scénarios de traitement conditionnel ou de formatage.
- Recommandée pour la normalisation de valeurs utilisateur : Dans des champs de saisie utilisateur où les données peuvent contenir des variations non
souhaitées, Substitute permet d'uniformiser l'information (par exemple, remplacer tous les points par des virgules dans des valeurs numériques saisies sous
forme de texte).
Dernière mise à jour : Jeudi, le 1 Mai 2025