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 StartPos, 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.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 deString1
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 InStr función se utiliza al analizar cadenas.Typically, the InStr function is used when parsing strings.
Nota
La InStrB función de las 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 las cadenas Visual Basic 2005 están en Unicode y ya InStrB no se admiten.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
- InStrRev(String, String, Int32, CompareMethod)
- StrComp(String, String, CompareMethod)
- ArgumentException
- Cadenas en Visual BasicStrings in Visual Basic
- Introducción a las cadenas en Visual BasicIntroduction to Strings in Visual Basic
- Option Compare (Instrucción)Option Compare Statement
Se aplica a
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);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.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 coincidencia.Position 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 InStr función se utiliza al analizar cadenas.Typically, the InStr function is used when parsing strings.
Nota
La InStrB función de las 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 las cadenas Visual Basic 2005 están en Unicode y ya InStrB no se admiten.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
- InStrRev(String, String, Int32, CompareMethod)
- StrComp(String, String, CompareMethod)
- ArgumentException
- Cadenas en Visual BasicStrings in Visual Basic
- Introducción a las cadenas en Visual BasicIntroduction to Strings in Visual Basic
- Option Compare (Instrucción)Option Compare Statement