Compartir vía


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. 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
Source:
Strings.vb
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 StartPos, string? String1, string? String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
public static int InStr (int Start, string? String1, string? String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
public static int InStr (int StartPos, string String1, string String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
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
static member InStr : int * string * string * Microsoft.VisualBasic.CompareMethod -> int
Public Function InStr (StartPos As Integer, String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As Integer
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

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

SiInStr devuelve
String1 es de longitud cero o Nothing0
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 String10

Excepciones

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

Se aplica a

InStr(String, String, CompareMethod)

Source:
Strings.vb
Source:
Strings.vb
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);
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

SiInStr devuelve
String1 es de longitud cero o Nothing0
String2 es de longitud cero o NothingLa 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

Se aplica a