Função SEARCH (DAX)
Retorna o número de caracteres no qual uma cadeia específica de caracteres ou de texto é encontrada pela primeira vez, na leitura da esquerda para a direita. A pesquisa diferencia maiúsculas e minúsculas.
Sintaxe
SEARCH(<find_text>, <within_text>, [start_num])
Parâmetros
Termo |
Definição |
|---|---|
find_text |
O texto que você deseja encontrar. |
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. |
Valor da propriedade/Valor do 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
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.
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.
Consulte também