diff options
| author | Mario Visic <mario@mariovisic.com> | 2013-04-14 17:00:19 +1000 |
|---|---|---|
| committer | Mario Visic <mario@mariovisic.com> | 2013-04-15 10:03:39 +1000 |
| commit | 3b2af1b8ce0cff8de786fec200730afb439d9dcd (patch) | |
| tree | d842c1130ab5222a1c656b3cb665420efe7cf5d8 /activerecord/lib/active_record/associations.rb | |
| parent | 130d3a06ade83aec27cf1d2ff841dce9e0ad4dfd (diff) | |
| download | rails-3b2af1b8ce0cff8de786fec200730afb439d9dcd.tar.gz rails-3b2af1b8ce0cff8de786fec200730afb439d9dcd.tar.bz2 rails-3b2af1b8ce0cff8de786fec200730afb439d9dcd.zip | |
Document collection.create! on has_many associations in ActiveRecord
Diffstat (limited to 'activerecord/lib/active_record/associations.rb')
| -rw-r--r-- | activerecord/lib/active_record/associations.rb | 4 |
1 files changed, 4 insertions, 0 deletions
diff --git a/activerecord/lib/active_record/associations.rb b/activerecord/lib/active_record/associations.rb index 3c92e379f1..5e5995f566 100644 --- a/activerecord/lib/active_record/associations.rb +++ b/activerecord/lib/active_record/associations.rb @@ -1073,6 +1073,9 @@ module ActiveRecord # with +attributes+, linked to this object through a foreign key, and that has already # been saved (if it passed the validation). *Note*: This only works if the base model # already exists in the DB, not if it is a new (unsaved) record! + # [collection.create!(attributes = {})] + # Does the same as <tt>collection.create</tt>, but raises <tt>ActiveRecord::RecordInvalid</tt> + # if the record is invalid. # # (*Note*: +collection+ is replaced with the symbol passed as the first argument, so # <tt>has_many :clients</tt> would add among others <tt>clients.empty?</tt>.) @@ -1094,6 +1097,7 @@ module ActiveRecord # * <tt>Firm#clients.exists?(name: 'ACME')</tt> (similar to <tt>Client.exists?(name: 'ACME', firm_id: firm.id)</tt>) # * <tt>Firm#clients.build</tt> (similar to <tt>Client.new("firm_id" => id)</tt>) # * <tt>Firm#clients.create</tt> (similar to <tt>c = Client.new("firm_id" => id); c.save; c</tt>) + # * <tt>Firm#clients.create!</tt> (similar to <tt>c = Client.new("firm_id" => id); c.save!</tt>) # The declaration can also include an options hash to specialize the behavior of the association. # # === Options |