Fonctions Replace et Substitute
S'applique à :
Applications Canvas Colonnes de formule Dataverse Flux de bureau Applications pilotées par modèle CLI Power Platform
Remplacent une partie d’une chaîne de texte par une autre chaîne.
Description
La fonction Replace identifie le texte à remplacer selon la position de départ et la longueur.
La fonction Substitute identifie le texte à remplacer par correspondance avec une chaîne. Si plusieurs correspondances sont trouvées, vous pouvez toutes les remplacer ou en spécifier une à remplacer.
Si vous transmettez une chaîne unique, la valeur renvoyée est la chaîne modifiée. Si vous transmettez une table à une seule colonne contenant des chaînes, la valeur renvoyée est une table à une seule colonne avec une colonne Valeur des chaînes modifiées. Si vous avez une table à plusieurs colonnes, vous pouvez la convertir en table à une seule colonne, comme Utilisation des tables le décrit.
Syntaxe
Replace( String, StartingPosition, NumberOfCharacters, NewString )
- String : obligatoire. La chaîne à utiliser.
- StartingPosition : obligatoire. Position de caractère à laquelle démarrer le remplacement. Le premier caractère de la chaîne (String) correspond à la position 1.
- NumberOfCharacters : obligatoire. Le nombre de caractères à remplacer dans la chaîne (String).
- NewString : obligatoire. La chaîne de remplacement. Le nombre de caractères dans cet argument peut être différent de l’argument NumberOfCharacters.
Substitute( String, OldString, NewString [, InstanceNumber ] )
- String : obligatoire. La chaîne à utiliser.
- OldString : obligatoire. La chaîne à remplacer.
- NewString : obligatoire. La chaîne de remplacement. OldString et NewString peuvent avoir des longueurs différentes.
- InstanceNumber : facultatif. Utilisez cet argument pour spécifier quelle instance de OldString remplacer si Chaîne contient plusieurs instances. Si vous ne spécifiez pas cet argument, toutes les instances seront remplacées.
Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )
- SingleColumnTable : obligatoire. Une table à une seule colonne contenant les chaînes à utiliser.
- StartingPosition : obligatoire. Position de caractère à laquelle démarrer le remplacement. Le premier caractère de chaque chaîne de la table est à la position 1.
- NumberOfCharacters : obligatoire. Le nombre de caractères à remplacer dans chaque chaîne.
- NewString : obligatoire. La chaîne de remplacement. Le nombre de caractères dans cet argument peut être différent de l’argument NumberOfCharacters.
Substitute( SingleColumnTable, OldString, NewString [, InstanceNumber ] )
- SingleColumnTable : obligatoire. Une table à une seule colonne contenant les chaînes à utiliser.
- OldString : obligatoire. La chaîne à remplacer.
- NewString : obligatoire. La chaîne de remplacement. OldString et NewString peuvent avoir des longueurs différentes.
- InstanceNumber : facultatif. Utilisez cet argument pour spécifier quelle instance de OldString remplacer si Chaîne contient plusieurs instances. Si vous ne spécifiez pas cet argument, toutes les instances seront remplacées.
Exemples
| Formule | Description | Résultat |
|---|---|---|
| Replace( "abcdefghijk", 6, 5, "*" ) | Remplace cinq caractères dans "abcdefghijk" par un seul caractère "*", en commençant par le sixième caractère ("f"). | "abcde*k" |
| Replace( "2019", 3, 2, "20" ) | Remplace les deux derniers caractères de "2019" par "20". | "2020" |
| Replace( "123456", 1, 3, "_" ) | Remplace les trois premiers caractères de "123456" par un seul caractère "_". | "_456" |
| Substitute( "Sales Data", "Sales", "Cost" ) | Remplace la chaîne "Coût" par "Ventes". | "Cost Data" |
| Substitute( "Quarter 1, 2018", "1", "2", 1 ) | Remplace uniquement la première instance de "1" par "2" car le quatrième argument (InstanceNumber) est fourni avec un 1. | "Quarter 2, 2018" |
| Substitute( "Quarter 1, 2011", "1", "2", 3 ) | Remplace uniquement la troisième instance de "1" par "2" car le quatrième argument (InstanceNumber) est fourni avec un 3. | "Quarter 1, 2012" |
| Substitute( "Quarter 1, 2011", "1", "2" ) | Remplace uniquement toutes les instance de "1" par "2" car le quatrième argument (InstanceNumber) n’est pas fourni. | "Quarter 2, 2022" |
| Replace( [ "Quarter 1, 2018", "Quarter 2, 2011", "Quarter 4, 2019" ], 9, 1, "3" ) |
Remplace le neuvième caractère de chaque enregistrement du tableau à une colonne par "3". | Table à une seule colonne avec une colonne Value contenant les valeurs suivantes : [ "Trimestre 3, 2018","Quarter 3, 2011", "Quarter 3, 2019" ] |
| Substitute( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3", 1 ) |
Parce que le quatrième argument (InstanceNumber) est fourni avec une valeur de 1, remplace uniquement la première instance de "1" dans chaque enregistrement de la table à une colonne par "3". | Table à une seule colonne avec une colonne Value contenant les valeurs suivantes : [ "Trimestre 3, 2018","Quarter 3, 2011", "Q3,2019"] |
| Substitute( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3" ) |
Parce que le quatrième argument (InstanceNumber) n’est pas fourni, remplace toutes les instances de "1" dans chaque enregistrement de la table à une colonne par "3". | Table à une seule colonne avec une colonne Value contenant les valeurs suivantes : [ "Trimestre 3, 2038","Quarter 3, 2033", "Q3,2039"] |