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

url(forResource:withExtension:subdirectory:localization:)

Returns the file URL for the resource identified by the specified name and file extension, located in the specified bundle subdirectory, and limited to global resources and those associated with the specified localization. 指定された名前とファイル拡張子によって識別され、指定されたバンドル下位ディレクトリに位置して、そしてグローバルリソースでそして指定されたローカライゼーションと関連付けられるものに限られる、リソースに対するファイルURLを返します。

Declaration 宣言

func url(forResource name: String?, 
withExtension ext: String?, 
subdirectory subpath: String?, 
localization localizationName: String?) -> URL?

Parameters パラメータ

name: The name of the resource file. リソースファイルの名前。

If you specify nil, the method returns the first resource file it finds that matches the remaining criteria. あなたがnilを指定するならば、このメソッドは、それが最初に見つける、残りの基準に合致するリソースファイルを返します。
extension: The filename extension of the file to locate. 捜し出すファイルのファイル名拡張子。

If you specify an empty string or nil, the extension is assumed not to exist and the file URL is the first file encountered that exactly matches name. あなたが空の文字列またはnilを指定するならば、拡張子は存在しないとみなされます、そしてファイルURLは最初に出くわしたぴったりnameに一致するファイルです。
subpath: The name of the bundle subdirectory to search. 調査することになるバンドル下位ディレクトリの名前。
localizationName: The language ID for the localization. This parameter should correspond to the name of one of the bundle's language-specific resource directories without the .lproj extension. ローカライゼーションに対する言語ID。このパラメータは、バンドルのもつ言語特有リソースディレクトリの１つの.lproj拡張子なしの名前と一致しなければなりません。

Return Value 戻り値

The file URL for the resource file or nil if the file could not be located. リソースファイルに対するファイルURL、またはファイルが捜し出されることができなかったならばnil。

Discussion 議論

This method is equivalent to urls(forResourcesWithExtension:subdirectory:), except that only nonlocalized resources and those in the language-specific .lproj directory specified by localizationName are searched. このメソッドはurls(forResourcesWithExtension:subdirectory:)と等しいです、しかしローカライズされないリソースと言語特有.lprojディレクトリでlocalizationNameによって指定されるもの中のそういったものだけが検索されることを除きます。

There should typically be little reason to use this method—see Getting the Current Language and Locale. See also preferredLocalizations(from:forPreferences:) for how to determine what localizations are available. 一般的にこのメソッドを使う理由はほとんどありません — Getting the Current Language and Localeを見てください。またpreferredLocalizations(from:forPreferences:)をどんなローカライゼーションが利用可能か明らかにする方法として見てください。

See Also 参照

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

func url(forResource: String?, withExtension: String?, subdirectory: String?) -> URL?

Returns the file URL for the resource file identified by the specified name and extension and residing in a given bundle directory. 指定された名前と拡張子によって識別され、そして与えられたバンドルディレクトリに属する、リソースファイルに対するファイルURLを返します。

func url(forResource: String?, withExtension: String?) -> URL?

Returns the file URL for the resource identified by the specified name and file extension. 指定された名前とファイル拡張子によって識別されるリソースに対するファイルURLを返します。

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

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

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

Returns an array containing the file URLs for all bundle resources having the specified filename extension, residing in the specified resource subdirectory, and limited to global resources and those associated with the specified localization. 指定されたファイル名拡張子を持ち、指定されたリソース下位ディレクトリに属して、そしてグローバルリソースでそして指定されたローカライゼーションと関連付けられるものに限られる、全てのバンドルリソースに対するファイルURLからなる配列を返します。

class func url(forResource: String?, withExtension: String?, subdirectory: String?, in: URL) -> URL?

Creates and returns a file URL for the resource with the specified name and extension in the specified bundle. 指定されたバンドルにおいて、指定された名前と拡張子を持つリソースに対するファイルURLを作成して返します。

class func urls(forResourcesWithExtension: String?, subdirectory: String?, in: URL) -> [URL]?

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

func path(forResource: String?, ofType: String?) -> String?

Returns the full pathname for the resource identified by the specified name and file extension. 指定された名前とファイル拡張子によって識別されるリソースに対する完全パス名を返します。

func path(forResource: String?, ofType: String?, inDirectory: String?) -> String?

Returns the full pathname for the resource identified by the specified name and file extension and located in the specified bundle subdirectory. 指定されたバンドル下位ディレクトリに位置して、指定された名前とファイル拡張子によって識別されるリソースに対する完全パス名を返します。

func path(forResource: String?, ofType: String?, inDirectory: String?, forLocalization: String?) -> String?

Returns the full pathname for the resource identified by the specified name and file extension, located in the specified bundle subdirectory, and limited to global resources and those associated with the specified localization. 指定された名前とファイル拡張子によって識別され、指定されたバンドル下位ディレクトリに位置して、そしてグローバルリソースでそして指定されたローカライゼーションと関連付けられるものに限られる、リソースに対する完全パス名を返します。

func paths(forResourcesOfType: String?, inDirectory: String?) -> [String]

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

func paths(forResourcesOfType: String?, inDirectory: String?, forLocalization: String?) -> [String]

Returns an array containing the file for all bundle resources having the specified filename extension, residing in the specified resource subdirectory, and limited to global resources and those associated with the specified localization. 指定されたファイル名拡張子を持ち、指定されたリソース下位ディレクトリに属して、そしてグローバルリソースでそして指定されたローカライゼーションと関連付けられるものに限られる、全てのバンドルリソースに対するファイルからなる配列を返します。

class func path(forResource: String?, ofType: String?, inDirectory: String) -> String?

Returns the full pathname for the resource file identified by the specified name and extension and residing in a given bundle directory. 指定された名前と拡張子によって識別され、そして与えられたバンドルディレクトリに属する、リソースファイルに対する完全パス名を返します。

class func paths(forResourcesOfType: String?, inDirectory: String) -> [String]

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