Funções Replace e Substitute no Power Apps

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 composta por 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 )

• Cadeia – 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.

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

• Cadeia – 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.

Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )

• TabelaComUmaÚnicaColuna – 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.

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

• TabelaComUmaÚnicaColuna – 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
Replace( "abcdefghijk", 6, 5, "*" )	Substitui cinco caracteres em "abcdefghijk" com um único carácter "*", a partir do sexto carácter ("f").	"abcde*k"
Replace( "2019", 3, 2, "20" )	Substitui os dois últimos caracteres de "2019" por "20".	"2020"
Replace( "123456", 1, 3, "_" )	Substitui os primeiros três caracteres de "123456" por um único carácter "_".	"_456"
Substitute( "Sales Data", "Sales", "Cost" )	Substitui a cadeia de "Cost" por "Sales".	"Cost Data"
Substitute( "Quarter 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"
Substitute( "Quarter 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"
Substitute( "Quarter 1, 2011", "1", "2" )	Substitui todas as instâncias de "1" por "2" porque o quarto argumento (InstanceNumber) não é fornecido.	"Quarter 2, 2022"
Replace( [ "Quarter 1, 2018", "Quarter 2, 2011", "Quarter 4, 2019" ], 9, 1, "3" )	Substitui o nono carácter em cada registo da tabela de coluna única com "3".	[ "Quarter 3, 2018", "Quarter 3, 2011", "Quarter 3, 2019" ]
Substitute( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 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".	[ "Qtr 3, 2018", "Quarter 3, 2011", "Q3, 2019" ]
Substitute( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 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".	[ "Qtr 3, 2038", "Quarter 3, 2033", "Q3, 2039" ]

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).