Core Foundation > CFArrayCreateMutable(_:_:_:)
関数
CFArrayCreateMutable(_:_:_:)
新しい空の可変配列を作成します。
宣言
パラメータ
| allocator | 新しい配列にメモリを割り当てるために使用するアロケータと値の格納場所。現在のデフォルト・アロケータを使用するには、NULL または kCFAllocatorDefault を渡します。 |
| capacity | 新しい配列に含めることができる値の最大数。配列は空になり、この数の値に拡大することができます(これ以下でもよい)。 最大容量が制限されていないことを指定するには、0 を渡します。値は負であってはいけません。 |
| callBacks | 配列内の各値に使用する配列の呼び出し関数で初期化された CFArrayCallBacks 構造体へのポインタ。呼び出し関数構造体の内容のコピーが作成されるので、スタック上の構造体へのポインタを渡すか、複数の配列作成のために再利用することができます。 配列には CFType オブジェクトのみが含まれている場合は、kCFTypeArrayCallBacks を渡してデフォルトの呼び出し関数を使用して下さい。 このパラメータが NULL である時、すべてのフィールドが NULL であるバージョン 0 の有効な構造体が渡されたかのように扱われます。 いずれかのフィールドが正しい型の関数への有効なポインタでないか、このパラメータが CFArrayCallBacks 構造体への有効なポインタでない場合、その動作は未定義です。配列に格納された値が呼び出し関数の 1 つで理解できない値である場合、その呼び出し関数が使用されるときの動作は未定義です。 |
議論
新しい可変配列。オブジェクトの作成に問題があった場合は NULL。所有権は 作成規則 に従います。