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

writeToURL:options:error:

Writes the data object's bytes to the location specified by a given URL. データオブジェクトの持つバイトをある与えられたURLによって指定される場所へと書き込みます。

Declaration 宣言 

- (BOOL)writeToURL:(NSURL *)url 
           options:(NSDataWritingOptions)writeOptionsMask 
             error:(NSError * _Nullable *)errorPtr;

Parameters パラメータ

aURL

The location to which to write the receiver's bytes. それにレシーバの持つバイトを書き出すことになる場所。

mask

A mask that specifies options for writing the data. Constant components are described in NSDataWritingOptions. データを書き出すためのオプションを指定するマスク。定数構成要素それらは、NSDataWritingOptionsにおいて記述されます。

errorPtr

If there is an error writing out the data, upon return contains an error object that describes the problem. データ書き出しでエラーがあるならば、戻りでは問題を記述するエラーオブジェクトを含みます。

Return Value 戻り値

YES if the operation succeeds, otherwise NO. YES、もし操作が成功するならば、そうでなければNO。

Discussion 議論

Since at present only file:// URLs are supported, there is no difference between this method and writeToFile:options:error:, except for the type of the first argument. 目下file:// URLだけがサポートされることから、このメソッドとwriteToFile:options:error:の間の違いはありません、最初の引数の型を除いては。

This method may not be appropriate when writing to publicly accessible files. To securely write data to a public location, use NSFileHandle instead. For more information, seeSecuring File Operations in Secure Coding Guide. このメソッドは、パブリックにアクセス可能なファイルに書き込む場合は、適切ではないかもしれません。安全にデータをパブリックな場所に書き出すには、NSFileHandleを代わりに使ってください。さらなる情報のために、Securing File OperationsをSecure Coding Guideで見てください。

See Also 参照

Writing Data to a File ファイルにデータを書き込む

- writeToFile:atomically:
Writes the data object's bytes to the file specified by a given path. データオブジェクトの持つバイトをある与えられたパスによって指定されたファイルに書き込みます。
- writeToFile:options:error:
Writes the data object’s bytes to the file specified by a given path.
- writeToURL:atomically:
Writes the data object's bytes to the location specified by a given URL. データオブジェクトの持つバイトをある与えられたURLによって指定される場所へと書き込みます。
NSDataWritingOptions
Options for methods used to write data objects. データオブジェクトの書き込みに使用されるメソッドのオプション。