array_shift_right()

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

Синтаксис

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

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

Параметры

Имя (название)	Type	Обязательно	Описание
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().