Class

NSMutableData

A dynamic byte buffer that bridges to Data; use NSMutableData when you need reference semantics or other Foundation-specific behavior. 動的バイトバッファ、それはDataにブリッジします；NSMutableDataを、あなたが参照意味論または他のFoundation特有の挙動を必要とする場合に使ってください。

Declaration 宣言 

class NSMutableData : NSData

Overview 概要

NSMutableData and its superclass NSData provide data objects, or object-oriented wrappers for byte buffers. Data objects let simple allocated buffers (that is, data with no embedded pointers) take on the behavior of Foundation objects. They are typically used for data storage and are also useful in Distributed Objects applications, where data contained in data objects can be copied or moved between applications. NSData creates static data objects, and NSMutableData creates dynamic data objects. NSMutableDataとそれのスーパークラスNSDataは、データオブジェクト、またはバイトバッファに対するオブジェクト指向ラッパー、を提供します。データオブジェクトそれらは、単純な割り当てられたバッファ（すなわち、埋め込まれたポインタを持たないデータ）にFoundationオブジェクトの挙動を取らせます。それらは、概してデータストレージに対して使われます、そしてまた「分散オブジェクト」アプリケーションに有益です。NSDataは静的データオブジェクトを作成します、そしてNSMutableDataは動的データオブジェクトを作成します。 You can easily convert one type of data object to the other with the initializer that takes an NSData object or an NSMutableData object as an argument.

The following NSData methods change when used on a mutable data object: 以下のNSDataメソッドは、可変データオブジェクト上で使われる時に変更します：

When called, the bytes are immediately copied and then the buffer is freed. 呼び出される場合、バイトは直ちにコピーされます、それからバッファは自由にされます。

NSMutableData is “toll-free bridged” with its Core Foundation counterpart, CFData. See Toll-Free Bridging for more information on toll-free bridging. NSMutableDataは、それのCore Foundation相当物、CFDataと「トールフリーブリッジ」されます。トールフリーブリッジに関する更なる情報としてToll-Free Bridgingを見てください。

Topics 話題

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

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

Accessing Raw Bytes 生のバイトにアクセスする

var mutableBytes: UnsafeMutableRawPointer
A pointer to the data contained by the mutable data object. 可変データオブジェクトによって含まれるデータへのポインタ。

Counting Bytes バイトを数える

var length: Int
The number of bytes contained in the mutable data object. 可変データオブジェクトによって含まれるバイト数。

Adding Bytes バイトを加える

func append(UnsafeRawPointer, length: Int)
Appends to the receiver a given number of bytes from a given buffer. レシーバにある与えられた数のバイトをある与えられたバッファから加えます。
func append(Data)
Appends the content of another data object to the receiver. 別のデータオブジェクトの内容をレシーバに加えます。
func increaseLength(by: Int)
Increases the length of the receiver by a given number of bytes. レシーバの長さをある与えられたバイト数によって漸増します。

Modifying Bytes バイトを修正する

func replaceBytes(in: NSRange, withBytes: UnsafeRawPointer)
Replaces with a given set of bytes a given range within the contents of the receiver. 与えられた一揃いのバイトでレシーバの内容中のある与えられた範囲を置き換えます。
func replaceBytes(in: NSRange, withBytes: UnsafeRawPointer?, length: Int)
Replaces with a given set of bytes a given range within the contents of the receiver. 与えられた一揃いのバイトでレシーバの内容中のある与えられた範囲を置き換えます。
func resetBytes(in: NSRange)
Replaces with zeroes the contents of the receiver in a given range. 与えられた範囲でのレシーバの内容をゼロで置き換えます。
func setData(Data)
Replaces the entire contents of the receiver with the contents of another data object. レシーバの全内容を別のデータオブジェクトの内容で置き換えます。

Compressing and Decompressing Data データの圧縮と解凍

func compress(using: NSData.CompressionAlgorithm)
Compresses the data object’s bytes using an algorithm that you specify. データオブジェクトのもつバイトそれらをあなたが指定するアルゴリズムを使って圧縮します。
func decompress(using: NSData.CompressionAlgorithm)
Decompresses the data object’s bytes. データオブジェクトのもつバイトそれらを解凍します。
enum NSData.CompressionAlgorithm
An algorithm that indicates how to compress or decompress data. あるアルゴリズム、それはどのようにデータを圧縮または解凍するかを指し示します。
var NSCompressionErrorMaximum: Int
The end of the range of error codes reserved for compression errors. 圧縮エラーのために予約されるエラーコードの範囲の終わり。
var NSCompressionErrorMinimum: Int
The start of the range of error codes reserved for compression errors. 圧縮エラーのために予約されたエラーコードの範囲の始まり。
var NSCompressionFailedError: Int
An error code value that indicates a failure to compress data using the provided algorithm. あるエラーコード値、それは提供されたアルゴリズムを使ってデータを圧縮することに失敗したのを指し示します。
var NSDecompressionFailedError: Int
An error code value that indicates a failure to decompress data using the provided algorithm. あるエラーコード値、それは提供されたアルゴリズムを使ってデータを解凍することに失敗したのを指し示します。

Relationships 関係

Inherits From 継承元

See Also 参照

Using Reference Types 参照型を使用する

class NSData
A static byte buffer that bridges to Data; use NSData when you need reference semantics or other Foundation-specific behavior. 静的バイトバッファ、それはDataにブリッジします；NSDataを、あなたが参照意味論または他のFoundation特有の挙動を必要とする場合に使ってください。
typealias Data.ReferenceType
An alias for this value type's equivalent reference type. この値型のもつ同等な参照型に対するエイリアス。