Instance Method インスタンスメソッド

initWithBytesNoCopy:length:

Initializes a data object filled with a given number of bytes of data from a given buffer. 与えられたバッファからの、与えられたバイト数のデータで満たされたデータオブジェクトを初期化します。

Declaration 宣言 

- (instancetype)initWithBytesNoCopy:(void *)bytes 
                             length:(NSUInteger)length;

Parameters パラメータ

bytes

A buffer containing data for the new object. bytes must point to a memory block allocated with malloc. 新しいオブジェクトに対するデータを含んでいるバッファ。bytesは、mallocを使ってアロケートされるメモリブロックを指し示さなければなりません。

length

The number of bytes to hold from bytes. This value must not exceed the length of bytes. bytesから保持することになるバイト数。この値は、bytesの長さを越えてはなりません。

Return Value 戻り値

A data object initialized by adding to it length bytes of data from the buffer bytes. The returned object might be different than the original receiver. それにlengthバイトのデータをバッファbytesから追加することによって初期化されるデータオブジェクト。返されるオブジェクトは、オリジナルのレシーバとは異なるかもしれません。

Discussion 議論

The returned object takes ownership of the bytes pointer and frees it on deallocation. Therefore, bytes must point to a memory block allocated with malloc. 返されるオブジェクトは、bytesポインタの所有権を取ります、そしてそれをデアロケーションで自由にします。それゆえ、bytesはmallocを使ってアロケートされるメモリブロックを指し示さなければなりません。

See Also 参照

Creating Data データを作成する

+ data
Creates an empty data object. 空のデータオブジェクトを作成します。
+ dataWithBytes:length:
Creates a data object containing a given number of bytes copied from a given buffer. ある与えられたバッファから複製されるある与えられた数のバイトを含んでいるデータオブジェクトを作成します。
+ dataWithBytesNoCopy:length:
Creates a data object that holds a given number of bytes from a given buffer. ある与えられたバッファからある与えられた数のバイトを保持するデータオブジェクトを作成します。
+ dataWithBytesNoCopy:length:freeWhenDone:
Creates a data object that holds a given number of bytes from a given buffer. ある与えられたバッファからある与えられた数のバイトを保持するデータオブジェクトを作成します。
+ dataWithData:
Creates a data object containing the contents of another data object. 別のデータオブジェクトの内容を含んでいるデータオブジェクトを作成します。
- initWithBytes:length:
Initializes a data object filled with a given number of bytes copied from a given buffer. 与えられたバッファから複製される、与えられた数のバイトで満たされたデータオブジェクトを初期化します。
- initWithBytesNoCopy:length:deallocator:
Initializes a data object filled with a given number of bytes of data from a given buffer, with a custom deallocator block. 与えられたバッファからの、与えられたバイト数のデータで満たされたデータオブジェクトを初期化します、あるあつらえのデアロケータブロックを使います。
- initWithBytesNoCopy:length:freeWhenDone:
Initializes a newly allocated data object by adding the given number of bytes from the given buffer. 新しくアロケートされたデータオブジェクトを、この与えられたバッファからこの与えられた数のバイトを加えることによって初期化します。
- initWithData:
Initializes a data object with the contents of another data object. あるデータオブジェクトを別のデータオブジェクトの内容で初期化します。