Type Method 型メソッド

dataWithCapacity:

Creates and returns a mutable data object capable of holding the specified number of bytes. 指定されたバイト数を保持する能力のある可変データオブジェクトを返します。

Declaration 宣言 

+ (instancetype)dataWithCapacity:(NSUInteger)aNumItems;

Parameters パラメータ

aNumItems

The number of bytes the new data object can initially contain. 新しいデータオブジェクトが初期状態で含むバイト数。

Return Value 戻り値

A new NSMutableData object capable of holding aNumItems bytes. ある新しいNSMutableDataオブジェクト、それはaNumItemsバイトを保持する能力があります。

The returned object has the same memory alignment guarantees as malloc(_:). 返されるオブジェクトは、malloc(_:)と同じメモリアライメントを保証されます。

Discussion 議論

This method doesn’t necessarily allocate the requested memory right away. Mutable data objects allocate additional memory as needed, so aNumItems simply establishes the object’s initial capacity. When it does allocate the initial memory, though, it allocates the specified amount. This method sets the length of the data object to 0. このメソッドは、必ずしも直ちに要求されたメモリをアロケートしません。可変データオブジェクトは、追加のメモリを必要に応じてアロケートします、なのでaNumItemsは単にそのオブジェクトのもつ初期容量を確立します。それが初期メモリをアロケートする場合、そうはいっても、それは指定された量をアロケートします。このメソッドは、このデータオブジェクトの長さを0に設定します。

If the capacity specified in aNumItems is greater than four memory pages in size, this method may round the amount of requested memory up to the nearest full page. aNumItemsにおいて指定された容量が大きさにおいて４メモリページより大きいならば、このメソッドは要求されたメモリの総量を最寄りのフルページまで切り上げるかもしれません。

See Also 参照

Creating Mutable Data 可変データを作成する

+ dataWithLength:
Creates and returns an mutable data object containing a given number of zeroed bytes. 与えられた数のゼロ化されたバイトを含んでいる可変データオブジェクトを作成して返します。
- initWithCapacity:
Returns an initialized mutable data object capable of holding the specified number of bytes. 指定されたバイト数を保持する能力のある初期化された可変データオブジェクトを返します。
- initWithLength:
Initializes and returns a mutable data object containing a given number of zeroed bytes. 与えられた数のゼロ化されたバイトを含んでいる可変データオブジェクトを初期化して返します。

Related Documentation 関連文書

Binary Data Programming Guide