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

pathsForResourcesOfType:inDirectory:

Returns an array containing the pathnames for all bundle resources having the specified filename extension and residing in the resource subdirectory. 指定されたファイル名拡張子を持ち、リソース下位ディレクトリに属する、全てのバンドルリソースに対するパス名を含んでいる配列を返します。

Declaration 宣言

- (NSArray<NSString *> *)pathsForResourcesOfType:(NSString *)ext 
                                     inDirectory:(NSString *)subpath;

Parameters パラメータ

extension

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

If you specify an empty string or nil, the extension is assumed not to exist and all of the files in subpath are returned. あなたが空の文字列またはnilを指定するならば、拡張子は存在しないとみなされます、subpathの中の全てのファイルが返されます。

subpath

The name of the bundle subdirectory to search. 調査することになるバンドル下位ディレクトリの名前。

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は、現在のバンドルの持つリソースディレクトリ階層の内部を検索するために、ある特定の下位ディレクトリの名前を指定します。subpathnilならば、このメソッドはトップレベルの非ローカライズのリソースディレクトリそしてあらゆる言語固有のディレクトリのトップレベルを調査します。(macOSにおいて、トップレベルのローカライズされないリソースディレクトリは、たいていはResourcesと呼ばれます、しかしiOSでは、それはメインバンドルディレクトリです。)例えば、あなたがモダンバンドルを持つMacアプリを持つと仮定すると、あなたは@"Documentation"subpathパラメータに対して指定します。このメソッドは、最初にバンドルのContents/Resources/Documentationディレクトリ、続けて各言語固有の.lprojディレクトリのDocumentation下位ディレクトリの中をのぞきます。(言語固有のディレクトリに対する検索順序はユーザの環境設定と一致します。)このメソッドは、これらの位置のどれかでの何か他の下位ディレクトリを始めから終わりまで再帰呼び出ししません。どのようにローカライズされたリソースが見つけられるかに関する詳細は、The Bundle Search PatternBundle Programming Guideで読んでください。

See Also 参照

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

Related Documentation 関連文書