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

writeToFile:options:error:

Writes the data object’s bytes to the file specified by a given path.

Declaration 宣言 

- (BOOL)writeToFile:(NSString *)path 
            options:(NSDataWritingOptions)writeOptionsMask 
              error:(NSError * _Nullable *)errorPtr;

Parameters パラメータ

path

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 議論

This method may not be appropriate when writing to publicly accessible files. To securely write data to a public location, use NSFileHandle instead. このメソッドは、パブリックにアクセス可能なファイルに書き込む場合は、適切ではないかもしれません。安全にデータをパブリックな場所に書き出すには、NSFileHandleを代わりに使ってください。 For more information, see Securing File Operations in 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. データオブジェクトの持つバイトをある与えられたパスによって指定されたファイルに書き込みます。
- writeToURL:atomically:
Writes the data object's bytes to the location specified by a given URL. データオブジェクトの持つバイトをある与えられたURLによって指定される場所へと書き込みます。
- writeToURL:options:error:
Writes the data object's bytes to the location specified by a given URL. データオブジェクトの持つバイトをある与えられたURLによって指定される場所へと書き込みます。
NSDataWritingOptions
Options for methods used to write data objects. データオブジェクトの書き込みに使用されるメソッドのオプション。