Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Merge pull request #5830 from raganwald/master

Update RDoc to mention integer coercion in ActiveRecord’s find by id
  • Loading branch information...
commit 4e3e5138b537e999b5bdf6fbb1243890123ada5d 2 parents 8c2c605 + dcb2279
Xavier Noria fxn authored
Showing with 3 additions and 1 deletion.
  1. +3 −1 activerecord/lib/active_record/relation/finder_methods.rb
4 activerecord/lib/active_record/relation/finder_methods.rb
View
@@ -6,7 +6,8 @@ module FinderMethods
# Find operates with four different retrieval approaches:
#
# * Find by id - This can either be a specific id (1), a list of ids (1, 5, 6), or an array of ids ([5, 6, 10]).
- # If no record can be found for all of the listed ids, then RecordNotFound will be raised.
+ # If no record can be found for all of the listed ids, then RecordNotFound will be raised. If the primary key
+ # is an integer, find by id coerces its arguments using +to_i+.
# * Find first - This will return the first record matched by the options used. These options can either be specific
# conditions or merely an order. If no record can be matched, +nil+ is returned. Use
# <tt>Model.find(:first, *args)</tt> or its shortcut <tt>Model.first(*args)</tt>.
@@ -51,6 +52,7 @@ module FinderMethods
#
# # find by id
# Person.find(1) # returns the object for ID = 1
+ # Person.find("1") # returns the object for ID = 1
# Person.find(1, 2, 6) # returns an array for objects with IDs in (1, 2, 6)
# Person.find([7, 17]) # returns an array for objects with IDs in (7, 17)
# Person.find([1]) # returns an array for the object with ID = 1
Please sign in to comment.
Something went wrong with that request. Please try again.