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


indexof()

Область применения: ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

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

Дополнительные сведения см. в разделе indexof_regex().

Синтаксис

indexof(Вхождение строкового,совпадения[,начальной длины[,[,]]])

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

Параметры

Имя (название) Type Обязательно Описание
string string ✔️ Исходная строка для поиска.
match string ✔️ Строка, для которой выполняется поиск.
Начало int Позиция начала поиска. Отрицательное значение смещает начальную позицию поиска с конца строки следующими многими шагами: abs(начало).
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