array_shift_right()

Verschiebt die Werte innerhalb eines dynamischen Arrays nach rechts.

Syntax

array_shift_right(Array, shift_count [,default_value ])

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Typ Erforderlich BESCHREIBUNG
array dynamic ✔️ Das zu verschiebende Array.
shift_count int ✔️ Die Anzahl der Positionen, die Arrayelemente nach rechts verschoben werden. Wenn der Wert negativ ist, werden die Elemente nach links verschoben.
default_value Skalar Der Wert, der für ein Element verwendet wird, das verschoben und entfernt wurde. Der Standardwert ist NULL oder eine leere Zeichenfolge, abhängig vom Typ der Elemente im Array.

Gibt zurück

Gibt ein dynamisches Array zurück, das die gleiche Menge der Elemente wie im ursprünglichen Array enthält. Jedes Element wurde gemäß shift_count verschoben. Neue Elemente, die anstelle der entfernten Elemente hinzugefügt werden, weisen den Wert default_value auf.

Beispiele

Um zwei Positionen nach rechts verschoben:

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

Ausgabe

Arr arr_shift
[1,2,3,4,5] [null,null;1,2,3]

Verschieben nach rechts um zwei Positionen und Hinzufügen eines Standardwerts:

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

Ausgabe

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

Um zwei Positionen nach links verschieben, indem ein negativer shift_count Wert verwendet wird:

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

Ausgabe

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