# Ds\Sequence::rotate

(PECL ds >= 1.0.0)

Ds\Sequence::rotate — Rotates the sequence by a given number of rotations

### Beschreibung

abstract public Ds\Sequence::rotate(int `$rotations`): void

Rotates the sequence by a given number of rotations, which is equivalent to successively calling `$sequence->push($sequence->shift())` if the number of rotations is positive, or `$sequence->unshift($sequence->pop())` if negative.

### Parameter-Liste

`rotations`

  The number of times the sequence should be rotated.

### Rückgabewerte

Es wird kein Wert zurückgegeben.. The sequence of the current instance will be rotated.

### Beispiele

Beispiel #1 Ds\Sequence::rotate() example

`<?php
$sequence = new \Ds\Vector(["a", "b", "c", "d"]);
$sequence->rotate(1); // "a" is shifted, then pushed.
print_r($sequence);
$sequence->rotate(2); // "b" and "c" are both shifted, the pushed.
print_r($sequence);
?>`

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

    (
        [0] => b
        [1] => c
        [2] => d
        [3] => a
    )
    Ds\Vector Object
    (
        [0] => d
        [1] => a
        [2] => b
        [3] => c
    )

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open