[DOC] Array doc (#10199)

This commit is contained in:
Burdette Lamar 2024-03-13 13:50:18 -05:00 committed by GitHub
parent 2cfcebb2a8
commit 76f9cfd0b9
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

25
array.c
View File

@ -2294,6 +2294,31 @@ ary_aset_by_rb_ary_splice(VALUE ary, long beg, long len, VALUE val)
*
* Assigns elements in +self+; returns the given +object+.
*
* In brief:
*
* a_orig = [:foo, 'bar', 2]
* # With argument index.
* a = a_orig.dup
* a[0] = 'foo' # => "foo"
* a # => ["foo", "bar", 2]
* a = a_orig.dup
* a[7] = 'foo' # => "foo"
* a # => [:foo, "bar", 2, nil, nil, nil, nil, "foo"]
* # With arguments start and length.
* a = a_orig.dup
* a[0, 2] = 'foo' # => "foo"
* a # => ["foo", 2]
* a = a_orig.dup
* a[6, 50] = 'foo' # => "foo"
* a # => [:foo, "bar", 2, nil, nil, nil, "foo"]
* # With argument range.
* a = a_orig.dup
* a[0..1] = 'foo' # => "foo"
* a # => ["foo", 2]
* a = a_orig.dup
* a[6..50] = 'foo' # => "foo"
* a # => [:foo, "bar", 2, nil, nil, nil, "foo"]
*
* When Integer argument +index+ is given, assigns +object+ to an element in +self+.
*
* If +index+ is non-negative, assigns +object+ the element at offset +index+: