SEARCH

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Retorna o número do caractere no qual um caractere específico ou cadeia de caracteres de texto é encontrado pela primeira vez, lendo da esquerda para a direita. A pesquisa é sensível a maiúsculas e minúsculas, insensíveis a kanatype, insensíveis à largura e a acento.

Sintaxe

SEARCH(<find_text>, <within_text>[, [<start_num>][, <NotFoundValue>]])

Parâmetros

Valor de retorno

O número da posição inicial da primeira cadeia de texto a partir do primeiro caractere da segunda cadeia de texto.

Observações

• A função de pesquisa não diferencia maiúsculas de minúsculas. Pesquisando por "N" encontrará a primeira ocorrência de "N" ou "n".

• A função de pesquisa é insensível a kanatype, insensível à largura. Procurar por "か" encontrará a primeira ocorrência de 「か」 (hiragana), 「カ」 (katakana) ou 「カ」 (katakana de meia largura).

• A função de pesquisa é sensível ao sotaque. Pesquisando por "á" encontrará a primeira ocorrência de 'á', mas nenhuma ocorrência de 'a', 'à', ou as versões maiúsculas 'A', 'Á'.

• Você pode usar a função SEARCH para determinar o local de um caractere ou cadeia de caracteres de texto dentro de outra cadeia de texto e, em seguida, usar a função MID para retornar o texto ou usar a função REPLACE para alterar o texto.

• Se o find_text não puder ser encontrado no within_text, a fórmula retornará um erro. Esse comportamento é como o Excel, que retorna #VALUE se a substring não for encontrada. Nulos em within_text serão interpretados como uma cadeia de caracteres vazia neste contexto.

• Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).

Exemplo

A consulta DAX a seguir localiza a posição da primeira letra de "ciclo", na cadeia de caracteres que contém o nome do revendedor. Se não for encontrado, Blank será retornado.

SEARCH não diferencia maiúsculas de minúsculas. Neste exemplo, se "ciclo" ou "Ciclo" for usado no argumento find_text, os resultados serão retornados para ambos os casos. Use FIND para diferenciar maiúsculas de minúsculas.

Exemplos neste artigo podem ser usados com o modelo de exemplo do Power BI Desktop do Adventure Works DW 2020. Para obter o modelo, consulte DAX exemplo de modelo.

EVALUATE
CALCULATETABLE (
    ADDCOLUMNS (
        TOPN ( 10, SUMMARIZE('Reseller', [Reseller], [Business Type])),
        "Position of cycle", SEARCH ( "cycle", 'Reseller'[Reseller], 1, BLANK () )
    ),
    'Reseller'[Business Type] IN { "Specialty Bike Shop", "Value Added Reseller", "Warehouse"}
)

Devoluções,

Conteúdo relacionado

FIND REPLACE Funções de texto