indexof()
Область применения: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft 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 |