paths(forResourcesOfType:inDirectory:)

Return Value 戻り値

An array containing the full pathnames for all bundle resources matching the specified criteria. This method returns an empty array if no matching resource files are found. 指定された基準に合致する全てのバンドルリソースに対する完全パス名を含んでいる配列。このメソッドは、合致するリソースファイルが見つけられないならば、空の配列を返します。

Discussion 議論

This method provides a means for dynamically discovering multiple bundle resources of the same type. If extension is an empty string or nil, all bundle resources in the specified resource directory are returned. このメソッドは、同じ型の複数のバンドルリソースを動的に発見するつもりのものを提供します。extension空の文字列またはnilであるならば、指定されたリソースディレクトリの中の全てのバントルリソースが返されます。

The argument subpath specifies the name of a specific subdirectory to search within the current bundle’s resource directory hierarchy. 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. (The search order for the language-specific directories corresponds to the user’s preferences.) This method does not recurse through any other subdirectories at any of these locations. For details on how localized resources are found, read The Bundle Search Pattern in Bundle Programming Guide. 引数subpathは、現在のバンドルの持つリソースディレクトリ階層の内部を検索するために、ある特定の下位ディレクトリの名前を指定します。subpathがnilならば、このメソッドはトップレベルの非ローカライズのリソースディレクトリそしてあらゆる言語固有のディレクトリのトップレベルを調査します。（macOSにおいて、トップレベルのローカライズされないリソースディレクトリは、たいていはResourcesと呼ばれます、しかしiOSでは、それはメインバンドルディレクトリです。）例えば、あなたがモダンバンドルを持つMacアプリを持つと仮定すると、あなたは@"Documentation"をsubpathパラメータに対して指定します。このメソッドは、最初にバンドルのContents/Resources/Documentationディレクトリ、続けて各言語固有の.lprojディレクトリのDocumentation下位ディレクトリの中をのぞきます。（言語固有のディレクトリに対する検索順序はユーザの環境設定と一致します。）このメソッドは、これらの位置のどれかでの何か他の下位ディレクトリを始めから終わりまで再帰呼び出ししません。どのようにローカライズされたリソースが見つけられるかに関する詳細は、The Bundle Search PatternをBundle Programming Guideで読んでください。