Strings.InStr Método

Definición

Espacio de nombres:

Microsoft.VisualBasic

Ensamblado:

Microsoft.VisualBasic.Core.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

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)

Source:

Strings.vb

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

Start

Int32

Opcional. 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 es de base 1.

String1

String

Obligatorio. Expresión de tipo String en la que se va a buscar.

String2

String

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

Compare

CompareMethod

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

Devoluciones

Int32

Si	InStr devuelve
String1 es de longitud cero o Nothing	0
String2 es de longitud cero o Nothing	start
No se encuentra String2.	0
String2 se encuentra dentro de String1.	Posición donde empieza la coincidencia
Start> longitud de String1	0

Excepciones

ArgumentException

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.

' 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 InStrB función de 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 de Visual Basic 2005 están en Unicode y InStrB ya no se admiten.

La configuración del argumento Compare es:

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

Consulte también

• InStrRev(String, String, Int32, CompareMethod)
• StrComp(String, String, CompareMethod)
• ArgumentException
• Cadenas en Visual Basic
• Introducción a las cadenas en Visual Basic
• Option Compare (instrucción)

InStr(String, String, CompareMethod)

Source:

Strings.vb

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

Obligatorio. Expresión de tipo String en la que se va a buscar.

String2

String

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

Compare

CompareMethod

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

Devoluciones

Int32

Si	InStr devuelve
String1 es de longitud cero o Nothing	0
String2 es de longitud cero o Nothing	La posición inicial para la búsqueda, que establece como valor predeterminado a la posición del primer carácter.
No se encuentra String2.	0
String2 se encuentra dentro de String1.	Posición donde empieza la coincidencia.

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. 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. 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 InStrB función de 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 de Visual Basic 2005 están en Unicode y InStrB ya no se admiten.

La configuración del argumento Compare es:

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

Consulte también

• InStrRev(String, String, Int32, CompareMethod)
• StrComp(String, String, CompareMethod)
• ArgumentException
• Cadenas en Visual Basic
• Introducción a las cadenas en Visual Basic
• Option Compare (instrucción)