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

instance method Array#rotate!

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

cnt で指定したインデックスの要素が先頭になるように自身の順番を変更しま す。cnt より前の要素は末尾に移動します。cnt に負の数を指定した場合、逆 の操作を行います。

[PARAM] cnt:

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

[EXCEPTION] TypeError:

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

例:

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

[SEE_ALSO] Array#rotate