Notas de versão
Canal Empresarial Semestral (Pré-visualização)
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.
match_mode 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.
match_end 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.
if_not_found 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 #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.
Exemplo 1
| Capuchinho Vermelho | ||
|---|---|---|
| Dados | ||
| 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 |
Exemplo 2
| 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 |