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

path(forResource:ofType:)

Returns the full pathname for the resource identified by the specified name and file extension. 指定された名前とファイル拡張子によって識別されるリソースに対する完全パス名を返します。

Declaration 宣言

func path(forResource name: String?, 
   ofType ext: String?) -> String?

Parameters パラメータ

name

The name of the resource file. リソースファイルの名前。

If you specify nil, the method returns the first resource file it finds with the specified extension. あなたがnilを指定するならば、このメソッドは、それが最初に見つける、指定された拡張子を持つリソースファイルを返します。

extension

The filename extension of the file to locate. 捜し出すファイルのファイル名拡張子。

If you specify an empty string or nil, the extension is assumed not to exist and the file is the first file encountered that exactly matches name. あなたが空の文字列またはnilを指定するならば、拡張子は存在しないとみなされます、そしてファイルは最初に出くわしたぴったりnameに一致するファイルです。

Return Value 戻り値

The full pathname for the resource file, or nil if the file could not be located. リソースファイルの完全パス名、またはファイルが捜し出されることができなかったならばnil

Discussion 議論

The method first looks for a matching resource file in the non-localized resource directory of the specified bundle. If a matching resource file is not found, it then looks in the top level of an available language-specific .lproj folder. (The search order for the language-specific folders corresponds to the user’s preferences.) It does not recurse through other subfolders at any of these locations. For more details on how localized resources are found, read The Bundle Search Pattern in Bundle Programming Guide. メソッドは、指定されたバンドルの非ローカライズリソースディレクトリの中の合致するリソースファイル合致しているリソースファイルが見つけられないならば、それはそのとき利用可能な言語固有の.lprojフォルダのトップレベルをのぞきます。(言語固有のフォルダに対する検索順序はユーザの環境設定と一致します。)それは、これらの位置のどれかでの他の下位フォルダを始めから終わりまで再帰呼び出ししません。どのようにローカライズされたリソースが見つけられるかに関する詳細は、The Bundle Search PatternBundle Programming Guideで読んでください。

The following code fragment gets the path to a plist within the bundle, and loads it into an NSDictionary: 以下のコード断片は、バンドル内のあるplistへのパスを取得します、そしてそれをNSDictionaryへとロードします:


NSBundle *thisBundle = [NSBundle bundleForClass:[self class]];
if (commonDictionaryPath = [thisBundle pathForResource:@"CommonDictionary" ofType:@"plist"]) {
    theDictionary = [[NSDictionary alloc] initWithContentsOfFile:commonDictionaryPath];
}

See Also 参照

Finding Resource Files リソースファイルを見つける