Método WorksheetFunction.SearchB (Excel)

Procure e ProcureB 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. SearchB (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	Find_text - o texto que pretende localizar.
Arg2	Obrigatório	String	No_texto - o texto em que você deseja localizar o texto_procurado.
Arg3	Opcional	Variant	Núm_inicial - o número do caractere em no_texto em que você deseja iniciar a pesquisa.

Valor de retorno

Double

Comentários

A pesquisa destina-se a ser utilizada com idiomas que utilizam o conjunto de carateres de byte único (SBCS), enquanto o SearchB 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:

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

• O SearchB conta cada caráter de byte duplo como 2 quando tiver ativado a edição de um idioma que suporte DBCS e, em seguida, define-o como o idioma predefinido. Caso contrário, ProcurarB conta cada caráter como 1.

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

Utilize Procurar e ProcurarB para determinar a localização de um caráter ou cadeia de texto dentro de outra cadeia de texto para que possa utilizar as funções Mid e MidB ou Replace e ReplaceB para alterar o texto.

A pesquisa e a PesquisaB não são sensíveis a maiúsculas e minúsculas. Se quiser fazer uma pesquisa sensível a maiúsculas e minúsculas, pode utilizar Localizar e LocalizarB.

Utilize os carateres universais, o ponto de interrogação (?) e o asterisco (*), no find_text. Um ponto de interrogação corresponde a qualquer caractere único; um asterisco corresponde a qualquer sequência de caracteres. Se você quiser localizar um ponto de interrogação ou um asterisco, digite um til (~) antes do caractere.

Se texto_procurado não for localizado, o valor de erro #VALOR! será retornado.

Se núm_inicial for omitido, será equivalente a 1.

Se núm_inicial não for maior do que 0 ou for maior do que o comprimento de no_texto, o valor de erro #VALOR! será retornado.

Use núm_inicial para ignorar um número de caracteres especificado. Ao utilizar a Pesquisa 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. A pesquisa começa com o caráter 8, encontra find_text no caráter seguinte e devolve o número 9.

A pesquisa devolve sempre o número de carateres desde o início da 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.