Strings.InStr Método

Definición

Espacio de nombres:
Microsoft.VisualBasic
Ensamblado:
Microsoft.VisualBasic.dll

Devuelve un entero que especifica la posición inicial de la primera aparición de una cadena dentro de otra. El entero es un índice basado en uno si se encuentra una coincidencia. Si no se encuentra ninguna coincidencia, la función devuelve cero.

Sobrecargas

Nombre Description
InStr(Int32, String, String, CompareMethod)

Devuelve un entero que especifica la posición inicial de la primera aparición de una cadena dentro de otra.
InStr(String, String, CompareMethod)

Devuelve un entero que especifica la posición inicial de la primera aparición de una cadena dentro de otra.

InStr(Int32, String, String, CompareMethod)

Devuelve un entero que especifica la posición inicial de la primera aparición de una cadena dentro de otra.

public static int InStr(int Start, string String1, string String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
static member InStr : int * string * string * Microsoft.VisualBasic.CompareMethod -> int
Public Function InStr (Start As Integer, String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As Integer

Parámetros

StartStartPos
Int32

Optional. Expresión numérica que establece la posición inicial de cada búsqueda. Si se omite, la búsqueda comienza en la posición del primer carácter. El índice de inicio está basado en 1.

String1
String

Required. String expresión en la que se busca.

String2
String

Required. String expresión buscada.

Compare
CompareMethod

Optional. Especifica el tipo de comparación de cadenas. Si Compare se omite, la Option Compare configuración determina el tipo de comparación.

Devoluciones

Int32
SiInStr devuelve
String1 es de longitud cero o Nothing0
String2 es de longitud cero o Nothing start
String2 no se encuentra0
String2 se encuentra dentro de String1 Posición donde comienza la coincidencia
Start > longitud de String10

Excepciones

ArgumentException

Start < 1.

Ejemplos

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

' String to search in.
Dim searchString As String = "XXpXXpXXPXXP"
' Search for "P".
Dim searchChar As String = "P"

Dim testPos As Integer
' A textual comparison starting at position 4. Returns 6.
testPos = InStr(4, searchString, searchChar, CompareMethod.Text)

' A binary comparison starting at position 1. Returns 9.
testPos = InStr(1, SearchString, SearchChar, CompareMethod.Binary)

' If Option Compare is not set, or set to Binary, return 9.
' If Option Compare is set to Text, returns 3.
testPos = InStr(searchString, searchChar)

' Returns 0.
testPos = InStr(1, searchString, "W")

Comentarios

Normalmente, la InStr función se usa al analizar cadenas.

Nota:

La función InStrB en versiones anteriores de Visual Basic devuelve un número de bytes en lugar de una posición de carácter. Se usa principalmente para convertir cadenas en aplicaciones de juego de caracteres de doble byte (DBCS). Todas las cadenas Visual Basic 2005 están en Unicode y ya no se admite InStrB.

La configuración del Compare argumento es:

Constante Value Descripción
Binary 0 Realiza una comparación binaria
Text 1 Realiza una comparación de texto

Consulte también

Se aplica a

InStr(String, String, CompareMethod)

Devuelve un entero que especifica la posición inicial de la primera aparición de una cadena dentro de otra.

public static int InStr(string String1, string String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
static member InStr : string * string * Microsoft.VisualBasic.CompareMethod -> int
Public Function InStr (String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As Integer

Parámetros

String1
String

Required. String expresión en la que se busca.

String2
String

Required. String expresión buscada.

Compare
CompareMethod

Optional. Especifica el tipo de comparación de cadenas. Si Compare se omite, la Option Compare configuración determina el tipo de comparación.

Devoluciones

Int32
SiInStr devuelve
String1 es de longitud cero o Nothing0
String2 es de longitud cero o NothingPosición inicial de la búsqueda, que tiene como valor predeterminado la primera posición del carácter.
String2 no se encuentra0
String2 se encuentra dentro de String1Posición donde comienza la coincidencia.

Ejemplos

En este ejemplo se usa la InStr función para devolver la posición de la primera aparición de una cadena dentro de otra. En el primer ejemplo, la búsqueda comienza desde el cuarto carácter y devuelve la siguiente minúscula "p" porque CompareMethod no distingue Text mayúsculas de minúsculas y, por tanto, no distingue mayúsculas de minúsculas. La posición siempre es relativa al principio de la cadena, independientemente de la posición inicial.

' String to search in.
Dim searchString As String = "XXpXXpXXPXXP"
' Search for "P".
Dim searchChar As String = "P"

Dim testPos As Integer
' A textual comparison starting at position 4. Returns 6.
testPos = InStr(4, searchString, searchChar, CompareMethod.Text)

' A binary comparison starting at position 1. Returns 9.
testPos = InStr(1, SearchString, SearchChar, CompareMethod.Binary)

' If Option Compare is not set, or set to Binary, return 9.
' If Option Compare is set to Text, returns 3.
testPos = InStr(searchString, searchChar)

' Returns 0.
testPos = InStr(1, searchString, "W")

Comentarios

Normalmente, la InStr función se usa al analizar cadenas.

Nota:

La función InStrB en versiones anteriores de Visual Basic devuelve un número de bytes en lugar de una posición de carácter. Se usa principalmente para convertir cadenas en aplicaciones de juego de caracteres de doble byte (DBCS). Todas las cadenas Visual Basic 2005 están en Unicode y ya no se admite InStrB.

La configuración del Compare argumento es:

Constante Value Descripción
Binary 0 Realiza una comparación binaria
Text 1 Realiza una comparación de texto

Consulte también

Se aplica a