path(forResource:ofType:inDirectory:)

Return Value 戻り値

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

Discussion 議論

If subpath is nil, this method searches the top-level nonlocalized resource directory and the top-level of any language-specific directories. (In macOS, the top-level nonlocalized resource directory is typically called Resources but in iOS, it is the main bundle directory.) For example, suppose you have a Mac app with a modern bundle and you specify @"Documentation" for the subpath parameter. This method would first look in the Contents/Resources/Documentation directory of the bundle, followed by the Documentation subdirectories of each language-specific .lproj directory. subpathがnilならば、このメソッドはトップレベルの非ローカライズのリソースディレクトリそしてあらゆる言語固有のディレクトリのトップレベルを調査します。（macOSにおいて、トップレベルのローカライズされないリソースディレクトリは、たいていはResourcesと呼ばれます、しかしiOSでは、それはメインバンドルディレクトリです。）例えば、あなたがモダンバンドルを持つMacアプリを持つと仮定すると、あなたは@"Documentation"をsubpathパラメータに対して指定します。このメソッドは、最初にバンドルのContents/Resources/Documentationディレクトリ、続けて各言語固有の.lprojディレクトリのDocumentation下位ディレクトリの中をのぞきます。

Whether this method recurses through subdirectories is dependent on the extension parameter. If nil or an empty string it will recurse, otherwise, it does not. (The search order for the language-specific directories corresponds to the user’s preferences.) For details on how localized resources are found, read The Bundle Search Pattern in Bundle Programming Guide. このメソッドが下位ディレクトリをくまなく再帰呼び出しするかどうかは、extensionパラメータに依存します。nilまたは空の文字列ならばそれは再帰呼び出します、そうでなければ、それはしません。（言語固有のディレクトリに対する検索順序はユーザの環境設定と一致します。）どのようにローカライズされたリソースが見つけられるかに関する詳細は、The Bundle Search PatternをBundle Programming Guideで読んでください。