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

urls(forResourcesWithExtension:subdirectory:)

Returns an array of file URLs for all resources identified by the specified file extension and located in the specified bundle subdirectory. 指定されたファイル拡張子によって識別され、そして指定されたバンドル下位ディレクトリに位置する、全てのリソースに対するファイルURLからなる配列を返します。

Declaration 宣言

func urls(forResourcesWithExtension ext: String?, 
subdirectory subpath: String?) -> [URL]?

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. バンドル下位ディレクトリの名前。

Return Value 戻り値

An array of file URLs for the resource files or nil if no files could be located at subpath with extension. Returns an empty array if no matching resource files are found. リソースファイルに対するファイルURLからなる配列、またはnil、もしファイルがsubpathextensionを使って捜し出されることができないならば。合致するリソースファイルが見つけられないならば、空の配列を返します。

Discussion 議論

If subpath is nil, this method searches the top-level non-localized resource directory and the top-level of any language-specific directories. (In macOS, the top-level non-localized resource directory is typically called Resources but in iOS, it is the main bundle directory.) subpathnilならば、このメソッドはトップレベルのローカライズされないリソースディレクトリそして言語固有のディレクトリのトップレベルを調査します。(macOSにおいて、トップレベルのローカライズされないリソースディレクトリは、たいていはResourcesと呼ばれます、しかしiOSでは、それはメインバンドルディレクトリです。)

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 more details see The Bundle Search Pattern in Bundle Programming Guide. 例えば、あなたがモダンバンドルを持つMacアプリを持つと仮定すると、あなたは@"Documentation"subpathパラメータに対して指定します。このメソッドは、最初にバンドルのContents/Resources/Documentationディレクトリ、続けて各言語固有の.lprojディレクトリのDocumentation下位ディレクトリの中をのぞきます。(言語固有のディレクトリに対する検索順序はユーザの環境設定と一致します。)このメソッドは、これらの位置のどれかでの何か他の下位ディレクトリを始めから終わりまで再帰呼び出ししません。詳細としてThe Bundle Search PatternBundle Programming Guideで見てください。

See Also 参照

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