Funções Replace e Substitute no Microsoft PowerAppsReplace and Substitute functions in PowerApps

Substitua uma parte de uma cadeia de texto por outra cadeia de caracteres.Replace a portion of a string of text with another string.

DescriçãoDescription

A função Replace identifica o texto a ser substituído pela posição inicial e o tamanho.The Replace function identifies the text to replace by starting position and length.

A função Substitute identifica o texto a ser substituído por uma cadeia de caracteres correspondente.The Substitute function identifies the text to replace by matching a string. Se mais de uma correspondência for encontrada, você poderá controlar qual delas será substituída.If more than one match is found, you can control which one is replaced.

Se você passar uma única cadeia de caracteres, o valor de retorno será a cadeia de caracteres modificada.If you pass a single string, the return value is the modified string. Se você passar uma tabela de coluna única que contenha cadeias de caracteres, o valor de retorno será uma tabela de coluna única com cadeias de caracteres modificadas.If you pass a single-column table that contains strings, the return value is a single-column table of modified strings. Se você tiver uma tabela de várias colunas, é possível formatá-la como uma tabela de coluna única, como descrito em Trabalhando com tabelas.If you have a multi-column table, you can shape it into a single-column table, as working with tables describes.

SintaxeSyntax

Replace( Cadeia de caracteres, PosiçãoInicial, NúmeroDeCaracteres, NovaCadeiaDeCaracteres )Replace( String, StartingPosition, NumberOfCharacters, NewString )

  • String - obrigatório.String - Required. A cadeia de caracteres com a qual operar.The string to operate on.
  • PosiçãoInicial - Obrigatório.StartingPosition - Required. Posição do caractere na qual iniciar a substituição.Character position to start the replacement. O primeiro caractere da Cadeia de caracteres está na posição 1.The first character of String is at position 1.
  • NumberOfCharacters - obrigatório.NumberOfCharacters - Required. O número de caracteres para substituição na Cadeia de caracteres.The number of characters to replace in String.
  • NovaCadeiaDeCaracteres - obrigatório.NewString - Required. A Cadeia de caracteres de substituição.The replacement string. O número de caracteres neste argumento pode diferir do argumento NúmeroDeCaracteres.The number of characters in this argument can differ from the NumberOfCharacters argument.

Substitute( Cadeia de caracteres, CadeiaDeCaracteresAntiga, NovaCadeiaDeCaracteres [, NúmeroDaInstância ] )Substitute( String, OldString, NewString [, InstanceNumber ] )

  • String - obrigatório.String - Required. A cadeia de caracteres com a qual operar.The string to operate on.
  • CadeiaDeCaracteresAntiga - obrigatório.OldString - Required. A cadeia de caracteres a ser substituída.The string to replace.
  • NovaCadeiaDeCaracteres - obrigatório.NewString - Required. A Cadeia de caracteres de substituição.The replacement string. CadeiaDeCaracteresAntiga e NovaCadeiaDeCaracteres podem ter tamanhos diferentes.OldString and NewString can have different lengths.
  • NúmeroDaInstância - opcional.InstanceNumber - Optional. Por padrão, a primeira instância da CadeiaDeCaracteresAntiga é substituída.By default, the first instance of OldString is replaced. Se Cadeia de caracteres contiver mais de uma instância, você poderá especificar qual instância substituir.If String contains more than one instance, you can specify which instance to replace.

Replace( TabelaDeColunaÚnica, PosiçãoInicial, NúmeroDeCaracteres, NovaCadeiaDeCaracteres )Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )

  • SingleColumnTable – Obrigatório.SingleColumnTable - Required. Uma tabela de coluna única de cadeias de caractere para operação.A single-column table of strings to operate on.
  • PosiçãoInicial - Obrigatório.StartingPosition - Required. Posição do caractere na qual iniciar a substituição.Character position to start the replacement. O primeiro caractere de cada cadeia de caracteres na tabela está na posição 1.The first character of each string in the table is at position 1.
  • NumberOfCharacters - obrigatório.NumberOfCharacters - Required. O número de caracteres para substituição em cada cadeia de caracteres.The number of characters to replace in each string.
  • NovaCadeiaDeCaracteres - obrigatório.NewString - Required. A Cadeia de caracteres de substituição.The replacement string. O número de caracteres neste argumento pode diferir do argumento NúmeroDeCaracteres.The number of characters in this argument can differ from the NumberOfCharacters argument.

Substitute( TabelaDeColunaÚnica, CadeiaDeCaracteresAntiga, NovaCadeiaDeCaracteres [, NúmeroDaInstância ] )Substitute( SingleColumnTable, OldString, NewString [, InstanceNumber ] )

  • SingleColumnTable – Obrigatório.SingleColumnTable - Required. Uma tabela de coluna única de cadeias de caractere para operação.A single-column table of strings to operate on.
  • CadeiaDeCaracteresAntiga - obrigatório.OldString - Required. A cadeia de caracteres a ser substituída.The string to replace.
  • NovaCadeiaDeCaracteres - obrigatório.NewString - Required. A Cadeia de caracteres de substituição.The replacement string. CadeiaDeCaracteresAntiga e NovaCadeiaDeCaracteres podem ter tamanhos diferentes.OldString and NewString can have different lengths.
  • NúmeroDaInstância - opcional.InstanceNumber - Optional. Por padrão, a primeira instância da CadeiaDeCaracteresAntiga é substituída.By default, the first instance of OldString is replaced. Se a tabela contiver mais de uma instância, você poderá especificar qual instância substituir.If the table contains more than one instance, you can specify which instance to replace.