npt-japanese

% Function COUNT, COUNT-IF, COUNT-IF-NOT

UP


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それぞれ0nil
key - 1つの引数を取る関数の指定子、またはnil
n - sequenceの長さ以下の非負の整数

定義

countcount-ifcount-if-notは、 sequencestart, endの境界内にある要素のうち、 testによって満たされるものの数を返却します。

from-endは、返却値に直接な効果を持ちません。 しかし、from-endtrueのときは、 sequenceの要素は、 testtest-notkeyの引数が逆順に指定され、 これらの関数に副作用があるのであれば、 その効果が変更さる可能性があります。

例文

(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は非推奨です。


TOP, Github