Core Foundation > CFBagCreate(_:_:_:_:)

関数

CFBagCreate(_:_:_:_:)

指定された値を含む不変のバッグを作成します。

宣言

func CFBagCreate(_ allocator: CFAllocator!, _ values: UnsafeMutablePointer<UnsafeRawPointer?>!, _ numValues: CFIndex, _ callBacks: UnsafePointer<CFBagCallBacks>!) -> CFBag!

パラメータ

allocator	新しいバッグにメモリを割り当てるために使用するアロケータとその値の格納場所。現在のデフォルトアロケータを使用するには、NULL または kCFAllocatorDefault を渡して下さい。
values	新しいバッグに入れるポインタサイズの値の C 配列。numValues パラメーターが 0 の場合、このパラメーターは NULL になるかも知れません。C 配列はこの関数によって変更または解放されません。values は少なくとも numValues の要素の C 配列への有効なポインタでなければなりません。
numValues	新しい CFBag オブジェクトの values の C 配列からコピーする値の数。数が負の値または実際の値の数より大きい場合、動作は未定義です。
callBacks	バッグ内の値の保持、解放、記述、および比較に使用する呼び出し関数で初期化された CFBagCallBacks 構造体へのポインター。呼び出し関数構造体の内容のコピーが作成されるので、スタック上の構造体へのポインタが渡されるか、複数のコレクション作成に再利用できます。このパラメータは、すべてのフィールドが NULL であるバージョン 0 の有効な構造体が渡されたかのように扱われる NULL でもかまいません。そうでない場合、いずれかのフィールドが正しい型の関数への有効なポインタでないか、CFBagCallBacks 構造体への有効なポインタでない場合、動作は未定義です。コレクションに入れられたある値が呼び出し関数の 1 つで理解できるでない場合、その呼び出し関数が使用されるときの動作は未定義です。コレクションに CFType オブジェクトのみが含まれている場合は、このパラメータとして kCFTypeBagCallBacks を渡して、デフォルトの呼び出し関数を使用して下さい。

戻り値

新しいバッグ、またはオブジェクトの作成に問題があった場合は NULL。所有権は作成規則に従います。