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

find

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

item に一致する sequence の最初の要素を返します。一致する要素がなければ nil を返します。既定では eql で比較します。省略可能な :test キーワードに関数指定子を渡すと別の比較を使え、省略可能な :key キーワードに渡したセレクタ関数は比較の前に各要素へ適用されます (返されるのは元の要素であり、セレクタ適用後の値ではありません)。シーケンスにはリストまたは文字列を渡せます。文字列の要素は文字です。一致した末尾を返す member とは異なり、find は要素そのものを返します。インデックスを得たい場合は代わりに position を使います。:test-not は :test の否定です。:start/:end は走査範囲を区切り、:from-end が真なら最後の一致が選ばれます。範囲外の境界 (負の数、整数でない値、長さを超える値、終端より後ろの開始位置) は、要素を調べる前に type-error を通知します。nil の :end は長さを意味します。