From d2361ba156af1be20469bfd2a2e1dda21d48f375 Mon Sep 17 00:00:00 2001 From: BurdetteLamar Date: Wed, 14 Aug 2024 22:06:34 +0100 Subject: [PATCH] [DOC] Tweaks for Array#push --- array.c | 20 +++++++++----------- 1 file changed, 9 insertions(+), 11 deletions(-) diff --git a/array.c b/array.c index 1fa588b8ab..92091008c9 100644 --- a/array.c +++ b/array.c @@ -1395,22 +1395,20 @@ rb_ary_cat(VALUE ary, const VALUE *argv, long len) /* * call-seq: - * array.push(*objects) -> self + * push(*objects) -> self + * append(*objects) -> self * - * Appends trailing elements. + * Appends each argument in +objects+ to +self+; returns +self+: * - * Appends each argument in +objects+ to +self+; returns +self+: + * a = [:foo, 'bar', 2] # => [:foo, "bar", 2] + * a.push(:baz, :bat) # => [:foo, "bar", 2, :baz, :bat] * - * a = [:foo, 'bar', 2] - * a.push(:baz, :bat) # => [:foo, "bar", 2, :baz, :bat] + * Appends each argument as a single element, even if it is another array: * - * Appends each argument as one element, even if it is another +Array+: + * a = [:foo, 'bar', 2] # => [:foo, "bar", 2] + a.push([:baz, :bat], [:bam, :bad]) # => [:foo, "bar", 2, [:baz, :bat], [:bam, :bad]] * - * a = [:foo, 'bar', 2] - * a1 = a.push([:baz, :bat], [:bam, :bad]) - * a1 # => [:foo, "bar", 2, [:baz, :bat], [:bam, :bad]] - * - * Related: #pop, #shift, #unshift. + * Related: Array#pop, Array#shift, Array#unshift. */ static VALUE