WorksheetFunction. Método ProcurarB (Excel)

Localizar e ProcurarB localizam uma cadeia de texto dentro de uma segunda cadeia de texto e retornam o número da posição inicial da primeira cadeia de texto do primeiro caractere da segunda cadeia de texto.

Sintaxe

mais simples. FindB (arg1, arg2, arg3)

expressão Uma variável que representa um objeto WorksheetFunction .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Arg1 Obrigatório String Texto_procurado - o texto que você deseja localizar.
Arg2 Obrigatório String Within_text - o texto que contém o texto que você deseja localizar.
Arg3 Opcional Variant Núm_inicial - especifica o caractere a partir do qual a pesquisa será iniciada. O primeiro caractere no_texto é o caractere número 1. Se for omitido, núm_inicial será considerado como 1.

Valor de retorno

Double

Comentários

Localizar destina-se ao uso com idiomas que usam o conjunto de caracteres de byte único (SBCS), enquanto ProcurarB destina-se ao uso com idiomas que usam o conjunto de caracteres de byte duplo (DBCS). A configuração de idioma padrão no computador afeta o valor de retorno da seguinte forma:

  • Localizar sempre conta cada caractere, seja de byte único ou duplo, como 1, independentemente da configuração de idioma padrão.

  • ProcurarB conta cada caractere de byte duplo como 2 quando você habilita a edição de um idioma que oferece suporte a DBCS e, em seguida, o define como o idioma padrão. Caso contrário, ProcurarB contará cada caractere como 1.

  • Os idiomas com suporte para DBCS são: japonês, chinês (simplificado), chinês (tradicional) e coreano.

Procurar e ProcurarB diferenciam maiúsculas de minúsculas e não permitem caracteres curinga. Se você não quiser fazer uma pesquisa que diferencie maiúsculas de minúsculas ou usar caracteres curinga, poderá usar Pesquisar e PesquisarB.

Se find_text for "" (texto vazio), Localizar corresponderá ao primeiro caractere na cadeia de caracteres de pesquisa (ou seja, o caractere numerado start_num ou 1).

Texto_procurado não pode conter nenhum caractere curinga.

Se find_text não aparecer em within_text, Localizar e ProcurarB retornará o #VALUE! valor de erro.

Se start_num não for maior que zero, Localizar e ProcurarB retornará o #VALUE! valor de erro.

Se start_num for maior que o comprimento de within_text, Localizar e ProcurarB retornará o #VALUE! valor de erro.

Use núm_inicial para ignorar um número de caracteres especificado. Usando Localizar como exemplo, suponha que você esteja trabalhando com a cadeia de caracteres de AYF0093.YoungMensAppareltexto . Para localizar o número do primeiro "Y" na parte descritiva da cadeia de texto, defina start_num igual a 8 para que a parte do número de série do texto não seja pesquisada. Localizar começa com o caractere 8, localiza find_text no próximo caractere e retorna o número 9.

Localizar sempre retorna o número de caracteres do início de within_text, contando os caracteres que você ignora se start_num for maior que 1.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.