CFArray

概観

CFArray とその派生の可変型 CFMutableArray は配列と呼ばれる順序付けられた値のコレクションを管理します。CFArray は静的配列を作成し、CFMutableArray は動的配列を作成します。

静的配列オブジェクトは、CFArrayCreate(_:_:_:_:) または CFArrayCreateCopy(_:_:) 関数を使用して作成して下さい。これらの関数は、引数として渡す値を含む配列を返します。(配列には NUL Lポインタを含めることはできませんが、ほとんどの場合、代わりに kCFNull 定数を使用できる事に注意して下さい。) 値はコピーされませんが、配列の作成時に保持される retain 呼び出し関数を使用して保持されます。同様に、値が配列から削除されると、解放する呼び出し関数を使用して値が解放されます。

CFArray の 2 つの基本関数 CFArrayGetCount(_:) と CFArrayGetValueAtIndex(_:_:) は、そのインタフェース内に他のすべての関数の基礎を提供します。CFArrayGetCount(_:) 関数は、任意の配列内の要素の数を返します。CFArrayGetValueAtIndex(_:_:) は、配列の要素にそのインデックス値が 0 から始まるインデックスでアクセスできるようにします。

例えば CFArrayApplyFunction(_:_:_:_:) を使用すると、配列内の値範囲で数多くの CFArray の関数を操作することができます。また、CFArrayBSearchValues(_:_:_:_:_:) を使用して、そのパラメータと一致する値を配列で検索できます。範囲は {start, length} と定義されているので、配列全体を操作するには {0、N} (ここで N は配列のカウント) を指定して下さい。

CFArray は、Cocoa Foundation で対応する NSArray を使用して "通話無料でブリッジされて" います。つまり、Core Foundation 型は、関数呼び出しまたはメソッド呼び出しで、ブリッジされた Foundation オブジェクトと交換可能です。したがって、NSArray * パラメータを参照するメソッドでは、CFArrayRef を渡すことができ、CFArrayRef パラメータがある関数では、NSArray インスタンスを渡すことができます。これは、NSArray の具象サブクラスにも当てはまります。通話無料のブリッジの詳細については、通話無料でブリッジされた型を参照してください。