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

compressUsingAlgorithm:error:

Compresses the data object’s bytes using an algorithm that you specify. データオブジェクトのもつバイトそれらをあなたが指定するアルゴリズムを使って圧縮します。

Declaration 宣言 

- (BOOL)compressUsingAlgorithm:(NSDataCompressionAlgorithm)algorithm 
                         error:(NSError * _Nullable *)error;

Parameters パラメータ

algorithm

The algorithm to use to compress the data. For a list of available algorithms, see NSDataCompressionAlgorithm. データを圧縮するために使用するアルゴリズム。利用可能なアルゴリズムの一覧として、NSDataCompressionAlgorithmを見てください。

error

On return, a pointer to an NSError instance that indicates why compressing the data failed, or nil if no error occurred. 戻りでは、なぜデータの圧縮が失敗したかを指し示すあるNSErrorインスタンスへのポインタ、またはnilもしエラーが発生しなかったならば。

Discussion 議論

Use this method to compress in-memory data when you want to reduce memory usage and can afford the time to compress and decompress the data. If your data object is already in a compressed format, such as media formats like JPEG images or AAC audio, compressUsingAlgorithm:error: may provide minimal or no benefit. このメソッドを使用して、インメモリデータを圧縮してください、あなたがメモリ使用を減らしたいそしてデータを圧縮および解凍する時間がさける場合に。あなたのデータオブジェクトが既に圧縮された形式であるならば、たとえばJPEG画像やAACオーディオのようなメディア形式など、compressUsingAlgorithm:error:はごくわずかまたは少しの利益も提供しないかもしれません。

The following example shows how to compress data from a string and prints the sizes of the data instances to illustrate the amount of compression: 以下の例は、どのようにある文字列からのデータを圧縮するかを示します、そしてデータインスタンスのサイズを圧縮量を明らかにするために出力します： 


var string = "NSData and its mutable subclass NSMutableData 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."
let data = NSMutableData(data: Data(string.utf8))
print ("original data size: \(data.length)")
do {
    try data.compress(using: .zlib)
    print("zlib compressed size: \(data.length)")
} catch {
    print ("Compression error: \(error)")
}
// Prints:
//  original data size: 241
//  zlib compressed size: 158

See Also 参照

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

- decompressUsingAlgorithm:error:
Decompresses the data object’s bytes. データオブジェクトのもつバイトそれらを解凍します。
NSDataCompressionAlgorithm
An algorithm that indicates how to compress or decompress data. あるアルゴリズム、それはどのようにデータを圧縮または解凍するかを指し示します。