Função InStr

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

Retorna uma Variante (Longo) que especifica a posição da primeira ocorrência de uma cadeia em outra.

Veja alguns exemplos

Sintaxe

InStr ([início, ] cadeia1, cadeia2 [Comparar ] )

A sintaxe da função InStr possui os seguintes argumentos:

Argumento

Descrição

iniciar

Opcional. Expressão numérica que define a posição inicial para cada pesquisa. Se omitido, a pesquisa começa na posição do primeiro caractere. Se Iniciar contiver Nulo, ocorrerá um erro. O argumento start é necessário se Comparar for especificado.

cadeia1

Necessário. Expressão de cadeia de caracteres que está sendo pesquisada.

cadeia2

Necessário. Expressão de cadeia de caracteres procurada.

Comparar

Opcional. Especifica o tipo de string comparison. Se Comparar for nulo, ocorrerá um erro. Se Comparar for omitido, a opçãoComparar determina o tipo de comparação. Especifique um LCID válido (LocaleID) para usar regras específicas de localidade na comparação.

Dica : No Access 2010, o construtor de expressões tem IntelliSense, assim você pode ver quais argumentos requer sua expressão.

Configurações

As configurações de argumento Comparar são:

Constante

Valor

Descrição

vbUseCompareOption

-1

Executa uma comparação usando a configuração da instrução Option Compare .

vbBinaryCompare

0

Executa uma comparação binária.

vbTextCompare

1

Executa uma comparação textual.

vbDatabaseCompare

2

Microsoft Office Access 2007 somente. Executa uma comparação com base nas informações no banco de dados.


Retornar valores

Se

InStr retorna

cadeia1 é de comprimento zero

0

cadeia1 é nulo

Nulo

cadeia2 é de comprimento zero

Iniciar

cadeia2 é nulo

Nulo

cadeia2 não foi encontrado

0

cadeia2 é encontrado dentro cadeia1

Posição na qual a correspondência for encontrada

Iniciar > cadeia2

0


Comentários

A função InStrB é usada com dados de byte contidos em uma cadeia de caracteres. Em vez de retornar a posição de caractere da primeira ocorrência de uma cadeia de caracteres dentro de outra, InStrB retorna a posição do byte.

Exemplos

Use a função InStr em uma expressão    Você pode usar InStr sempre que você pode usar expressões. Por exemplo, se você quiser localizar a posição do primeiro período (.) em um campo que contém os endereços IP (endereço de IP nomeado), você pode usar InStr para encontrá-lo, assim:

InStr(1,[IPAddress],".")

A função InStr examina cada valor no campo endereço IP e retorna a posição do primeiro período. Portanto, se for a primeira parte do endereço IP 10., a função retornará o valor 3.

Em seguida, você pode usar outras funções, operando na saída da função InStr , para extrair a parte do endereço IP que precede o primeiro período, similar assim:

Left([IPAddress],(InStr(1,[IPAddress],".") -1))

Neste exemplo, InStr(1,[IPAddress],".") Retorna a posição do primeiro período. 1 subtraindo determina quantos caracteres preceda o primeiro período, nesse caso, 2. A função esquerda então extrai tantos caracteres da parte esquerda do campo de endereço IP, retornando o valor 10.

Use InStr no código VBA   

Observação : Exemplos a seguir demonstram o uso dessa função em um Visual Basic para módulo Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione a Referência do desenvolvedor na lista suspensa ao lado de pesquisa e insira um ou mais termos na caixa de pesquisa.

Este exemplo usa a função InStr para retornar a posição da primeira ocorrência de uma cadeia de caracteres dentro de outra.

Dim SearchString, SearchChar, MyPos
SearchString ="XXpXXpXXPXXP" ' String to search in.
SearchChar = "P" ' Search for "P".
' A textual comparison starting at position 4. Returns 6.
MyPos = Instr(4, SearchString, SearchChar, 1)
' A binary comparison starting at position 1. Returns 9.
MyPos = Instr(1, SearchString, SearchChar, 0)
' Comparison is binary by default
' (last argument is omitted).
MyPos = Instr(SearchString, SearchChar) ' Returns 9.
MyPos = Instr(1, SearchString, "W") ' Returns 0.

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×