Devolve texto que ocorre antes de um determinado caráter ou cadeia. É o oposto da função TEXTODEPOIS.
Sintaxe
=TEXTOANTES(texto,delimitador,[número_da_instância], [modo_de_correspondência], [fim_da_correspondência], [se_não_encontrado])
A sintaxe da função TEXTOANTES tem os seguintes argumentos:
texto O texto em que está a procurar. Não são permitidos carateres universais. Se o texto for uma cadeia vazia, o Excel devolve texto vazio. Obrigatório.
delimitador O texto que marca o ponto antes do qual pretende extrair. Obrigatório.
instance_num A instância do delimitador após a qual pretende extrair o texto. Por predefinição, instance_num = 1. Um número negativo começa a procurar texto a partir do fim. Opcional.
modo_de correspondência Determina se a pesquisa de texto é sensível às maiúsculas e minúsculas. A predefinição é sensível às maiúsculas e minúsculas. Opcional. Introduza uma dos seguintes opções:
-
0 Sensível às maiúsculas e minúsculas.
-
1 Não sensível às maiúsculas e minúsculas.
fim_da_correspondência Trata o fim do texto como um delimitador. Por predefinição, o texto é uma correspondência exata. Opcional. Introduza o seguinte:
-
0 Não faça uma correspondência entre o delimitador e o fim do texto.
-
1 Faça uma correspondência entre o delimitador e o fim do texto.
se_não_encontrado Valor devolvido se não for encontrada nenhuma correspondência. Por predefinição, #N/A é devolvido. Opcional.
Observações
Ao procurar com um valor de delimitador vazio, TEXTOANTES efetua a correspondência de forma imediata. Devolve texto vazio ao procurar a partir do início (se núm_instância for positivo) e todo o texto ao procurar a partir do fim (se núm_instância for negativo).
Exemplo |
Resultado |
---|---|
=TEXTOANTES("A história do capuchinho vermelho; capuchinho vermelho"; "capuchinho") |
A história do |
=TEXTOANTES("A história do capuchinho vermelho; capuchinho vermelho"; "") |
|
=TEXTOANTES("A história do capuchinho vermelho; capuchinho vermelho"; ""; -1) |
A história do capuchinho vermelho; capuchinho vermelho |
Erros
-
O Excel devolve um erro #VALOR! se o parâmetro número_de_instâncias = 0, ou superior ao comprimento do texto.
-
O Excel devolve um erro #N/D se delimitador não estiver contido no texto.
-
Excel devolve um erro #N/D se instance_num for maior que o número de ocorrências de delimitador no texto.
Exemplos
Copie os dados de exemplo em cada uma das tabelas seguintes e cole-os na célula A1 de uma nova folha de cálculo do Excel. Se pretender, pode ajustar as larguras das colunas para ver todos os dados.
Dados |
||
Capuchinho Vermelho |
||
Capuchinho vermelho |
||
Fórmulas |
Resultados |
|
=TEXTOANTES(A2,"Vermelho") |
Pouco |
|
=TEXTOANTES(A3,"Vermelho") |
#N/D |
|
=TEXTOANTES(A3,"vermelho",2) |
Capuchinho Vermelho |
|
=TEXTOANTES(A3;"vermelho",-2) |
Pouco |
|
=TEXTOANTES(A3;"Vermelho",,FALSO) |
#N/D |
|
=TEXTOANTES(A3;"vermelho",3) |
#N/D |
Dados |
|
Marco Aurélio |
|
Sócrates |
|
Immanuel Kant |
|
Fórmulas |
Resultados |
=TEXTOANTES(A2;" ";;;1) |
Marcus |
=TEXTOANTES(A3;" ";;;0) |
#N/D |
=TEXTOANTES(A3;" ";;;1) |
Sócrates |
=TEXTOANTES(A4;" ";;;1) |
Immanuel |