Función InStr

  • Artículo

Devuelve un valor Variant (Long) que especifica la posición de la primera ocurrencia de una cadena dentro de otra.

Nota:

¿Le interesa el desarrollo de soluciones que amplían la experiencia de Office en varias plataformas? Vea el nuevo modelo de complementos de Office. Los complementos de Office tienen una huella pequeña en comparación con los complementos y soluciones de VSTO, y se pueden construir utilizando casi cualquier tecnología de programación web, como HTML5, JavaScript, CSS3 y XML.

Sintaxis

InStr([ start ], string1, string2, [ compare ])

La sintaxis de la función InStr consta de los argumentos con nombre siguientes:

Parte Descripción
start Opcional. Expresión numérica que define la posición inicial de cada búsqueda. Si se omite, la búsqueda comienza en la posición del primer carácter. Si start contiene Null, se produce un error. Se requiere el argumento start si se especifica compare.
string1 Obligatorio. Expresión de cadena en la que se busca.
string2 Obligatorio. Expresión de cadena buscada.
compare Opcional. Especifica el tipo de comparación de cadena. Si compare es Null, se produce un error. Si compare se omite, la configuración Option Compare determina el tipo de comparación. Especifique un LCID (identificador de configuración regional) válido para usar reglas específicas de la configuración regional en la comparación.

Configuración

La configuración del argumento compare es la siguiente.

Constante Valor Descripción
vbUseCompareOption -1 Realiza una comparación con la configuración de la instrucción Option Compare.
vbBinaryCompare 0 Lleva a cabo una comparación binaria.
vbTextCompare 1 Lleva a cabo una comparación textual.
vbDatabaseCompare 2 Solo Microsoft Access. Realiza una comparación que se basa en la información de la base de datos.

Valores devueltos

Si InStr devuelve
string1 es de longitud cero 0
string1 es Null Null
string2 es de longitud cero start
string2 es Null Null
string2 no se encuentra. 0
string2 se encuentra dentro de string1 Posición en la que se encuentra la coincidencia
start>string2 0

Observaciones

La función InStrB se usa con datos de byte incluidos en una cadena. En lugar de devolver la posición del carácter de la primera ocurrencia de una cadena dentro de otra, InStrB devuelve la posición de byte.

Ejemplo

En este ejemplo, se usa la función InStr para devolver la posición de la primera ocurrencia de una cadena dentro de otra.

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.

Vea también

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.