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

### 説明

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.

### パラメータ

`rotations`

  The number of times the sequence should be rotated.

### 返り値

値を返しません。. The sequence of the current instance will be rotated.

### 例

例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);
?>`

上の例の出力は、 たとえば以下のようになります。

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