Função SEARCH
Retorna o número do caractere no qual uma cadeia específica de caracteres ou de texto é encontrada pela primeira vez, quando se lê da esquerda para a direita. A pesquisa não diferencia maiúsculas de minúsculas e diferencia acento.
Sintaxe
SEARCH(<find_text>, <within_text>[, [<start_num>][, <NotFoundValue>]])
Parâmetros
Termo |
Definição |
|---|---|
find_text |
O texto que você deseja encontrar. Você pode usar caracteres curinga — o ponto de interrogação (?) e o asterisco (*). — em find_text. Um ponto de interrogação corresponde a qualquer caractere único; um asterisco corresponde a qualquer sequência de caracteres. Se você desejar localizar um ponto de interrogação ou asterisco real, digite um til (~) antes do caractere. |
within_text |
O texto no qual você deseja procurar find_text ou uma coluna que contenha texto. |
start_num |
(opcional) A posição do caractere em within_text na qual você deseja iniciar a pesquisa. Se omitida, o valor será 1. |
NotFoundValue |
(opcional) O valor que deve ser retornado quando a operação não localiza um subcadeia de caracteres compatível, normalmente 0, -1 ou BLANK (). |
Valor de retorno
O número da posição inicial da primeira cadeia de caracteres de texto a partir do primeiro caractere da segunda cadeia de caracteres de texto.
Comentários
A função de pesquisa não diferencia maiúsculas de minúsculas. Procurar "N" localizará a primeira ocorrência de 'N' ou 'n'.
A função de pesquisa diferencia acentos. Procurar "á" localizará a primeira ocorrência de 'á' mas nenhuma ocorrência de 'a', 'à', ou as versões maiúsculas 'A', 'Á'.
Usando essa função, é possível localizar uma cadeia de caracteres de texto em uma segunda cadeia de caracteres de texto e retornar a posição onde a primeira cadeia de caracteres de texto começa.
É possível usar a função SEARCH para determinar o local de um caractere ou uma cadeia de caracteres de texto em outra cadeia de caracteres de texto e, em seguida, usar a função MID para retornar o texto ou usar as função REPLACE para alterar o texto.
Se find_text não puder ser encontrado em within_text, a fórmula retornará um erro. Esse comportamento é como o do Excel, que retornará #VALUE se a subcadeia de caracteres não for encontrada. Os nulos em within_text serão interpretados como uma cadeia de caracteres vazia neste contexto.
Esta função DAX pode retornar resultados diferentes quando usada em um modelo que é implantado e consultado no modo DirectQuery. Para obter mais informações sobre diferenças semânticas no modo DirectQuery, consulte https://go.microsoft.com/fwlink/?LinkId=219171.
Exemplo: pesquisar em uma cadeia de caracteres
Descrição
A fórmula a seguir encontra a posição da letra "n" na palavra "printer".
Código
=SEARCH("n","printer")
Comentários
A fórmula retorna 4 porque "n" é o quarto caractere na palavra "printer".
Exemplo: pesquisar em uma coluna
Descrição
Você pode usar uma referência de coluna como um argumento para SEARCH. A fórmula a seguir localiza a posição do caractere "-" (hífen) na coluna [PostalCode].
Código
=SEARCH("-",[PostalCode])
Comentários
O resultado de retorno é uma coluna de números indicando a posição de índice do hífen.
Exemplo: manipulação de erro com SEARCH
Descrição
A fórmula do exemplo anterior falhará se a cadeia de pesquisa não for encontrada em todas as linhas da coluna de origem. Portanto, o exemplo a seguir demonstra como usar IFERROR com a função SEARCH para garantir o retorno de um resultado válido para cada linha.
A fórmula a seguir localiza a posição do caractere "-" na coluna e retornará -1 se a cadeia de caracteres não for encontrada.
Código
= IFERROR(SEARCH("-",[PostalCode]),-1)
Comentários
Observe que o tipo de dados do valor usado como saída de erro deve corresponder ao tipo de dados da saída não de erro. Nesse caso, você fornece um valor numérico para saída em caso de erro, pois SEARCH retorna um valor inteiro.
No entanto, também é possível retornar um espaço em branco (cadeia de caracteres vazia) usando BLANK() como o segundo argumento para IFERROR.