WorksheetFunction. Método FindB (Excel)

Localize e LocalizarB localize uma cadeia de texto dentro de uma segunda cadeia de texto e devolva o número da posição inicial da primeira cadeia de texto do primeiro caráter da segunda cadeia de texto.

Sintaxe

expressão. 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 pretende 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

A opção Localizar destina-se a ser utilizada com idiomas que utilizam o conjunto de carateres de byte único (SBCS), enquanto o FindB destina-se a ser utilizado com idiomas que utilizam o conjunto de carateres de byte duplo (DBCS). A configuração de idioma padrão no computador afeta o valor de retorno da seguinte forma:

• Localizar conta sempre cada caráter, seja byte único ou byte duplo, como 1, independentemente da predefinição de idioma.

• FindB conta cada caráter de byte duplo como 2 quando ativou a edição de um idioma que suporta DBCS e, em seguida, define-o como o idioma predefinido. Caso contrário, LocalizarB conta cada caráter como 1.

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

Localizar e LocalizarB são sensíveis às maiúsculas e minúsculas e não permitem carateres universais. Se não quiser fazer uma pesquisa sensível a maiúsculas e minúsculas ou utilizar carateres universais, pode utilizar a Pesquisa e a PesquisaB.

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

Texto_procurado não pode conter nenhum caractere curinga.

Se find_text não aparecer no within_text, Localizar e LocalizarB devolvem o #VALUE! valor de erro.

Se start_num não for superior a zero, Localizar e LocalizarB devolvem o #VALUE! valor de erro.

Se start_num for maior do que o comprimento de within_text, Localizar e LocalizarB devolvem o #VALUE! valor de erro.

Use núm_inicial para ignorar um número de caracteres especificado. Ao utilizar Localizar como exemplo, suponha que está a trabalhar com a cadeia 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 caráter 8, localiza find_text no caráter seguinte e devolve o número 9.

Localizar devolve sempre o número de carateres desde o início do within_text, contando os carateres que ignorar se start_num for superior a 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.