Core Foundation   >   CFArrayBSearchValues(_:_:_:_:_:)
関数
CFArrayBSearchValues(_:_:_:_:_:)
バイナリ検索アルゴリズムを使用して配列の値を検索します。
宣言
パラメータ
theArray | comparator 関数に従って最小から最大にソートされた配列。 |
range | 検索すべき theArray 内の範囲。範囲は、theArray の境界を超えてはいけません。範囲は空 (長さ 0) でもかまいません。 |
value | theArray 内で一致するものを見つける値。theArray の value または他の値が comparator 呼び出し関数によって認識されない場合、動作は未定義です。 |
comparator | バイナリ検索操作で使用され、theArray 内の値を与えられた値と比較するために使用されるコンパレータ関数型シグニチャを持つ関数です。comparator 関数が期待しない、または適切に比較できない範囲内の値がある場合、その動作は未定義です。 |
context | ポインタサイズのプログラム定義値で、3 番目の引数として comparator 関数に渡されますが、そうでなければこの関数では他に使用されません。コンテキストが comparator 関数によって期待されるものでない場合、動作は未定義です。 |
戻り値
戻り値は以下のいずれかの一つです。
- ターゲット値が範囲内の 1 つ以上と一致する場合、一致した値のインデックス。
- 値が範囲内のすべての値より大きい場合は、範囲の終点より大きいか等しいです。
- 値が範囲内の値の 2 つの間にある (またはすべての未満である) 場合は、ターゲット値よりも大きい値のインデックス。