Replace |
Remplace |
| Power Fx |
Syntaxe
|
Replace(String, StartingPosition, NumberOfCharacters, NewString)
|
|
Replace(SingleColumnTable, StartingPosition, NumberOfCharacters, NewString)
|
Paramètres
| Nom |
Description |
| String |
Ce paramètre représente la chaîne de texte dans laquelle une partie doit être remplacée. Il s'agit du texte source où l'opération de remplacement sera effectuée. |
| SingleColumnTable |
Ce paramètre représente une table à une seule colonne dans laquelle une chaîne de texte doit être remplacée. Utilisé lorsque l'on travaille avec des données sous forme de table. |
| StartingPosition |
Ce paramètre spécifie la position de départ dans la chaîne de texte où le remplacement doit commencer. La position est basée sur l'index, avec un départ à 1. |
| NumberOfCharacters |
Ce paramètre indique le nombre de caractères à remplacer à partir de la position spécifiée par StartingPosition. |
| NewString |
Ce paramètre représente la nouvelle chaîne de texte qui remplacera la portion de texte définie par StartingPosition et NumberOfCharacters. |
Description
Cette fonction permet de remplacer une partie d'une chaîne de texte par une autre chaîne.
Remarques
- Utile pour corriger dynamiquement des portions de texte : La fonction Replace permet de modifier précisément un segment d'une chaîne en
spécifiant la position de départ et le nombre de caractères à remplacer. Cela donne un grand contrôle sur la manipulation textuelle, utile notamment pour formater ou
corriger des chaînes issues d'entrées utilisateur.
- La position de départ commence à 1, et non 0 : Il est important de noter que l'indexation commence à 1 dans Power Fx. Cela peut prêter à confusion pour
ceux qui viennent de langages comme JavaScript ou C#, où l'index commence
généralement à 0. Une mauvaise indexation pourrait conduire à un remplacement inattendu.
- Peut être utilisée pour anonymiser ou masquer des données sensibles : Replace peut être employée pour remplacer dynamiquement des parties de texte par
des caractères de masquage (exemple "***") à des positions spécifiques, comme pour cacher un numéro de carte, un mot de passe ou des noms confidentiels dans une
interface utilisateur.
- S'applique aussi à des colonnes de tables en masse : La version avec SingleColumnTable permet de transformer automatiquement une série de chaînes dans
une table en effectuant le remplacement sur chaque ligne. Cela est très pratique pour appliquer des corrections ou des normalisations sur une colonne entière de données
textuelles.
- Ne remplace pas une valeur exacte mais agit sur la base de la position : Contrairement à Substitute, qui remplace une sous-chaîne exacte, Replace
intervient à un emplacement défini. Ce comportement est plus bas niveau, et permet des modifications structurées même lorsque le contenu à remplacer varie d'un cas à
l'autre.
- Combine précision et flexibilité avec la chaîne de remplacement : Le paramètre NewString peut être une chaîne fixe ou une expression dynamique, ce
qui permet par exemple de construire des modifications conditionnelles en fonction du contexte, des rôles utilisateurs ou d'autres valeurs de l'application.
- Attention à ne pas dépasser la longueur de la chaîne d'origine : Si la somme de StartingPosition et NumberOfCharacters dépasse la taille de la chaîne
source, le comportement peut être imprévisible ou entraîner une erreur. Il est donc conseillé de valider ou tronquer les longueurs avant l'appel de la fonction.
- Peut servir à formater des identifiants ou codes personnalisés : Dans des scénarios métiers, Replace permet par exemple de modifier le préfixe ou le
suffixe d'un identifiant, ou d'insérer un indicateur dans un code existant. Cela peut éviter de recréer la chaîne complète manuellement et améliorer la maintenabilité
du code Power Fx.
Dernière mise à jour : Jeudi, le 1 Mai 2025
