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 -> intstatic member InStr : int * string * string * Microsoft.VisualBasic.CompareMethod -> intPublic Function InStr (StartPos As Integer, String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As IntegerPublic Function InStr (Start As Integer, String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As IntegerPará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 -> intPublic Function InStr (String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As IntegerPará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)
