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

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

DescriçãoDescription

A função Replace identifica o texto a substituir pela posição inicial e comprimento.The Replace function identifies the text to replace by starting position and length.

A função Substitute identifica o texto a substituir pela correspondência de uma cadeia.The Substitute function identifies the text to replace by matching a string. Se for encontrada mais do que uma correspondência, poderá controlar a substituição.If more than one match is found, you can control which one is replaced.

Se transmitir uma cadeia única, o valor de retorno será a cadeia modificada.If you pass a single string, the return value is the modified string. Se transmitir uma tabela de coluna única com cadeias, o valor devolvido será uma tabela de coluna única composta por cadeias modificadas.If you pass a single-column table that contains strings, the return value is a single-column table of modified strings. Se tiver uma tabela com várias colunas, pode formatá-las para uma tabela com uma única coluna, conforme descrito em trabalhar 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, StartingPosition, NumberOfCharacters, NewString )Replace( String, StartingPosition, NumberOfCharacters, NewString )

  • Cadeia – necessário.String - Required. A cadeia a ser utilizada.The string to operate on.
  • StartingPosition – Necessário.StartingPosition - Required. Posição do caráter a iniciar a substituição.Character position to start the replacement. O primeiro caráter da Cadeia é na posição 1.The first character of String is at position 1.
  • NumberOfCharacters – Necessário.NumberOfCharacters - Required. O número de carateres a substituir na Cadeia.The number of characters to replace in String.
  • NewString – Necessário.NewString - Required. A cadeia de substituição.The replacement string. O número de carateres neste argumento pode diferir do argumento NumberOfCharacters.The number of characters in this argument can differ from the NumberOfCharacters argument.

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

  • Cadeia – necessário.String - Required. A cadeia a ser utilizada.The string to operate on.
  • OldString – Necessário.OldString - Required. A cadeia a substituir.The string to replace.
  • NewString – Necessário.NewString - Required. A cadeia de substituição.The replacement string. OldString e NewString podem ter comprimentos diferentes.OldString and NewString can have different lengths.
  • InstanceNumber – Opcional.InstanceNumber - Optional. Por predefinição, é substituída a primeira instância de OldString.By default, the first instance of OldString is replaced. Se a Cadeia contiver mais do que uma instância, poderá especificar a instância a substituir.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 - Necessário.SingleColumnTable - Required. Uma tabela de cadeias de coluna única a trabalhar.A single-column table of strings to operate on.
  • StartingPosition – Necessário.StartingPosition - Required. Posição do caráter a iniciar a substituição.Character position to start the replacement. O primeiro caráter de cada cadeia na tabela está na posição 1.The first character of each string in the table is at position 1.
  • NumberOfCharacters – Necessário.NumberOfCharacters - Required. O número de carateres a substituir em cada cadeia.The number of characters to replace in each string.
  • NewString – Necessário.NewString - Required. A cadeia de substituição.The replacement string. O número de carateres neste argumento pode diferir do argumento 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 - Necessário.SingleColumnTable - Required. Uma tabela de cadeias de coluna única a trabalhar.A single-column table of strings to operate on.
  • OldString – Necessário.OldString - Required. A cadeia a substituir.The string to replace.
  • NewString – Necessário.NewString - Required. A cadeia de substituição.The replacement string. OldString e NewString podem ter comprimentos diferentes.OldString and NewString can have different lengths.
  • InstanceNumber – Opcional.InstanceNumber - Optional. Por predefinição, é substituída a primeira instância de OldString.By default, the first instance of OldString is replaced. Se a tabela contiver mais do que uma instância, poderá especificar a instância a substituir.If the table contains more than one instance, you can specify which instance to replace.