(PECL ds >= 1.0.0)
Ds\Sequence::rotate — Rotates the sequence by a given number of rotations.
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.
The number of times the sequence should be rotated.
No value is returned.. The sequence of the current instance will be rotated.
Example #1 Ds\Sequence::rotate() example
$sequence = new \Ds\Vector(["a", "b", "c", "d"]);
$sequence->rotate(1); // "a" is shifted, then pushed.
$sequence->rotate(2); // "b" and "c" are both shifted, the pushed.
The above example will output something similar to:
(  => b  => c  => d  => a ) Ds\Vector Object (  => d  => a  => b  => c )