indexof()

Сообщает отсчитываемый от нуля индекс первого вхождения указанной строки во входной строке.

Для получения дополнительной информации см. indexof_regex().

Синтаксис

indexof(Строка,Матч[,Начать[,Длина[,Вхождение]]])

Дополнительные сведения о соглашениях о синтаксисе.

Параметры

Имя	Тип	Обязательно	Описание
строка	string	✔️	Исходная строка для поиска.
Матч	string	✔️	Строка, по которой выполняется поиск.
start	int		Начальная позиция поиска. Отрицательное значение смещает начальную позицию поиска от конца строки следующими шагами: abs(start).
length	int		Количество позиций знаков для проверки. Значение -1 означает неограниченную длину.
occurrence	int		Число вхождения. Значение по умолчанию — 1.

Примечание

Если строка или совпадение не имеют типа string, функция принудительно приводит их значение к string.

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

Отсчитываемая от нуля позиция индекса соответствия.

• Возвращает значение -1, если совпадение не найдено в строке.
• Возвращает значение null , если:
  • значение start меньше 0.
  • Вхождение меньше 0.
  • длина меньше -1.

Примеры

Выполнить запрос

print
 idx1 = indexof("abcdefg","cde")    // lookup found in input string
 , idx2 = indexof("abcdefg","cde",1,4) // lookup found in researched range 
 , idx3 = indexof("abcdefg","cde",1,2) // search starts from index 1, but stops after 2 chars, so full lookup can't be found
 , idx4 = indexof("abcdefg","cde",3,4) // search starts after occurrence of lookup
 , idx5 = indexof("abcdefg","cde",-5)  // negative start index
 , idx6 = indexof(1234567,5,1,4)       // two first parameters were forcibly casted to strings "12345" and "5"
 , idx7 = indexof("abcdefg","cde",2,-1)  // lookup found in input string
 , idx8 = indexof("abcdefgabcdefg", "cde", 1, 10, 2)   // lookup found in input range
 , idx9 = indexof("abcdefgabcdefg", "cde", 1, -1, 3)   // the third occurrence of lookup is not in researched range

Выходные данные

idx1	idx2	idx3	idx4	idx5	idx6	idx7	idx8	idx9
2	2	-1	-1	2	4	2	9	-1