Funções Replace e Substitute

Aplica-se a: Aplicativos Canvas Dataverse Colunas de fórmula Fluxos de desktop Aplicativos baseados em modelo Power Pages Power Platform CLI

Substitua uma parte de uma cadeia de texto por outra cadeia de caracteres.

Description

A função Replace identifica o texto a ser substituído pela posição inicial e o tamanho.

A função Substitute identifica o texto a ser substituído por uma cadeia de caracteres correspondente. Se mais de uma correspondência for encontrada, você poderá substituir todas elas ou especificar uma para substituir.

Se você passar uma única cadeia de caracteres, o valor de retorno será a cadeia de caracteres modificada. Se você passar uma tabela de coluna única que contenha cadeias de caracteres, o valor de retorno será uma tabela de coluna única com uma coluna Valor de cadeias de caracteres modificadas. 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.

Sintaxe

Substituir( String, StartingPosition, NumberOfCharacters, NewString )

• String - Obrigatório. A cadeia de caracteres com a qual operar.
• StartingPosition - Obrigatório. Posição do caractere na qual iniciar a substituição. O primeiro caractere da Cadeia de caracteres está na posição 1.
• NumberOfCharacters - Obrigatório. O número de caracteres para substituição na Cadeia de caracteres.
• NewString - Obrigatório. A Cadeia de caracteres de substituição. O número de caracteres neste argumento pode diferir do argumento NumberOfCharacters.

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

• String - Obrigatório. A cadeia de caracteres com a qual operar.
• OldString - Obrigatório. A cadeia de caracteres a ser substituída.
• NewString - Obrigatório. A Cadeia de caracteres de substituição. OldString e NewString podem ter comprimentos diferentes.
• InstanceNumber - Opcional. Use este argumento para especificar qual instância de OldString substituir se Cadeia de caracteres contém mais de uma instância. Se você não especificar esse argumento, todas as instâncias serão substituídas.

Substituir( TabelaColunaÚnica, PosiçãoInicial, NúmeroDeCaracteres, NovaString )

• SingleColumnTable - Obrigatório. Uma tabela de coluna única de cadeias de caractere para operação.
• StartingPosition - Obrigatório. Posição do caractere na qual iniciar a substituição. O primeiro caractere de cada cadeia de caracteres na tabela está na posição 1.
• NumberOfCharacters - Obrigatório. O número de caracteres para substituição em cada cadeia de caracteres.
• NewString - Obrigatório. A Cadeia de caracteres de substituição. O número de caracteres neste argumento pode diferir do argumento NumberOfCharacters.

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

• SingleColumnTable - Obrigatório. Uma tabela de coluna única de cadeias de caractere para operação.
• OldString - Obrigatório. A cadeia de caracteres a ser substituída.
• NewString - Obrigatório. A Cadeia de caracteres de substituição. OldString e NewString podem ter comprimentos diferentes.
• InstanceNumber - Opcional. Use este argumento para especificar qual instância de OldString substituir se Cadeia de caracteres contém mais de uma instância. Se você não especificar esse argumento, todas as instâncias serão substituídas.

Exemplos

Fórmula	Descrição	Resultado
Substituir( "abcdefghijk", 6, 5, "*" )	Substitui cinco caracteres em "abcdefghijk" por um único caractere "*", iniciando pelo sexto caractere ("f").	"abcde*k"
Substituir( "2019", 3, 2, "20" )	Substitui os dois últimos caracteres de "2019" por "20".	"2020"
Substituir( "123456", 1, 3, "_" )	Substitui os três primeiros caracteres de "123456" por um único caractere "_".	"_456"
Substitute( "Dados de vendas", "Vendas", "Custo" )	Substitui a cadeia de caracteres "Custo" por "Vendas".	"Dados de custo"
Substitute( "Trimestre 1, 2018", "1", "2", 1 )	Substitui apenas a primeira instância de "1" por "2" porque o quarto argumento (InstanceNumber) é fornecido com um 1.	"2º trimestre, 2018"
Substitute( "Trimestre 1, 2011", "1", "2", 3 )	Substitui apenas a terceira instância de "1" por "2" porque o quarto argumento (InstanceNumber) é fornecido com um 3.	"1º trimestre, 2012"
Substitute( "Trimestre 1, 2011", "1", "2" )	Substitui todas as instâncias de "1" por "2" porque o quarto argumento (InstanceNumber) não é fornecido.	"2º trimestre, 2022"
Substituir( [ "Quarter 1, 2018", "Quarter 2, 2011", "Quarter 4, 2019" ], 9, 1, "3" )	Substitui o nono caractere em cada registro da tabela de coluna única por "3".	Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: [ "Trimestre 3, 2018", "Quarter 3, 2011", "Quarter 3, 2019" ]
Substituir( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3", 1 )	Como o quarto argumento (InstanceNumber) é fornecido com o valor de 1, substitui apenas a primeira instância de "1" em cada registro da tabela de coluna única por "3".	Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: ["Trim 3, 2018", "Quarter 3, 2011", "Q3,2019"]
Substituir( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3" )	Como o quarto argumento (InstanceNumber) não é fornecido, substitui todas as instâncias com "1" em cada registro da tabela de coluna única por "3".	Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: ["Trim 3, 2038", "Quarter 3, 2033", "Q3,2039"]