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

url(forResource:withExtension:subdirectory:)

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

Declaration 宣言 

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

Parameters パラメータ

name

The name of a resource file contained in the directory specified by subpath. subpathによって指定されるディレクトリの中に含まれるあるリソースファイルの名前。

If you specify nil, the method returns the first resource file it finds with the specified extension in that directory. あなたが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 path of a top-level bundle directory. This must be a valid path. For example, to specify the bundle directory for a Mac app, you might specify the path /Applications/MyApp.app. トップレベルバントルディレクトリのパス。これは有効なパスでなければなりません。例えば、あるMacアプリに対するバンドルディレクトリを指定するには、あなたはパス/Applications/MyApp.appを指定するかもしれません。

Return Value 戻り値

The file URL for the resource file or nil if the file could not be located. This method also returns nil if the bundle specified by the bundlePath parameter does not exist or is not a readable directory. リソースファイルに対するファイルURL、またはファイルが捜し出されることができなかったならばnil。このメソッドはまた、bundlePathパラメータによって指定されたバンドルが存在しないまたは読み出し可能なディレクトリでないならばnilを返します。

Discussion 議論

For details on how localized resources are found, read The Bundle Search Pattern in Bundle Programming Guide. どのようにローカライズされたリソースが見つけられるかに関する詳細は、The Bundle Search PatternをBundle Programming Guideで読んでください。

See Also 参照

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

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 url(forResource: String?, withExtension: String?, subdirectory: String?, localization: String?) -> URL?
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を返します。
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. 指定されたファイル名拡張子を持ち、指定されたパスでのバンドルディレクトリに属する、全てのバンドルリソースに対するパス名を含んでいる配列を返します。