Strings.InStr Метод

Определение

Пространство имен:

Microsoft.VisualBasic

Сборка:

Microsoft.VisualBasic.Core.dll

Возвращает целое число, указывающее начальную позицию первого вхождения одной строки в другую. Целое число представляет собой отсчитываемый от единицы индекс, если совпадение найдено. Если совпадение не найдено, функция возвращает нуль.

Перегрузки

InStr(Int32, String, String, CompareMethod)	Возвращает целое число, указывающее начальную позицию первого вхождения одной строки в другую.
InStr(String, String, CompareMethod)	Возвращает целое число, указывающее начальную позицию первого вхождения одной строки в другую.

InStr(Int32, String, String, CompareMethod)

Исходный код:

Strings.vb

Возвращает целое число, указывающее начальную позицию первого вхождения одной строки в другую.

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

Необязательный элемент. Числовое выражение, задающее начальную позицию для каждого поиска. Если это выражение опущено, поиск начинается с позиции первого знака. Начальный индекс равен 1.

String1

String

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

String2

String

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

Compare

CompareMethod

Необязательный элемент. Указывает тип сравнения строк. Если параметр Compare не задан, параметр Option Compare определяет тип сравнения.

Возвращаемое значение

Int32

If	InStr возвращает
Параметр String1 является пустой строкой или значением Nothing	0
Параметр String2 является пустой строкой или значением Nothing	start
Параметр String2 не найден.	0
String2 находится в пределах String1	Позиция, где начинается соответствие
Длина Start> параметра String1	0

Исключения

ArgumentException

Start< 1.

Примеры

В данном примере функция InStr используется для возврата позиции первого вхождения одной строки в другую.

' 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 функция используется при анализе строк.

Примечание

Функция InStrB в предыдущих версиях Visual Basic возвращает количество байтов, а не позицию символа. Он используется в основном для преобразования строк в приложениях с двухбайтовыми символами (DBCS). Все строки Visual Basic 2005 находятся в Юникоде и InStrB больше не поддерживаются.

Параметры аргумента Compare:

Константа	Значение	Описание
Binary	0	Выполняет двоичное сравнение
Text	1	Выполняет сравнение текста

См. также раздел

• InStrRev(String, String, Int32, CompareMethod)
• StrComp(String, String, CompareMethod)
• ArgumentException
• Строки в Visual Basic
• Знакомство со строками в Visual Basic
• Оператор Option Compare

InStr(String, String, CompareMethod)

Исходный код:

Strings.vb

Возвращает целое число, указывающее начальную позицию первого вхождения одной строки в другую.

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.

String2

String

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

Compare

CompareMethod

Необязательный элемент. Указывает тип сравнения строк. Если параметр Compare не задан, параметр Option Compare определяет тип сравнения.

Возвращаемое значение

Int32

If	InStr возвращает
Параметр String1 является пустой строкой или значением Nothing	0
Параметр String2 является пустой строкой или значением Nothing	Начальная позиция диапазона для поиска, которая по умолчанию в первом положении символа.
Параметр String2 не найден.	0
String2 находится в пределах String1	Позиция, где начинается соответствие.

Примеры

В данном примере функция InStr используется для возврата позиции первого вхождения одной строки в другую. В первом примере поиск начинается с четвертого символа и возвращает следующую строчную букву "p", так как CompareMethod имеет и, следовательно, регистр не учитывается Text . Позиция всегда относительно начала строки, независимо от начальной позиции.

' 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 функция используется при анализе строк.

Примечание

Функция InStrB в предыдущих версиях Visual Basic возвращает количество байтов, а не позицию символа. Он используется в основном для преобразования строк в приложениях с двухбайтовыми символами (DBCS). Все строки Visual Basic 2005 находятся в Юникоде и InStrB больше не поддерживаются.

Параметры аргумента Compare:

Константа	Значение	Описание
Binary	0	Выполняет двоичное сравнение
Text	1	Выполняет сравнение текста

См. также раздел

• InStrRev(String, String, Int32, CompareMethod)
• StrComp(String, String, CompareMethod)
• ArgumentException
• Строки в Visual Basic
• Знакомство со строками в Visual Basic
• Оператор Option Compare