Strings.InStr Strings.InStr Strings.InStr Method

Определение

Возвращает целое число, указывающее начальную позицию первого вхождения одной строки в другую.Returns an integer specifying the start position of the first occurrence of one string within another. Целое число представляет собой отсчитываемый от единицы индекс, если совпадение найдено.The integer is a one-based index if a match is found. Если совпадение не найдено, функция возвращает нуль.If no match is found, the function returns zero.

Перегрузки

InStr(Int32, String, String, CompareMethod) InStr(Int32, String, String, CompareMethod) InStr(Int32, String, String, CompareMethod)

Возвращает целое число, указывающее начальную позицию первого вхождения одной строки в другую.Returns an integer specifying the start position of the first occurrence of one string within another.

InStr(String, String, CompareMethod) InStr(String, String, CompareMethod) InStr(String, String, CompareMethod)

Возвращает целое число, указывающее начальную позицию первого вхождения одной строки в другую.Returns an integer specifying the start position of the first occurrence of one string within another.

InStr(Int32, String, String, CompareMethod) InStr(Int32, String, String, CompareMethod) InStr(Int32, String, String, CompareMethod)

Возвращает целое число, указывающее начальную позицию первого вхождения одной строки в другую.Returns an integer specifying the start position of the first occurrence of one string within another.

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

Параметры

Start
Int32 Int32 Int32

Необязательный параметр.Optional. Числовое выражение, задающее начальную позицию для каждого поиска.Numeric expression that sets the starting position for each search. Если это выражение опущено, поиск начинается с позиции первого знака.If omitted, search begins at the first character position. Начальный индекс равен 1.The start index is 1-based.

String1
String String String

Обязательный.Required. Искомое выражение типа String.String expression being searched.

String2
String String String

Обязательный.Required. Искомое выражение String.String expression sought.

Compare
CompareMethod CompareMethod CompareMethod

Необязательный параметр.Optional. Указывает тип сравнения строк.Specifies the type of string comparison. Если параметр Compare не задан, параметр Option Compare определяет тип сравнения.If Compare is omitted, the Option Compare setting determines the type of comparison.

Возвраты

IfIf InStr возвращаетInStr returns
Параметр String1 является пустой строкой или значением Nothing String1 is zero length or Nothing 00
Параметр String2 является пустой строкой или значением Nothing String2 is zero length or Nothing start
Параметр String2 не найден. String2 is not found 00
String2 находится в пределах String1 String2 is found within String1 Позиция, где начинается соответствиеPosition where match begins
Длина Start > параметра String1 Start > length of String1 00
..

Исключения

Примеры

В данном примере функция InStr используется для возврата позиции первого вхождения одной строки в другую.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")

Комментарии

Как правило, функция InStr используется при анализе строк.Typically, the InStr function is used when parsing strings.

Примечание

Функция InStrB в предыдущих версиях Visual Basic возвращает число байтов, а не позиции символа.The InStrB function in previous versions of Visual Basic returns a number of bytes rather than a character position. Он используется в основном для преобразования строк в приложениях с двухбайтовой кодировкой (DBCS).It is used primarily for converting strings in double-byte character set (DBCS) applications. Все строки Visual Basic 2005 в Юникоде, а InStrB больше не поддерживаются.All Visual Basic 2005 strings are in Unicode, and InStrB is no longer supported.

Параметры аргумента Compare:The Compare argument settings are:

КонстантаConstant ЗначениеValue ОписаниеDescription
Binary 00 Выполняет двоичное сравнениеPerforms a binary comparison
Text 11 Выполняет сравнение текстаPerforms a text comparison
Дополнительно

InStr(String, String, CompareMethod) InStr(String, String, CompareMethod) InStr(String, String, CompareMethod)

Возвращает целое число, указывающее начальную позицию первого вхождения одной строки в другую.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);
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

Параметры

String1
String String String

Обязательный.Required. Искомое выражение типа String.String expression being searched.

String2
String String String

Обязательный.Required. Искомое выражение String.String expression sought.

Compare
CompareMethod CompareMethod CompareMethod

Необязательный параметр.Optional. Указывает тип сравнения строк.Specifies the type of string comparison. Если параметр Compare не задан, параметр Option Compare определяет тип сравнения.If Compare is omitted, the Option Compare setting determines the type of comparison.

Возвраты

IfIf InStr возвращаетInStr returns
Параметр String1 является пустой строкой или значением Nothing String1 is zero length or Nothing 00
Параметр String2 является пустой строкой или значением Nothing String2 is zero length or Nothing Начальная позиция диапазона для поиска, которая по умолчанию в первом положении символа.The starting position for the search, which defaults to the first character position.
Параметр String2 не найден. String2 is not found 00
String2 находится в пределах String1 String2 is found within String1 Позиция, где начинается соответствиеPosition where match begins
..

Примеры

В данном примере функция InStr используется для возврата позиции первого вхождения одной строки в другую.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")

Комментарии

Как правило, функция InStr используется при анализе строк.Typically, the InStr function is used when parsing strings.

Примечание

Функция InStrB в предыдущих версиях Visual Basic возвращает число байтов, а не позиции символа.The InStrB function in previous versions of Visual Basic returns a number of bytes rather than a character position. Он используется в основном для преобразования строк в приложениях с двухбайтовой кодировкой (DBCS).It is used primarily for converting strings in double-byte character set (DBCS) applications. Все строки Visual Basic 2005 в Юникоде, а InStrB больше не поддерживаются.All Visual Basic 2005 strings are in Unicode, and InStrB is no longer supported.

Параметры аргумента Compare:The Compare argument settings are:

КонстантаConstant ЗначениеValue ОписаниеDescription
Binary 00 Выполняет двоичное сравнениеPerforms a binary comparison
Text 11 Выполняет сравнение текстаPerforms a text comparison
Дополнительно

Применяется к