Funções Replace e Substitute

Aplica-se a: Colunas Dataverse de fórmula de aplicativos de tela Fluxos de área de trabalho CLI de aplicativos Power Pages Power Platform orientados por modelo

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

Descrição

A função Replace identifica o texto a substituir pela posição inicial e comprimento.

A função Substitute identifica o texto a substituir pela correspondência de uma cadeia. Se for encontrado mais de uma correspondência, pode substituir todas as ou especificar uma para substituir.

Se transmitir uma cadeia única, o valor de retorno será a cadeia modificada. Se transmitir uma tabela de coluna única com cadeias, o valor devolvido será uma tabela de coluna única com uma coluna Valor das cadeias modificadas. Se tiver uma tabela com várias colunas, pode formatá-las para uma tabela com uma única coluna, conforme descrito em trabalhar com tabelas.

Sintaxe

Replace( String,StartingPosition,NumberOfCharacters,NewString )

• string - obrigatório. A cadeia a ser utilizada.
• StartingPosition - Obrigatório. Posição do caráter a iniciar a substituição. O primeiro caráter da Cadeia é na posição 1.
• NumberOfCharacters - Obrigatório. O número de carateres a substituir na Cadeia.
• NewString - Obrigatório. A cadeia de substituição. O número de carateres neste argumento pode diferir do argumento NumberOfCharacters.

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

• string - obrigatório. A cadeia a ser utilizada.
• OldString - Obrigatório. A cadeia a substituir.
• NewString - Obrigatório. A cadeia de substituição. OldString e NewString podem ter comprimentos diferentes.
• InstanceNumber - Opcional. Utilize este argumento para especificar a instância de OldString a substituir se String contiver mais de uma instância. Se não especificar este argumento, todas as instâncias serão substituídas.

Substituir( SingleColumnTable,StartingPosition,NumberOfCharacters,NewString )

• SingleColumnTable - Obrigatório. Uma tabela de coluna única de cadeias onde atuar.
• StartingPosition - Obrigatório. Posição do caráter a iniciar a substituição. O primeiro caráter de cada cadeia na tabela está na posição 1.
• NumberOfCharacters - Obrigatório. O número de carateres a substituir em cada cadeia.
• NewString - Obrigatório. A cadeia de substituição. O número de carateres neste argumento pode diferir do argumento NumberOfCharacters.

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

• SingleColumnTable - Obrigatório. Uma tabela de coluna única de cadeias onde atuar.
• OldString - Obrigatório. A cadeia a substituir.
• NewString - Obrigatório. A cadeia de substituição. OldString e NewString podem ter comprimentos diferentes.
• InstanceNumber - Opcional. Utilize este argumento para especificar a instância de OldString a substituir se String contiver mais de uma instância. Se não especificar este argumento, todas as instâncias serão substituídas.

Exemplos

Fórmula	Descrição	Resultado
Substituir( "abcdefghijk", 6, 5, "*" )	Substitui cinco caracteres em "abcdefghijk" com um único carácter "*", a partir do sexto carácter ("f").	"abcde*k"
Substituir( "2019", 3, 2, "20" )	Substitui os dois últimos caracteres de "2019" por "20".	"2020"
Substituir( "123456", 1, 3, "_" )	Substitui os primeiros três caracteres de "123456" por um único carácter "_".	"_456"
Substituto( "Dados de vendas", "Vendas", "Custo" )	Substitui a cadeia de "Cost" por "Sales".	"Cost Data"
Membro suplente( "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.	"Quarter 2, 2018"
Membro suplente( "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.	"Quarter 1, 2012"
Membro suplente( "Trimestre 1, 2011", "1", "2" )	Substitui todas as instâncias de "1" por "2" porque o quarto argumento (InstanceNumber) não é fornecido.	"Quarter 2, 2022"
Substituir( [ "Trimestre 1, 2018", "Trimestre 2, 2011", "Trimestre 4, 2019" ], 9, 1, "3" )	Substitui o nono carácter em cada registo da tabela de coluna única com "3".	Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: [ "Quarter 3, 2018", "Trimestre 3, 2011", "Trimestre 3, 2019" ]
Membro suplente( ["Tr 1, 2018", "Trimestre 1, 2011", "T1, 2019" ], "1", "3", 1 )	Como o quarto argumento (InstanceNumber) é fornecido com um valor de 1, substitui apenas a primeira instância de "1" em cada registo da tabela de coluna única com "3".	Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: [ "Qtr 3, 2018", "Trimestre 3, 2011", "Q3,2019"]
Membro suplente( ["Tr 1, 2018", "Trimestre 1, 2011", "T1, 2019" ], "1", "3" )	Como o quarto argumento (InstanceNumber) não é fornecido, substitui todas as instância de "1" em cada registo da tabela de coluna única com "3".	Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: [ "Qtr 3, 2038", "Trimestre 3, 2033", "Q3,2039"]