Strings.InStr Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает целое число, указывающее начальную позицию первого вхождения одной строки в другой. Целое число — это одноуровневый индекс, если совпадение найдено. Если совпадение не найдено, функция возвращает ноль.
Перегрузки
| Имя | Описание |
|---|---|
| InStr(Int32, String, String, CompareMethod) |
Возвращает целое число, указывающее начальную позицию первого вхождения одной строки в другой. |
| InStr(String, String, CompareMethod) |
Возвращает целое число, указывающее начальную позицию первого вхождения одной строки в другой. |
InStr(Int32, String, String, CompareMethod)
- Исходный код:
- Strings.vb
- Исходный код:
- Strings.vb
- Исходный код:
- Strings.vb
- Исходный код:
- Strings.vb
- Исходный код:
- Strings.vb
Возвращает целое число, указывающее начальную позицию первого вхождения одной строки в другой.
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 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 (Start As Integer, String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As IntegerPublic Function InStr (StartPos As Integer, String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As IntegerПараметры
- StartStartPos
- Int32
Optional. Представляет собой числовое выражение, задающее начальную позицию для каждой операции поиска. Если аргумент не задан, поиск начинается с первого символа. Начальный индекс основан на 1.
- String1
- String
Обязательно.
String выражение, выполняемое поиском.
- String2
- String
Обязательно.
String искомый выражение.
- Compare
- CompareMethod
Optional. Указывает тип сравнения строк. Если Compare опущен, Option Compare параметр определяет тип сравнения.
Возвращаемое значение
| Если | Возвращаемое значение |
|---|---|
String1 имеет нулевую длину или Nothing | 0 |
String2 имеет нулевую длину или Nothing |
start
|
String2 не найден | 0 |
String2 находится в пределах String1 | Положение, где начинается совпадение |
Start
> длина String1 | 0 |
Исключения
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 функция используется при синтаксическом анализе строк.
Note
Функция InStrB в предыдущих версиях Visual Basic возвращает количество байтов, а не положение символов. Он используется в основном для преобразования строк в приложениях с двойным байтовым набором символов (DBCS). Все строки Visual Basic 2005 находятся в Юникоде, и InStrB больше не поддерживается.
Параметры Compare аргумента:
| Константа | Ценность | Description |
|---|---|---|
Binary |
0 | Выполняет двоичное сравнение |
Text |
1 | Выполняет сравнение текста |
См. также раздел
- InStrRev(String, String, Int32, CompareMethod)
- StrComp(String, String, CompareMethod)
- ArgumentException
- Strings в Visual Basic
- Знакомство со строками в Visual Basic
- Оператор "Сравнение параметров"
Применяется к
InStr(String, String, CompareMethod)
- Исходный код:
- Strings.vb
- Исходный код:
- Strings.vb
- Исходный код:
- 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 -> intPublic 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
Optional. Указывает тип сравнения строк. Если Compare опущен, Option Compare параметр определяет тип сравнения.
Возвращаемое значение
| Если | Возвращаемое значение |
|---|---|
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 функция используется при синтаксическом анализе строк.
Note
Функция InStrB в предыдущих версиях Visual Basic возвращает количество байтов, а не положение символов. Он используется в основном для преобразования строк в приложениях с двойным байтовым набором символов (DBCS). Все строки Visual Basic 2005 находятся в Юникоде, и InStrB больше не поддерживается.
Параметры Compare аргумента:
| Константа | Ценность | Description |
|---|---|---|
Binary |
0 | Выполняет двоичное сравнение |
Text |
1 | Выполняет сравнение текста |
См. также раздел
- InStrRev(String, String, Int32, CompareMethod)
- StrComp(String, String, CompareMethod)
- ArgumentException
- Strings в Visual Basic
- Знакомство со строками в Visual Basic
- Оператор "Сравнение параметров"
