Função InStr
- 14/08/2019
- 2 minutos para ler
-
-
o -
L -
m -
O -
k -
+ 2
-
Retorna um Variant (Long) especificando a posição da primeira ocorrência de uma string dentro de outra.
Observação
Interessado em desenvolver soluções que estendam a experiência do Office em várias plataformas? Confira o novo modelo de suplementos do Office. Os suplementos do Office ocupam pouco espaço em comparação com os suplementos e soluções do VSTO, e você pode criá-los usando quase qualquer tecnologia de programação da Web, como HTML5, JavaScript, CSS3 e XML.
Sintaxe
InStr (, string1, string2,)
A sintaxe da função InStr tem estes argumentos:
| Parte | Descrição |
|---|---|
| start | 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 o início contiver Nulo, ocorrerá um erro. O argumento inicial é necessário se comparar for especificado. |
| string1 | Requerido. Expressão de string sendo pesquisada. |
| string2 | Obrigatório. Busca-se a expressão da string. |
| compare | Opcional. Especifica o tipo de comparação de string. Se comparar for Nulo, ocorrerá um erro. Se comparar for omitido, a configuração Option Compare determinará o tipo de comparação. Especifique um LCID válido (LocaleID) para usar regras específicas de localidade na comparação. |
Configurações
As configurações do argumento de comparação são as seguintes.
| Constante | Valor | Descrição |
|---|---|---|
| vbUseCompareOption | -1 | Executa uma comparação usando a configuração da instrução Option Compare. |
| vbBinaryCompare | 0 | Executa um comparação binária. |
| vbTextCompare | 1 | Executa uma comparação textual. |
| vbDatabaseCompare | 2 | Somente Microsoft Access. Executa uma comparação com base nas informações de seu banco de dados. |
Valores de retorno
| Se | InStr retorna |
|---|---|
| string1 tem comprimento zero | 0 |
| string1 é Nulo | Nulo |
| string2 tem comprimento zero | start |
| string2 é Nulo | Nulo |
| string2 não foi encontrado | 0 |
| string2 é encontrado dentro de string1 | Posição na qual correspondência encontrada |
| start > string2 | 0 |
Observações
A função InStrB é usada com dados de byte contidos em uma string. Em vez de retornar a posição do caractere da primeira ocorrência de uma string dentro de outra, InStrB retorna a posição do byte.
Exemplo
Este exemplo usa a função InStr para retornar a posição do primeiro ocorrência de uma string dentro de outra.
Veja também
- Funções (Visual Basic for Applications)
Suporte e feedback
Tem dúvidas ou comentários sobre o Office VBA ou esta documentação? Consulte o suporte e feedback do Office VBA para obter orientação sobre como receber suporte e fornecer feedback.