Fonctions Replace et Substitute dans PowerAppsReplace and Substitute functions in PowerApps

Remplacent une partie d’une chaîne de texte par une autre chaîne.Replace a portion of a string of text with another string.

DescriptionDescription

La fonction Replace identifie le texte à remplacer selon la position de départ et la longueur.The Replace function identifies the text to replace by starting position and length.

La fonction Substitute identifie le texte à remplacer par correspondance avec une chaîne.The Substitute function identifies the text to replace by matching a string. Si plusieurs correspondances sont trouvées, vous pouvez définir celle qui doit être remplacée.If more than one match is found, you can control which one is replaced.

Si vous transmettez une chaîne unique, la valeur renvoyée est la chaîne modifiée.If you pass a single string, the return value is the modified string. Si vous transmettez une table à une seule colonne contenant des chaînes, la valeur renvoyée est une table à une seule colonne contenant les chaînes modifiées.If you pass a single-column table that contains strings, the return value is a single-column table of modified strings. Si vous avez une table à plusieurs colonnes, vous pouvez la convertir en table à une seule colonne (voir Utilisation des tables).If you have a multi-column table, you can shape it into a single-column table, as working with tables describes.

SyntaxeSyntax

Replace( String, StartingPosition, NumberOfCharacters, NewString )Replace( String, StartingPosition, NumberOfCharacters, NewString )

  • String - Requis.String - Required. La chaîne à utiliser.The string to operate on.
  • StartingPosition - Requis.StartingPosition - Required. Position de caractère à laquelle démarrer le remplacement.Character position to start the replacement. Le premier caractère de la chaîne (String) correspond à la position 1.The first character of String is at position 1.
  • NumberOfCharacters - Requis.NumberOfCharacters - Required. Le nombre de caractères à remplacer dans la chaîne (String).The number of characters to replace in String.
  • NewString - Requis.NewString - Required. La chaîne de remplacement.The replacement string. Le nombre de caractères dans cet argument peut être différent de l’argument NumberOfCharacters.The number of characters in this argument can differ from the NumberOfCharacters argument.

Substitute( String, OldString, NewString [, InstanceNumber ] )Substitute( String, OldString, NewString [, InstanceNumber ] )

  • String - Requis.String - Required. La chaîne à utiliser.The string to operate on.
  • OldString - Requis.OldString - Required. La chaîne à remplacer.The string to replace.
  • NewString - Requis.NewString - Required. La chaîne de remplacement.The replacement string. OldString et NewString peuvent avoir des longueurs différentes.OldString and NewString can have different lengths.
  • InstanceNumber - Facultatif.InstanceNumber - Optional. Par défaut, la première instance de OldString est remplacée.By default, the first instance of OldString is replaced. Si la chaîne (String) contient plusieurs instances, vous pouvez spécifier l’instance à remplacer.If String contains more than one instance, you can specify which instance to replace.

Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )

  • SingleColumnTable - Requis.SingleColumnTable - Required. Une table à une seule colonne contenant les chaînes à utiliser.A single-column table of strings to operate on.
  • StartingPosition - Requis.StartingPosition - Required. Position de caractère à laquelle démarrer le remplacement.Character position to start the replacement. Le premier caractère de chaque chaîne de la table est à la position 1.The first character of each string in the table is at position 1.
  • NumberOfCharacters - Requis.NumberOfCharacters - Required. Le nombre de caractères à remplacer dans chaque chaîne.The number of characters to replace in each string.
  • NewString - Requis.NewString - Required. La chaîne de remplacement.The replacement string. Le nombre de caractères dans cet argument peut être différent de l’argument NumberOfCharacters.The number of characters in this argument can differ from the NumberOfCharacters argument.

Substitute( SingleColumnTable, OldString, NewString [, InstanceNumber ] )Substitute( SingleColumnTable, OldString, NewString [, InstanceNumber ] )

  • SingleColumnTable - Requis.SingleColumnTable - Required. Une table à une seule colonne contenant les chaînes à utiliser.A single-column table of strings to operate on.
  • OldString - Requis.OldString - Required. La chaîne à remplacer.The string to replace.
  • NewString - Requis.NewString - Required. La chaîne de remplacement.The replacement string. OldString et NewString peuvent avoir des longueurs différentes.OldString and NewString can have different lengths.
  • InstanceNumber - Facultatif.InstanceNumber - Optional. Par défaut, la première instance de OldString est remplacée.By default, the first instance of OldString is replaced. Si la table contient plusieurs instances, vous pouvez spécifier l’instance à remplacer.If the table contains more than one instance, you can specify which instance to replace.