Função LOCALIZAR

Aplica-se a
SharePoint Server 2019 SharePoint Server 2016 SharePoint Server 2013 Standard SharePoint Server 2013 Enterprise SharePoint Foundation 2010 SharePoint Server 2010 Windows SharePoint Services 3.0

SEARCH retorna o número do caractere no qual uma cadeia de caracteres ou de texto específica é encontrada pela primeira vez, começando com start_num. Use SEARCH para determinar o local de uma caractere ou cadeia de caracteres de texto dentro de outra cadeia de caracteres de texto para que você possa usar as funções MID ou REPLACE para alterar o texto.

Sintaxe

SEARCH(find_text,within_text,start_num)

Find_text é o texto que você deseja encontrar. Você pode usar os caracteres curinga – ponto de interrogação (?) e asterisco (*) em find_text. Um ponto de interrogação coincide com qualquer caractere único; um asterisco coincide com qualquer cadeia de caracteres. Se você quiser localizar um ponto de interrogação ou asterisco real, digite um til (~) antes do caractere.

Within_text é o texto no qual você deseja pesquisar find_text.

Start_num é o número de caracteres em within_text em que você deseja começar a pesquisar. Use núm_inicial para ignorar um número de caracteres especificado. Por exemplo, suponha que você esteja trabalhando com a cadeia de caracteres de texto "AYF0093. YoungMensApparel". Para encontrar o número do primeiro "R" na parte descritiva da cadeia de texto, defina núm_inicial como 8 para que a parte do número de série do texto não seja pesquisada. SEARCH começa com o caractere 8, encontra find_text no próximo caractere e retorna o número 9. O SEARCH sempre retorna o número de caracteres desde o início do within_text, contando os caracteres que você ignora se start_num for maior que 1.

Comentários

  • O SEARCH não distingue entre letras maiúsculas e minúsculas ao pesquisar texto.
  • SEARCH é semelhante ao FIND, exceto que FIND é sensível a casos.
  • Se find_text não for encontrado, o #VALUE! será retornado.
  • Se start_num for omitido, presume-se que seja 1.
  • Se start_num não for maior que 0 (zero) ou for maior que o comprimento de within_text, o #VALUE! será retornado.

Exemplos

Col1 Col2 Col3 Fórmula Descrição (Resultado)
Declarações Margem de lucro margem =SEARCH("e",[Col1],6) Posição do primeiro "e" na cadeia de caracteres, começando na sexta posição (7)
Declarações Margem de lucro margem =SEARCH([Col3],[Col2]) Posição de "margem" em "Margem de Lucro" (8)
Declarações Margem de lucro margem =REPLACE([Col2],SEARCH([Col3],[Col2]),6"Amount") Substitui "Margin" por "Amount" (Valor do lucro)