Type Method 型メソッド

addVersionOfItemAtURL:withContentsOfURL:options:error:

Creates a version of the file at the specified location. 指定された場所でのファイルのあるバージョンを作成します。

Declaration 宣言 

+ (NSFileVersion *)addVersionOfItemAtURL:(NSURL *)url 
                       withContentsOfURL:(NSURL *)contentsURL 
                                 options:(NSFileVersionAddingOptions)options 
                                   error:(NSError * _Nullable *)outError;

Parameters パラメータ

url

The location at which to store the new file version. そこで新しいファイルバージョンを格納することになる場所。

contentsURL

The URL that specifies the file to use for the version contents. バージョン内容に対して使うためのファイルを指定するURL。

options オプション

Specify 0 for this parameter if you want to create a copy of the file at the location specified by the url parameter. Alternatively, specify one of the constants described in NSFileVersionAddingOptions. このパラメータに０を指定してください、もしあなたがこのファイルのコピーをurlパラメータによって指定される場所に作成したいならば。あるいはまた、NSFileVersionAddingOptionsの中に記述される定数の１つを指定してください。

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 戻り値

The file version object representing the new version or nil if an error occurred. 新しいバージョンを表しているファイルバージョンオブジェクト、またはエラーが発生したならばnil。

Discussion 議論

You can use this method to save a version of your file to the location specified by the url parameter. The contents of the file are taken from the contentsURL parameter, whose value may be the same as the url parameter. あなたはこのメソッドを使って、あなたのファイルのあるバージョンをurlパラメータによって指定された場所に保存できます。ファイルの内容は、contentsURLパラメータから取られます、それの値はurlパラメータと同じかもしれません。

You should always add 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 save the version to its new location. あなたは、常にファイルに対する協調書き込み演算の一部としてファイルバージョンを加えるべきです。言い換えれば、常にこのメソッドをファイルコーディネータオブジェクトに渡されるブロックから呼び出して、書き込み演算を開始してください。そうすることは、あなたがバージョンを新しい場所に保存する間に、他のプロセスがそのファイル上で演算していないことを確実にします。