github/rails
1
1
Fork 0
mirror of https://github.com/github/rails.git synced 2026-04-26 03:00:59 -04:00
Code Issues Packages Projects Releases Wiki Activity

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).

Browse Source
This commit is contained in:
Andrés Mejía
2011-09-06 02:02:28 -05:00
parent ee822f257e
commit d03aff7f64
1 changed files with 16 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
activerecord/lib/active_record/relation.rb
View File

@@ -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.
# User.where(:first_name => 'Scarlett').first_or_create(:last_name => 'Johansson')
# # => <User id: 1, first_name: 'Scarlett', last_name: 'Johansson'>
# # 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 Scarlett or create one with a different last name.
# # We already have one Scarlett, so she'll be returned.
# # 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: 2, first_name: 'Scarlett', last_name: 'Johansson'>
#
# # 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