Bug #2100: Array#shift の説明
http://redmine.ruby-lang.org/issues/show/2100

起票者: 5 5
ステータス: Open, 優先度: Normal
カテゴリ: doc
reporter: 5.5, ruby_version: 1.8, 1.9

Array#shift の説明で，引数 n を与えたときに self.size<n だったらどうなるのかが書かれていません。
また，自身が空のとき，引数を与えなかった場合と引数が 1 の場合の違いが書いてありません。
p [].shift    # => nil
p [].shift(1) # => []
（つまり「自身が空配列の時は nil を返します。」は後者では間違いです）

なお，[PARAM] n: で，「整数で指定します」よりも「非負整数で指定します」がよいと思います。


----------------------------------------
http://redmine.ruby-lang.org

--
ML: ruby-reference-manual@m...
使い方: http://QuickML.com/