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

writeToURL:options:originalContentsURL:error:

Recursively writes the entire contents of a file wrapper to a given file-system URL. 与えられたファイルシステムURLへと、ファイルラッパーの全内容を再帰的に書き込みます。

Declaration 宣言

- (BOOL)writeToURL:(NSURL *)url 
           options:(NSFileWrapperWritingOptions)options 
originalContentsURL:(NSURL *)originalContentsURL 
             error:(NSError * _Nullable *)outError;

Parameters パラメータ

url

URL of the file-system node to which the file wrapper’s contents are written. それへとファイルラッパーの持つ内容が書き出されるファイルシステムノードのURL。

options オプション

Option flags for writing to the node located at url. See NSFileWrapperWritingOptions for possible values. urlに位置するノードに書き出すためのオプションフラグ。NSFileWrapperWritingOptionsを可能な値のために見てください。

originalContentsURL

The location of a previous revision of the contents being written. The default implementation of this method attempts to avoid unnecessary I/O by writing hard links to regular files instead of actually writing out their contents when the contents have not changed. The child file wrappers must return accurate values when its filename property is accessed for this to work. Use the NSFileWrapperWritingWithNameUpdating writing option to increase the likelihood of that. 書き出される内容の前の修正版の場所。このメソッドの省略時の実装は、内容が変更されなかった時に実際にそれらの内容をすっかり書き出してしまうのではなく、ハードリンクを通常ファイルに書き出すことによって不必要なI/Oを回避しようと試みます。子ファイルラッパーは、これが機能するために、それのfilenameプロパティがアクセスされる場合に正確な値を返さなければなりません。NSFileWrapperWritingWithNameUpdating書き出しオプションを使って、その可能性を増大させてください。

Specify nil for this parameter if there is no earlier version of the contents or if you want to ensure that all the contents are written to files. nilをこのパラメータに指定してください、もしより前のバージョンの内容はないならば、または全ての内容がファイルに書き出されることをあなたが確信したいならば。

outError

If an error occurs, upon return contains an NSError object that describes the problem. Pass NULL if you do not want error information. エラーが発生するならば、戻りでは、問題を記述するNSErrorオブジェクトを含みます。NULLをあなたがエラー情報を望まないならば渡してください。

Return Value 戻り値

YES when the write operation is successful. If not successful, returns NO after setting outError to an NSError object that describes the reason why the file wrapper’s contents could not be written. 書き出し操作が成功である場合はYES。成功しないならば、NOを返します、outErrorNSErrorオブジェクトに設定する後に、それはなぜファイルラッパーの持つ内容が書き出されることができなかったのか理由を記述します。

Discussion 議論

See Also 参照

Writing Files ファイル書き出し

Related Documentation 関連文書