first
配列を最初の N 個の要素だけにスライスします。
first
は, SQL の limit
キーワード
と似たような働きをします。 これは、配列を 先頭の N
個の要素だけにします。 入力として、配列と要素数を受け取ります。
first
は、以下の 2 つの引数を取ります:
要素数
配列
またはマップまたは構造体のスライス
layout/_default/section.html
{{ range first 10 .Pages }}
{{ .Render "summary" }}
{{ end }}
注意: first
以外に、LIMIT を ‘0’ にすると空の配列を返します。
first
と where
を一緒に使用する
first
と where
を一緒に使うと、非常に強力です。 以下のスニペットは、メインセクション
から投稿のリストを取得し、 title
パラメータでソートし、そのリストの最初の 5 件だけを範囲指定します。
first-and-where-together.html
{{ range first 5 (where site.RegularPages "Type" "in" site.Params.mainSections).ByTitle }}
{{ .Content }}
{{ end }}