Type Method 型メソッド

stringWithContentsOfFile:usedEncoding:error:

Returns a string created by reading data from the file at a given path and returns by reference the encoding used to interpret the file. 与えられたパスでのファイルからデータを読み出すことによって作成された文字列を返します、そしてそのファイルを解釈するのに使った符号化を参照によって返します。

Declaration 宣言 

+ (instancetype)stringWithContentsOfFile:(NSString *)path 
                            usedEncoding:(NSStringEncoding *)enc 
                                   error:(NSError * _Nullable *)error;

Parameters パラメータ

path

A path to a file. ファイルへのパス。

enc

Upon return, if the file is read successfully, contains the encoding used to interpret the file at path. For possible values, see NSStringEncoding. 戻りでは、ファイルがうまく読み出されたならば、pathでのファイルを解釈するのに使われた符号化を含みます。可能な値として、NSStringEncodingを見てください。

error

If an error occurs, upon returns contains an NSError object that describes the problem. If you are not interested in possible errors, you may pass in NULL. エラーが発生するならば、戻りでは問題を記述するNSErrorオブジェクトを含みます。あなたが起こりうるエラーに興味がないならば、あなたはNULLを渡すかもしれません。

Return Value 戻り値

A string created by reading data from the file named by path. If the file can’t be opened or there is an encoding error, returns nil. pathによって指名されるファイルからデータを読み出すことによって作成される文字列。ファイルが開かれることができないまたは符号化エラーがあるならば、nilを返します。

Discussion 議論

This method attempts to determine the encoding of the file at path. このメソッドは、pathでのファイルの符号化を決定しようと試みます。

See Also 参照

Creating and Initializing a String from a File 文字列をファイルから作成して初期化する

+ stringWithContentsOfFile:encoding:error:
Returns a string created by reading data from the file at a given path interpreted using a given encoding. 与えられたパスでのファイルからデータを読み出すことによって作成される文字列を返します、与えられた符号化を使って解釈されます。
- initWithContentsOfFile:encoding:error:
Returns an NSString object initialized by reading data from the file at a given path using a given encoding. NSStringオブジェクトを返します、データをある与えられたパスでのファイルからある与えられた符号化を使って読み出すことによって初期化されます。
- initWithContentsOfFile:usedEncoding:error:
Returns an NSString object initialized by reading data from the file at a given path and returns by reference the encoding used to interpret the characters. NSStringオブジェクトを返します、データをある与えられたパスでのファイルから読み出すことによって初期化されます、そして参照によって文字を解釈するのに使った符号化を返します。