% Function COUNT, COUNT-IF, COUNT-IF-NOT
Function COUNT
, COUNT-IF
, COUNT-IF-NOT
count
item sequence &key from-end start end key test test-not => n
count-if
predicate sequence &key from-end start end key => n
count-if-not
predicate sequence &key from-end start end key => n
item - オブジェクト
sequence - 正常なシーケンス
predicate - 1つの引数をとりgeneralized-booleanを返却する関数の指定子
from-end - generalized-boolean、デフォルトはfalse
test - 2つの引数を取りgeneralized-booleanを返却する関数の指定子
test-not - 2つの引数を取りgeneralized-booleanを返却する関数の指定子
start, end - sequenceの境界インデックス指定子。
デフォルトはstart, endそれぞれ0
とnil
。
key - 1つの引数を取る関数の指定子、またはnil
n - sequenceの長さ以下の非負の整数
count
、count-if
、count-if-not
は、
sequenceのstart, endの境界内にある要素のうち、
testによって満たされるものの数を返却します。
from-endは、返却値に直接な効果を持ちません。 しかし、from-endがtrueのときは、 sequenceの要素は、 test、test-not、keyの引数が逆順に指定され、 これらの関数に副作用があるのであれば、 その効果が変更さる可能性があります。
(count #\a "how many A's are there in here?") => 2
(count-if-not #'oddp '((1) (2) (3) (4)) :key #'car) => 2
(count-if #'upper-case-p "The Crying of Lot 49" :start 4) => 2
なし。
なし。
sequenceが正常なシーケンスでないとき、
型type-error
のエラーを通知する準備をしなければなりません。
17.2. テスト関数のルール, 3.6. 横断の規則と副作用
:test-not
パラメーターは非推奨です。
関数count-if-not
は非推奨です。