method

first

v6.1.7.7 - Show latest stable - 0 notes - Class: ActiveRecord::FinderMethods

1.0.0
1.1.6
1.2.6
2.0.3
2.1.0
2.2.1
2.3.8
3.0.0 (0)
3.0.9 (-1)
3.1.0 (0)
3.2.1 (0)
3.2.8 (0)
3.2.13 (0)
4.0.2 (32)
4.1.8 (38)
4.2.1 (0)
4.2.7 (-33)
4.2.9 (0)
5.0.0.1 (0)
5.1.7 (0)
5.2.3 (0)
6.0.0 (0)
6.1.3.1 (0)
6.1.7.7 (0)
7.0.0 (0)
7.1.3.2 (0)
7.1.3.4 (0)
What's this?

first(limit = nil) public

Find the first record (or first N records if a parameter is supplied). If no order is defined it will order by primary key.

Person.first # returns the first object fetched by SELECT * FROM people ORDER BY people.id LIMIT 1
Person.where(["user_name = ?", user_name]).first
Person.where(["user_name = :u", { u: user_name }]).first
Person.order("created_on DESC").offset(5).first
Person.first(3) # returns the first three objects fetched by SELECT * FROM people ORDER BY people.id LIMIT 3

Show source

# File activerecord/lib/active_record/relation/finder_methods.rb, line 116
    def first(limit = nil)
      check_reorder_deprecation unless loaded?

      if limit
        find_nth_with_limit(0, limit)
      else
        find_nth 0
      end
    end

first

Related methods