Freigeben über


array_shift_right() (Array nach rechts verschieben)

Gilt für: ✅Microsoft Fabric

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
Anordnung dynamic ✔️ Das Array, das verschoben werden soll.
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 Skalarwert Der wert, der für ein Element verwendet wurde, 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 nach shift_count verschoben. Neue Elemente, die anstelle der entfernten Elemente hinzugefügt werden, weisen einen Wert von default_value auf.

Beispiele

Das folgende Beispiel zeigt, dass sie um zwei Positionen nach rechts verschoben werden:

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]

Das folgende Beispiel zeigt, wie Sie um zwei Positionen nach rechts wechseln und einen Standardwert hinzufügen:

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]

Im folgenden Beispiel wird gezeigt, dass sie um zwei Positionen nach links verschoben werden, indem sie einen negativen shift_count Wert verwenden:

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]