SUBST

A função SUBST tem como resultado um valor de cadeia em que os caracteres especificados de um determinado valor de cadeia foram substituídos por um novo valor de cadeia.

SUBST(cadeia-origem; cadeia-existente; cadeia-nova; ocorrência.)

cadeia-origem: Qualquer valor.

cadeia-existente: O valor a ser substituído. cadeia-existente pode conter qualquer valor.

cadeia-nova: O valor utilizado como substituição cadeia-nova pode conter qualquer valor. Não tem de ter o mesmo tamanho que a cadeia existente.

ocorrência: Um valor numérico que especifica qual a ocorrência da cadeia-existente dentro da cadeia-origem que deverá ser substituída. ocorrência tem de ser superior ou igual a 1 ou omitida. Se ocorrência for superior ao número de vezes que cadeia-existente aparece dentro de cadeia-origem, não irá ocorrer nenhuma substituição. Se ocorrência for omitida, todas as ocorrências de cadeia-existente dentro de cadeia-origem serão substituídas por cadeia-nova.

Notas

É possível substituir caracteres individuais, palavras inteiras ou cadeias de caracteres dentro de palavras.
Se REGEX for usado para especificar o valor de pesquisa na cadeia-existente, os grupos de captura podem ser usados na cadeia-nova.

Exemplos
=SUBST(“a b c d e f", “b", “B") tem como resultado “a B c d e f”. =SUBST(“a a b b b c", “a", “A", 2) tem como resultado “a A b b b c”. =SUBST(“a a b b b c", “b", “B") tem como resultado “a a B B B c”. =SUBST(“aaabbccc", “bc", “BC", 2) tem como resultado “aaabbccc”. =SUBST(60606; 6; 3) tem como resultado “30303”. =SUBST("example@email.com: Manuel Macieira", REGEX("[A-Z0-9a-z._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,4}") & REGEX(": *"), "") tem como resultado "Manuel Macieira". =SUBST(“manuel@macieira.com", REGEX(“([A-Z0-9a-z._%+-]+)@([A-Za-z0-9.-]+\.[A-Za-z]{2,4})”), “$1”) tem como resultado “manuel”. Ao usar o primeiro grupo de captura em REGEX, apenas extrai o nome de utilizador. =SUBST("manuel@macieira.com", REGEX("([A-Z0-9a-z._%+-]+)@([A-Za-z0-9.-]+\.[A-Za-z]{2,4})"), "$2") tem como resultado "macieira.com". Ao usar o segundo grupo de captura em REGEX, apenas extrai o nome do domínio.

Exemplos

=SUBST(“a b c d e f", “b", “B") tem como resultado “a B c d e f”.

=SUBST(“a a b b b c", “a", “A", 2) tem como resultado “a A b b b c”.

=SUBST(“a a b b b c", “b", “B") tem como resultado “a a B B B c”.

=SUBST(“aaabbccc", “bc", “BC", 2) tem como resultado “aaabbccc”.

=SUBST(60606; 6; 3) tem como resultado “30303”.

=SUBST("example@email.com: Manuel Macieira", REGEX("[A-Z0-9a-z._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,4}") & REGEX(": *"), "") tem como resultado "Manuel Macieira".

=SUBST(“manuel@macieira.com", REGEX(“([A-Z0-9a-z._%+-]+)@([A-Za-z0-9.-]+\.[A-Za-z]{2,4})”), “$1”) tem como resultado “manuel”. Ao usar o primeiro grupo de captura em REGEX, apenas extrai o nome de utilizador.

=SUBST("manuel@macieira.com", REGEX("([A-Z0-9a-z._%+-]+)@([A-Za-z0-9.-]+\.[A-Za-z]{2,4})"), "$2") tem como resultado "macieira.com". Ao usar o segundo grupo de captura em REGEX, apenas extrai o nome do domínio.

Ver tambémSUBSTITUIR

Útil?

Ajuda sobre fórmulas e funções

SUBST

Notas