Función InStr

Devuelve la posición de la primera aparición de una cadena dentro de otra.

InStr([inicio, ]cadena1, cadena2[, comparar])

Argumentos

inicio: Opcional. Expresión numérica que establece la posición de inicio para cada búsqueda. Si se omite, la búsqueda comienza en la primera posición del carácter. Si inicio contiene Null, se produce un error. El argumento inicio es necesario si se especifica comparar.
cadena1: Requerido. Expresión de cadena que se busca.
cadena2: Requerido. Expresión de cadena que se busca.
comparar: Opcional. Valor numérico que indica el tipo de comparación que se utilizará cuando se evalúen subcadenas. Consulte la sección Valores para ver los valores. Si se omite, se realiza una comparación binaria.

Valores

El argumento comparar puede tener los siguientes valores:

Constante	Valor	Descripción
vbBinaryCompare	0	Realiza una comparación binaria.
vbTextCompare	1	Realiza una comparación textual.

Valores de retorno

La función InStr devuelve los siguientes valores:

Si	InStr devuelve
cadena1 es de longitud cero	0
cadena1 es Null	Null
cadena2 es de longitud cero	inicio
cadena2 es Null	Null
cadena2 no se encuentra	0
cadena2 se encuentra dentro de cadena1	Posición en la que se encuentra la coincidencia
inicio > Len(cadena2)	0

Observaciones

Los siguientes ejemplos utilizan InStr para buscar una cadena:

Dim SearchString, SearchChar, MiPos
SearchString ="XXpXXpXXPXXP"            ' Cadena en la que buscar.
SearchChar = "P"                  ' Se busca "P".
MiPos = Instr(4, SearchString, SearchChar, 1)   ' Una comparación textual 
                        ' que comienza en la posición 4. Devuelve 6.   
MiPos = Instr(1, SearchString, SearchChar, 0)   ' Una comparación binaria 
                        ' que comienza en la posición 1. Devuelve 9.   
MiPos = Instr(SearchString, SearchChar)      ' La comparación es binaria                         ' de forma predeterminada   
                        ' (se omite el último argumento).
                        ' Devuelve 9.
MiPos = Instr(1, SearchString, "W")         ' Una comparación binaria 
                        ' comienza en la posición 1.        
                        ' Devuelve 0 ("W" no se encuentra).

Nota La función InStrB se utiliza con datos de tipo byte contenidos en una cadena. En lugar de devolver la posición del carácter de la primera aparición de una cadena dentro de otra, InStrB devuelve la posición de byte.

Requisitos

Versión 1

Consulte también

Función InStrRev