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 ocorre nenhuma substituição. Se ocorrência for omitida, todas as ocorrências de cadeia-existente dentro de cadeia-origem sã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("exemplo@example.com: E-mail da Marina", REGEX("[A-Z0-9a-z._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,4}") & REGEX(": *"), "") tem como resultado "E-mail da Marina". =SUBST("marina@example.com"; REGEX("([A-Z0-9a-z._%+-]+)@([A-Za-z0-9.-]+\.[A-Za-z]{2,4})"); "$1") tem como resultado "marina". Ao usar o primeiro grupo de captura em REGEX, apenas extrai o nome de utilizador. =SUBST("marina@example.com"; REGEX("([A-Z0-9a-z._%+-]+)@([A-Za-z0-9.-]+\.[A-Za-z]{2,4})"); "$2") tem como resultado "example.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("exemplo@example.com: E-mail da Marina", REGEX("[A-Z0-9a-z._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,4}") & REGEX(": *"), "") tem como resultado "E-mail da Marina".

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

=SUBST("marina@example.com"; REGEX("([A-Z0-9a-z._%+-]+)@([A-Za-z0-9.-]+\.[A-Za-z]{2,4})"); "$2") tem como resultado "example.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