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

remove()

Remove this version object and its associated file from the version store. このバージョンのオブジェクトとそれの関連ファイルをバージョン倉庫から取り除きます。

Declaration 宣言

func remove() throws

Parameters パラメータ

outError

On input, a pointer to an error object. If an error occurs, this pointer is set to an NSError object with information about the error. 入力では、エラーオブジェクトへのポインタ。エラーが発生するならば、このポインタはエラーについての情報をもつNSErrorオブジェクトへと設定されます。

Return Value 戻り値

true if this version was removed successfully or false if it was not. true、もしこのバージョンがうまく取り除かれたならば、またはそうでなかったならばfalse

Discussion 議論

This method removes this version object and its file from the version store, freeing up the associated storage space. You must not call this method for the current file version—that is, the version object returned by the currentVersionOfItem(at:) method. このメソッドは、このバージョンオブジェクトとファイルをバージョン倉庫から取り除いて、結びつけられたストレージ空間を解放します。あなたは、このメソッドを現在のファイルバージョンに対して呼び出すべきではありません — すなわち、currentVersionOfItem(at:)メソッドによって返されるバージョンオブジェクト。

You should always remove file versions as part of a coordinated write operation to a file. In other words, always call this method from a block passed to a file coordinator object to initiate a write operation. Doing so ensures that no other processes are operating on the file while you remove the version information. あなたは、常にファイルに対する協調書き込み演算の一部としてファイルバージョンを取り除くべきです。言い換えれば、常にこのメソッドをファイルコーディネータオブジェクトに渡されるブロックから呼び出して、書き込み演算を開始してください。そうすることは、あなたがバージョン情報を取り除く間に、他のプロセスがそのファイル上で演算していないことを確実にします。

If successful, subsequent requests for the versions of the file do not include this version object (or any object with the same information). You can use this method to free up disk space by removing versions that are no longer needed. うまくいくならば、ファイルのバージョンに対するその後のリクエストは、このバージョンオブジェクトを含みません(または同じ情報をもつどんなオブジェクトも)。あなたはこのメソッドを使って、もはや必要とされないバージョンを取り除くことによって、ディスク空間を解放できます。

See Also 参照

Replacing and Deleting Versions バージョンの置き換えと削除