array_shift_right() (сдвиг массива вправо)

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

Сдвигает значения внутри динамического массива вправо.

Синтаксис

array_shift_right( массив, shift_count [,default_value ])

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

Параметры

Имя (название) Тип Обязательно Описание
array. dynamic ✔️ Массив для перемещения.
shift_count int ✔️ Количество позиций, которые элементы массива перемещаются вправо. Если значение отрицательное, элементы перемещаются влево.
default_value скаляр Значение, используемое для элемента, который был смещен и удален. Значение по умолчанию равно NULL или пустой строке в зависимости от типа элементов в массиве.

Возвраты

Возвращает динамический массив, содержащий тот же объем элементов, что и в исходном массиве. Каждый элемент был смещен в соответствии с shift_count. Новые элементы, добавленные вместо удаленных элементов, имеют значение default_value.

Примеры

В следующем примере показано перемещение вправо двумя позициями:

print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_right(arr, 2)

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

arr arr_shift
[1,2,3,4,5] [null,null,1,2,3]

В следующем примере показано перемещение вправо на две позиции и добавление значения по умолчанию:

print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_right(arr, 2, -1)

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

arr arr_shift
[1,2,3,4,5] [-1,-1,1,2,3]

В следующем примере показано перемещение влево двумя позициями с помощью отрицательного shift_count значения:

print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_right(arr, -2, -1)

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

arr arr_shift
[1,2,3,4,5] [3,4,5,-1,-1]
  • Чтобы переместить массив влево, используйте array_shift_left().
  • Чтобы повернуть массив справа, используйте array_rotate_right().
  • Чтобы повернуть массив слева, используйте array_rotate_left().