instance method `<<`

Ruby on Rails 5.2.8.1

Since v4.0.13

Available in: v4.0.13 v4.1.16 v4.2.9 v5.2.8.1 v6.0.6 v6.1.7.10 v7.0.10 v7.1.6 v7.2.3 v8.0.4 v8.1.2

Compare with:

<<(*records)

Adds one or more records to the collection by setting their foreign keys to the association’s primary key. Since +<<+ flattens its argument list and inserts each record, push and concat behave identically. Returns self so several appends may be chained together.

class Person < ActiveRecord::Base
  has_many :pets
end

person.pets.size # => 0
person.pets << Pet.new(name: 'Fancy-Fancy')
person.pets << [Pet.new(name: 'Spook'), Pet.new(name: 'Choo-Choo')]
person.pets.size # => 3

person.id # => 1
person.pets
# => [
#      #<Pet id: 1, name: "Fancy-Fancy", person_id: 1>,
#      #<Pet id: 2, name: "Spook", person_id: 1>,
#      #<Pet id: 3, name: "Choo-Choo", person_id: 1>
#    ]

Parameters

records rest

Source

# File activerecord/lib/active_record/associations/collection_proxy.rb, line 1028
      def <<(*records)
        proxy_association.concat(records) && self
      end

Defined in activerecord/lib/active_record/associations/collection_proxy.rb line 1028 · View on GitHub · Improve this page · Find usages on GitHub

Defined in ActiveRecord::Associations::CollectionProxy

Signature

Parameters