Type Method 型メソッド

arrayWithContentsOfFile:

Creates and returns a mutable array containing the contents of the file specified by the given path. ある可変配列を作成して返します、この与えられたパスによって指定されるファイルの内容を含んでいます。

Declaration 宣言 

+ (NSMutableArray<ObjectType> *)arrayWithContentsOfFile:(NSString *)path;

Parameters パラメータ

aPath

The path to a file containing a string representation of a mutable array produced by the writeToFile:atomically: method. writeToFile:atomically:メソッドによって生成される可変配列の文字列表現を含んでいるファイルへのパス。

Return Value 戻り値

A mutable array containing the contents of the file specified aPath. Returns nil if the file can’t be opened or if the contents of the file can’t be parsed into a mutable array. aPathによって指定されるファイルの内容を含んでいる可変配列。そのファイルが開かれることができないならば、またはファイルの内容が可変配列へと構文解析されることができないならば、nilを返します。

Discussion 議論

The mutable array representation in the file identified by aPath must contain only property list objects (NSString, NSData, NSDate, NSNumber, NSArray, or NSDictionary objects). For more details, see Property List Programming Guide. The objects contained by this array are immutable even if the array is mutable. aPathによって識別されるファイルの中の可変配列表現は、ただプロパティリストオブジェクト（NSString、NSData、NSDate、NSNumber、NSArray、またはNSDictionaryオブジェクト）だけを含んでいなければなりません。さらなる詳細として、Property List Programming Guideを見てください。この配列に含まれるオブジェクトは不変です、その配列が可変だとしてもです。

See Also 参照

Creating and Initializing a Mutable Array 可変Arrayを作成して初期化する

+ arrayWithCapacity:
Creates and returns an NSMutableArray object with enough allocated memory to initially hold a given number of objects. NSMutableArrayオブジェクトを、与えられた数のオブジェクトを最初から保持するのに十分にアロケートされたメモリで作成して返します。
+ arrayWithContentsOfURL:
Creates and returns a mutable array containing the contents specified by a given URL. ある可変配列を作成して返します、ある与えられたURLによって指定される内容を含んでいます。
- init
Initializes a newly allocated array. 新しく割り当てられた配列を初期化します
- initWithCapacity:
Returns an array, initialized with enough memory to initially hold a given number of objects. ある配列を返します、与えられた数のオブジェクトを当初から格納するのに十分なメモリで初期化されます。
- initWithContentsOfFile:
Initializes a newly allocated mutable array with the contents of the file specified by a given path 新しく割り当てられた可変配列を、与えられたパスによって指定されるファイルの内容で初期化します。
- initWithContentsOfURL:
Initialized a newly allocated mutable array with the contents of the location specified by a given URL. 与えられたURLによって指定された場所の内容で初期化された、新しくアロケートされた可変配列。

Related Documentation 関連文書

- writeToFile:atomically:
Writes the contents of the array to a file at a given path. 配列の内容をある与えられたパスでのファイルに書き出します。