Instance Method
インスタンスメソッド
writeToFile:atomically:
Writes the contents of the array to a file at a given path.
配列の内容をある与えられたパスでのファイルに書き出します。
Declaration
宣言
- (BOOL)writeToFile:(NSString
*)path
atomically:(BOOL)useAuxiliaryFile;
Parameters
パラメータ
path
The path at which to write the contents of the array.
それで配列の内容を書き出すことになるパス。
If path
contains a tilde (~) character, you must expand it with stringByExpandingTildeInPath
before invoking this method.
path
がチルダ(~)文字を含むならば、あなたはそれをstringByExpandingTildeInPath
で、このメソッドを発動する前に展開しなければなりません。
flag
If YES
, the array is written to an auxiliary file, and then the auxiliary file is renamed to path
. If NO
, the array is written directly to path
. The YES
option guarantees that path
, if it exists at all, won’t be corrupted even if the system should crash during writing.
YES
ならば、配列はある補助ファイルに書き出されます、それからその補助ファイルはpath
に名前変更されます。NO
ならば、配列は直接にpath
に書き出されます。YES
オプションはpath
を保証します、それがともかく存在するならば、システムが書き出しの間にクラッシュするとしても。
Return Value
戻り値
YES
if the file is written successfully, otherwise NO
.
YES
、もしそのファイルがうまく書き込みされるならば、そうでなければNO
。
Discussion
議論
If the array’s contents are all property list objects (NSString
, NSData
, NSArray
, or NSDictionary
objects), the file written by this method can be used to initialize a new array with the class method arrayWithContentsOfFile:
or the instance method initWithContentsOfFile:
. This method recursively validates that all the contained objects are property list objects before writing out the file, and returns NO
if all the objects are not property list objects, since the resultant file would not be a valid property list.
配列の持つ内容が全てプロパティリストオブジェクトであるならば(NSString
, NSData
、NSArray
、またはNSDictionary
オブジェクト)、このメソッドによって書き込まれるファイルは、新しい配列をクラスメソッドarrayWithContentsOfFile:
またはインスタンスメソッドinitWithContentsOfFile:
で初期化するために使われることができます。このメソッドは、全ての含まれるオブジェクトがプロパティリストオブジェクトであることをファイルに清書する前に再帰的に検証します、そしてNO
をもし全てのオブジェクトがプロパティリストオブジェクトでないならば返します、結果として生じるファイルが有効なプロパティリストでないだろうことから。
See Also
参照
Storing Arrays
配列をソートする
- writeToURL:atomically:
Writes the contents of the array to the location specified by a given URL.
配列の内容をある与えられたURLによって指定された位置に書き出します。
Deprecated
非推奨
Related Documentation
関連文書
- initWithContentsOfFile:
Initializes a newly allocated array with the contents of the file specified by a given path.
新しく割り当てられた配列を、与えられたパスによって指定されるファイルの内容で初期化します。