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

replaceItem(at:options:)

Replace the contents of the specified file with the contents of the current version’s file. 指定されたファイルの内容を現在のバージョンのファイルの内容で置き換えます。

Declaration 宣言

func replaceItem(at url: URL, 
         options: NSFileVersion.ReplacingOptions = []) throws -> URL

Parameters パラメータ

url

The file whose contents you want to replace. If the file at this URL does not exist, a new file is created at the location. それの内容をあなたが置き換えるのを望むファイル。このURLでのファイルが存在しないならば、新しいファイルはその位置で作成されます。

options オプション

Specify 0 to overwrite the file in place; otherwise, specify one of the constants described in NSFileVersion.ReplacingOptions. 0をファイルをその場で上書きするには指定してしてください;そうでなければ、NSFileVersion.ReplacingOptionsで指定される定数の1つを指定してください。

error

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 URL of the file that was written, which may be different than the one specified in the url parameter. 書き込まれたフアイルのURL、それはurlパラメータにおいて指定されたものと異なるかもしれません。

Discussion 議論

When replacing the contents of the file, this method does not normally replace the display name associated with the file. The only exception is when the file at url is of a different type than the file associated with this version object. In such a case, the file name remains the same but its filename extension changes to match the type of the new contents. (Of course, if filename extension hiding is enabled, this change is not noticeable to users.) ファイルの内容を置き換える場合、このメソッドは通常はファイルと結びつけられた表示名を置き換えません。唯一の例外は、urlでのファイルがこのバージョンオブジェクトと結びつけられたファイルとは異なる型のものである場合です。その場合には、ファイル名は同じままです、しかしそれのファイル名拡張子は新しい内容の型に合うように変わります。(もちろん、ファイル名拡張子を隠すが有効であるならば、この変更はユーザの目につきません。)

See Also 参照

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