Strings.InStr Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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
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)
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
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)