Поделиться через


Strings.InStr Метод

Определение

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

Перегрузки

InStr(Int32, String, String, CompareMethod)

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

InStr(String, String, CompareMethod)

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

InStr(Int32, String, String, CompareMethod)

Исходный код:
Strings.vb
Исходный код:
Strings.vb
Исходный код:
Strings.vb

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

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

Параметры

StartStartPos
Int32

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

String1
String

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

String2
String

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

Compare
CompareMethod

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

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

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

Исключения

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 Выполняет сравнение текста

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

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

InStr(String, String, CompareMethod)

Исходный код:
Strings.vb
Исходный код:
Strings.vb
Исходный код:
Strings.vb

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

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

Параметры

String1
String

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

String2
String

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

Compare
CompareMethod

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

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

IfInStr возвращает
Параметр String1 является пустой строкой или значением Nothing0
Параметр 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 Выполняет сравнение текста

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

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