Initializer

init(capacity:)

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

Declaration 宣言

init?(capacity: Int)

Parameters パラメータ

capacity

The number of bytes the data object can initially contain. データオブジェクトが初めに含むバイト数。

Return Value 戻り値

An initialized NSMutableData object capable of holding capacity bytes. 初期化されたNSMutableDataオブジェクトは、capacityバイトを保持する能力があります。

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 capacity 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. このメソッドは、必ずしも直ちに要求されたメモリをアロケートしません。可変データオブジェクトは、追加のメモリを必要に応じてアロケートします、なのでcapacityは単にそのオブジェクトのもつ初期容量を確立します。それが初期メモリをアロケートする場合、そうはいっても、それは指定された量をアロケートします。このメソッドは、このデータオブジェクトの長さを0に設定します。

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

See Also 参照

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

Related Documentation 関連文書