Ruby 2.1.0 リファレンスマニュアル > ライブラリ一覧 > 組み込みライブラリ > Arrayクラス > rotate

instance method Array#rotate

rotate(cnt = 1) -> Array[permalink][rdoc]

cnt で指定したインデックスの要素が先頭になる配列を新しく作成します。 cnt より前の要素は末尾に移動します。cnt に負の数を指定した場合、逆の操 作を行います。

[PARAM] cnt:

先頭にする要素のインデックスを指定します。指定しなかった場合 は 1 になります。 整数以外のオブジェクトを指定した場合は to_int メソッドによる 暗黙の型変換を試みます。

[EXCEPTION] TypeError:

引数に整数以外の(暗黙の型変換が行えない)オブジェクトを 指定した場合に発生します。

例:

a = [ "a", "b", "c", "d" ]
a.rotate         # => ["b", "c", "d", "a"]
a                # => ["a", "b", "c", "d"]
a.rotate(2)      # => ["c", "d", "a", "b"]
a.rotate(-1)     # => ["d", "a", "b", "c"]
a.rotate(-3)     # => ["b", "c", "d", "a"]

[SEE_ALSO] Array#rotate!