Функция InStrInStr function

Возвращает значение типа Variant (Long), определяющее положение первого вхождения одной строки в другую.Returns a Variant (Long) specifying the position of the first occurrence of one string within another.

Примечание

Хотите создавать решения, которые расширяют возможности Office на разнообразных платформах?Interested in developing solutions that extend the Office experience across multiple platforms? Ознакомьтесь с новой моделью надстроек Office.Check out the new Office Add-ins model. Надстройки Office занимают меньше места по сравнению с надстройками и решениями VSTO, и вы можете создавать их, используя практически любую технологию веб-программирования, например HTML5, JavaScript, CSS3 и XML.Office Add-ins have a small footprint compared to VSTO Add-ins and solutions, and you can build them by using almost any web programming technology, such as HTML5, JavaScript, CSS3, and XML.

СинтаксисSyntax

InStr([ начало ], строка1, строка2, [ сравнение ])InStr([ start ], string1, string2, [ compare ])


В синтаксисе функции InStr используются следующие аргументы:The InStr function syntax has these arguments:

ЧастьPart ОписаниеDescription
началоstart Необязательно.Optional. Числовое выражение, которое задает начальную точку для поиска.Numeric expression that sets the starting position for each search. Если этот аргумент опущен, поиск начинается с первого знака строки.If omitted, search begins at the first character position. Если аргумент начало содержит значение Null, возникает ошибка.If start contains Null, an error occurs. Аргумент начало является обязательным, если задан аргумент сравнение.The start argument is required if compare is specified.
строка1string1 Обязательно.Required. Строковое выражение, поиск в котором выполняется.String expression being searched.
строка2string2 Обязательно.Required. Искомое строковое выражение.String expression sought.
сравнениеcompare Необязательно.Optional. Определяет тип сравнения строк.Specifies the type of string comparison. Если аргумент сравнение содержит значение Null, возникает ошибка.If compare is Null, an error occurs. Если аргумент сравнение опущен, тип сравнения определяется параметром Option Compare.If compare is omitted, the Option Compare setting determines the type of comparison. Укажите допустимый LCID (код языка), чтобы использовать для сравнения правила, определяемые языковым стандартом.Specify a valid LCID (LocaleID) to use locale-specific rules in the comparison.

ПараметрыSettings

Аргумент сравнение может принимать следующие значения:The compare argument settings are as follows.

КонстантаConstant ЗначениеValue ОписаниеDescription
vbUseCompareOptionvbUseCompareOption –1-1 Выполняется сравнение с помощью параметра оператора Option Compare.Performs a comparison by using the setting of the Option Compare statement.
vbBinaryComparevbBinaryCompare 00 Выполняется двоичное сравнение.Performs a binary comparison.
vbTextComparevbTextCompare 11 Выполняется текстовое сравнение.Performs a textual comparison.
vbDatabaseComparevbDatabaseCompare 22 Только Microsoft Access.Microsoft Access only. Выполняется сравнение на основе сведений из базы данных.Performs a comparison based on information in your database.

Возвращаемые значенияReturn values

ЕслиIf Возвращаемое значениеInStr returns
строка1 является пустойstring1 is zero-length 00
строка1 равна Nullstring1 is Null NullNull
строка2 является пустойstring2 is zero-length началоstart
строка2 равна Nullstring2 is Null NullNull
строка2 не найденаstring2 is not found 00
строка2 найдена в строке1string2 is found within string1 Позиция найденного соответствияPosition at which match is found
начало > строка2start > string2 00

ПримечанияRemarks

Функция InStrB используется с байтовыми данными, содержащимися в строке.The InStrB function is used with byte data contained in a string. Функция InStrB возвращает позицию байта, а не позицию знака первого вхождения одной строки в другую.Instead of returning the character position of the first occurrence of one string within another, InStrB returns the byte position.

ПримерExample

В данном примере функция InStr используется для получения позиции первого вхождения одной строки в другую.This example uses the InStr function to return the position of the first occurrence of one string within another.

Dim SearchString, SearchChar, MyPos
SearchString ="XXpXXpXXPXXP"    ' String to search in.
SearchChar = "P"    ' Search for "P".

' A textual comparison starting at position 4. Returns 6.
MyPos = Instr(4, SearchString, SearchChar, 1)    

' A binary comparison starting at position 1. Returns 9.
MyPos = Instr(1, SearchString, SearchChar, 0)

' Comparison is binary by default (last argument is omitted).
MyPos = Instr(SearchString, SearchChar)    ' Returns 9.

MyPos = Instr(1, SearchString, "W")    ' Returns 0.

См. такжеSee also

Поддержка и обратная связьSupport and feedback

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи?Have questions or feedback about Office VBA or this documentation? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.