(rontolisp) docs
← cl パッケージの関数

position

(position item sequence &key test test-not key start end from-end)

sequence の要素のうち item に一致する最初の要素の 0 始まりのインデックスを返します。一致する要素がなければ nil を返します。既定では eql で比較します。省略可能な :test キーワードに関数指定子を渡すと別の比較を使え、省略可能な :key キーワードに渡したセレクタ関数は比較の前に各要素へ適用されます。シーケンスにはリストまたは文字列を渡せます。文字列の要素は文字です。要素を返す find とは異なり、position は整数の位置を返します。:test-not は :test の否定です。:start/:end は走査範囲を区切り (返すインデックスはシーケンス全体の先頭から数えます)、:from-end が真なら最後の一致が選ばれます。範囲外の境界 (負の数、整数でない値、長さを超える値、終端より後ろの開始位置) は、要素を調べる前に type-error を通知します。nil の :end は長さを意味します。キーワード一式は第一級の値経由でも機能します (例: (apply #'position item seq other-keys))。

:test-not は比較の否定を、:start/:end は走査範囲を指定します(返るインデックスはシーケンス全体の先頭から数えます)。:from-end が真のときは最後にマッチした位置を返します。