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
、もしファイルがsubpath
でextension
を使って捜し出されることができないならば。合致するリソースファイルが見つけられないならば、空の配列を返します。
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.)
subpath
がnil
ならば、このメソッドはトップレベルのローカライズされないリソースディレクトリそして言語固有のディレクトリのトップレベルを調査します。(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 PatternをBundle Programming Guideで見てください。
See Also
参照
Finding Resource Files
リソースファイルを見つける