From: Urabe Shyouhei <shyouhei@...>
Date: 2007-08-28T17:46:46+09:00
Subject: [ruby-list:43951] Re: Array#insert  	のリファレンス

Satoshi Nakagawa wrote:
> リファレンスマニュアルの Array#insert の記述が実際の動作と
> 異なるようです。

うーん、たしかにこの記述が分かりやすいかといわれれば違うのかもしれま
せん、改善の余地は無論大いにあるでしょう。しかし

>   インデックス nth の要素の直前に第 2 引数以降の値を挿入します。

以下のような振る舞いを見ていただくと「インデックス nth」が何を意図し
ていたかはわかっていただけるのではないでしょうか。

irb(main):001:0> a = [1, 2, 3]
=> [1, 2, 3]
irb(main):002:0> [3, 2, 1, 0, -1, -2, -3, -4].each {|i|
irb(main):003:1*    p a[i]
irb(main):004:1> }
nil
3
2
1
3
2
1
nil
=> [3, 2, 1, 0, -1, -2, -3, -4]