Strings.InStr Método

Definición

Devuelve un entero que especifica la posición inicial de la primera aparición de una cadena dentro de otra.Returns an integer specifying the start position of the first occurrence of one string within another. El entero es un índice basado en uno, si se encuentra una coincidencia.The integer is a one-based index if a match is found. Si no se encuentra ninguna coincidencia, la función devuelve cero.If no match is found, the function returns zero.

Sobrecargas

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.Returns an integer specifying the start position of the first occurrence of one string within another.

InStr(String, String, CompareMethod)

Devuelve un entero que especifica la posición inicial de la primera aparición de una cadena dentro de otra.Returns an integer specifying the start position of the first occurrence of one string within another.

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.Returns an integer specifying the start position of the first occurrence of one string within another.

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

Start
Int32

Opcional.Optional. Expresión numérica que establece la posición inicial de cada búsqueda.Numeric expression that sets the starting position for each search. Si se omite, la búsqueda comienza en la posición del primer carácter.If omitted, search begins at the first character position. El índice de inicio es de base 1.The start index is 1-based.

String1
String

Obligatorio.Required. Expresión de tipo String en la que se va a buscar.String expression being searched.

String2
String

Obligatorio.Required. Expresión de tipo String que se va a buscar.String expression sought.

Compare
CompareMethod

Opcional.Optional. Especifica el tipo de comparación de cadenas.Specifies the type of string comparison. Si se omite Compare, la configuración de Option Compare determina el tipo de comparación.If Compare is omitted, the Option Compare setting determines the type of comparison.

Devoluciones

SiIf InStr devuelveInStr returns
String1 es de longitud cero o Nothing String1 is zero length or Nothing 00
String2 es de longitud cero o Nothing String2 is zero length or Nothing start
No se encuentra String2. String2 is not found 00
String2 se encuentra dentro de String1. String2 is found within String1 Posición donde empieza la coincidenciaPosition where match begins
Start > longitud de String1 Start > length of String1 00
..

Excepciones

Start < 1.Start < 1.

Ejemplos

En este ejemplo se usa la función InStr para devolver la posición de la primera aparición de una cadena dentro de otra.This example uses the InStr function to return the position of the first occurrence of one string within another.

' 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 función InStr se utiliza al analizar cadenas.Typically, the InStr function is used when parsing strings.

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.The InStrB function in previous versions of Visual Basic returns a number of bytes rather than a character position. Se usa principalmente para convertir cadenas en aplicaciones de juegos de caracteres de doble byte (DBCS).It is used primarily for converting strings in double-byte character set (DBCS) applications. Todas Visual Basic cadenas 2005 están en Unicode y InStrB ya no se admite.All Visual Basic 2005 strings are in Unicode, and InStrB is no longer supported.

La configuración del argumento Compare es:The Compare argument settings are:

ConstanteConstant ValorValue DescripciónDescription
Binary 00 Realiza una comparación binariaPerforms a binary comparison
Text 11 Realiza una comparación de textoPerforms a text comparison

Consulte también:

InStr(String, String, CompareMethod)

Devuelve un entero que especifica la posición inicial de la primera aparición de una cadena dentro de otra.Returns an integer specifying the start position of the first occurrence of one string within another.

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

Obligatorio.Required. Expresión de tipo String en la que se va a buscar.String expression being searched.

String2
String

Obligatorio.Required. Expresión de tipo String que se va a buscar.String expression sought.

Compare
CompareMethod

Opcional.Optional. Especifica el tipo de comparación de cadenas.Specifies the type of string comparison. Si se omite Compare, la configuración de Option Compare determina el tipo de comparación.If Compare is omitted, the Option Compare setting determines the type of comparison.

Devoluciones

SiIf InStr devuelveInStr returns
String1 es de longitud cero o Nothing String1 is zero length or Nothing 00
String2 es de longitud cero o Nothing String2 is zero length or Nothing La posición inicial para la búsqueda, que establece como valor predeterminado a la posición del primer carácter.The starting position for the search, which defaults to the first character position.
No se encuentra String2. String2 is not found 00
String2 se encuentra dentro de String1. String2 is found within String1 Posición donde empieza la coincidenciaPosition where match begins
..

Ejemplos

En este ejemplo se usa la función InStr para devolver la posición de la primera aparición de una cadena dentro de otra.This example uses the InStr function to return the position of the first occurrence of one string within another.

' 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 función InStr se utiliza al analizar cadenas.Typically, the InStr function is used when parsing strings.

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.The InStrB function in previous versions of Visual Basic returns a number of bytes rather than a character position. Se usa principalmente para convertir cadenas en aplicaciones de juegos de caracteres de doble byte (DBCS).It is used primarily for converting strings in double-byte character set (DBCS) applications. Todas Visual Basic cadenas 2005 están en Unicode y InStrB ya no se admite.All Visual Basic 2005 strings are in Unicode, and InStrB is no longer supported.

La configuración del argumento Compare es:The Compare argument settings are:

ConstanteConstant ValorValue DescripciónDescription
Binary 00 Realiza una comparación binariaPerforms a binary comparison
Text 11 Realiza una comparación de textoPerforms a text comparison

Consulte también:

Se aplica a