Rotates the sequence by a given number of rotations

# Ds\Sequence::rotate

(PECL ds >= 1.0.0)

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

### Beschreibung

abstract public function 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, then 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