diff options
author | Andrés Mejía <andmej@gmail.com> | 2011-09-06 02:02:28 -0500 |
---|---|---|
committer | Andrés Mejía <andmej@gmail.com> | 2011-09-06 02:02:28 -0500 |
commit | d03aff7f645bdc16eae35264bb0e95a0ab814d15 (patch) | |
tree | 285e39c47e80606b3deada1c2bf03b0a85e1fac4 /activerecord/lib/active_record | |
parent | ee822f257e2f3f3b571772f30ae3a8edd69538c3 (diff) | |
download | rails-d03aff7f645bdc16eae35264bb0e95a0ab814d15.tar.gz rails-d03aff7f645bdc16eae35264bb0e95a0ab814d15.tar.bz2 rails-d03aff7f645bdc16eae35264bb0e95a0ab814d15.zip |
Adding first example with no arguments to AR::Relation#first_or_create and removing examples that create several users at the same time (this is confusing and not really helpful).
Diffstat (limited to 'activerecord/lib/active_record')
-rw-r--r-- | activerecord/lib/active_record/relation.rb | 30 |
1 files changed, 15 insertions, 15 deletions
diff --git a/activerecord/lib/active_record/relation.rb b/activerecord/lib/active_record/relation.rb index 461237c7ad..849f01a047 100644 --- a/activerecord/lib/active_record/relation.rb +++ b/activerecord/lib/active_record/relation.rb @@ -99,32 +99,32 @@ module ActiveRecord # Expects arguments in the same format as <tt>Base.create</tt>. # # ==== Examples - # # Find the first user named Scarlett or create a new one. + # # Find the first user named Penélope or create a new one. + # User.where(:first_name => 'Penélope').first_or_create + # # => <User id: 1, first_name: 'Penélope', last_name: nil> + # + # # Find the first user named Penélope or create a new one. + # # We already have one so the existing record will be returned. + # User.where(:first_name => 'Penélope').first_or_create + # # => <User id: 1, first_name: 'Penélope', last_name: nil> + # + # # Find the first user named Scarlett or create a new one with a particular last name. # User.where(:first_name => 'Scarlett').first_or_create(:last_name => 'Johansson') - # # => <User id: 1, first_name: 'Scarlett', last_name: 'Johansson'> + # # => <User id: 2, first_name: 'Scarlett', last_name: 'Johansson'> # - # # Find the first user named Scarlett or create one with a different last name. - # # We already have one Scarlett, so she'll be returned. + # # Find the first user named Scarlett or create a new one with a different last name. + # # We already have one so the existing record will be returned. # User.where(:first_name => 'Scarlett').first_or_create do |user| # user.last_name = "O'Hara" # end - # # => <User id: 1, first_name: 'Scarlett', last_name: 'Johansson'> - # - # # Find the first user named Andy or create several at a time. - # User.where(:first_name => 'Andy').first_or_create([{:last_name => 'García'}, {:last_name => 'Mejía'}]) - # # => [#<User id: 2, first_name: 'Andy', last_name: 'García'>, - # #<User id: 3, first_name: 'Andy', last_name: 'Mejía'>] - # - # # Find the first user with last name García or create several at a time. - # User.where(:last_name => 'García').first_or_create([{:first_name => 'Jorge'}, {:first_name => 'Andy'}]) - # # => <User id: 2, first_name: 'Andy', last_name: 'García'> + # # => <User id: 2, first_name: 'Scarlett', last_name: 'Johansson'> def first_or_create(*args, &block) first || create(*args, &block) end # Like <tt>first_or_create</tt> but calls <tt>create!</tt> so an exception is raised if the created record is invalid. # - # Expects arguments in the same format as <tt>Base.create</tt>. + # Expects arguments in the same format as <tt>Base.create!</tt>. def first_or_create!(*args, &block) first || create!(*args, &block) end |