古いバージョンのドキュメントです。最新のバージョンはRails7.0.0

Railsドキュメント(v6.0.2.1)

先頭のレコードを取得

説明

モデルの先頭のレコードを取得

使い方

モデル.first([件数])

取得するレコードが存在しない場合に例外が発生

モデル.first!([件数])

モデルの先頭のレコードを取得

Page.first
# <Page id: 1, ...>
# SQL: SELECT "pages".* FROM "pages" LIMIT 1

複数件数を取得

Page.first(3)
# [
#   <Page id: 1, ...>,
#   <Page id: 2, ...>,
#   <Page id: 3, ...>
# ]
# SQL: SELECT "pages".* FROM "pages" LIMIT 3

orderで並び替え後のレコードを取得

Page.order(:title).first
# <Page title: a, ...>
# SQL: SELECT * FROM pages ORDER BY pages.title ASC LIMIT 1

モデルが空の場合

Page.first
# nil

ソースコード