array_index_of() (индекс массива)

Переключайте службы с помощью раскрывающегося списка Версия. Дополнительные сведения о навигации.
Область применения: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

Выполняет поиск массива для указанного элемента и возвращает его положение.

Синтаксис

array_index_of( значение массива,[ [ длина, ]]],

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

Параметры

Имя (название) Тип Обязательно Описание
array. dynamic ✔️ Массив для поиска.
значение long, int, datetime, timepan, string, guid или bool ✔️ Значение для поиска.
Начало int Позиция начала поиска. Отрицательное значение смещает начальное значение поиска с конца массива, abs(выполнив действия.)
длина int Количество проверяемых значений. Значение -1 означает неограниченную длину.
происшествие int Число вхождения. Значение по умолчанию — 1.

Возвраты

Возвращает позицию отсчитываемого индекса от нуля. Возвращает значение -1, если значение не найдено в массиве. Возвращает значение NULL для неуместных входных данных (вхождение< 0 или длина< -1).

Примеры

В следующем примере показано количество позиций определенных слов в массиве.

let arr=dynamic(["this", "is", "an", "example", "an", "example"]);
print
 idx1 = array_index_of(arr,"an")    // lookup found in input string
 , idx2 = array_index_of(arr,"example",1,3) // lookup found in researched range 
 , idx3 = array_index_of(arr,"example",1,2) // search starts from index 1, but stops after 2 values, so lookup can't be found
 , idx4 = array_index_of(arr,"is",2,4) // search starts after occurrence of lookup
 , idx5 = array_index_of(arr,"example",2,-1)  // lookup found
 , idx6 = array_index_of(arr, "an", 1, -1, 2)   // second occurrence found in input range
 , idx7 = array_index_of(arr, "an", 1, -1, 3)   // no third occurrence in input array
 , idx8 = array_index_of(arr, "an", -3)   // negative start index will look at last 3 elements
 , idx9 = array_index_of(arr, "is", -4)   // negative start index will look at last 3 elements

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

IDX1 idx2 IDX3 idx4 ИДХ5 ИДХ6 idx7 ИДХ8 ИДХ9
2 3 -1 -1 3 4 -1 4 -1

Используйте set_has_element(arr), value чтобы проверить, существует ли значение в массиве. Эта функция улучшит удобочитаемость запроса. Обе функции имеют одинаковую производительность.