インスタンスメソッド


path(forResource:ofType:inDirectory:)


指定された名前とファイル拡張子で識別され、指定されたバンドルのサブディレクトリにあるリソースの完全なパス名を返します。


iOS 2.0+ iPadOS 2.0+ Mac Catalyst 13.0+ macOS 10.0+ tvOS 9.0

visionOS 1.0+ watchOS 2.0+

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




パラメータ


name

リソースファイルの名前。


nil を指定すると、メソッドは、残りの条件に一致する見つけた最初のリソースファイルを返します。


extension

検索すべきファイルのファイル名拡張子。


空の文字列または nil を指定した場合、subpath とそのサブディレクトリ内のすべてのファイルが返されます。拡張子が指定されている場合は、サブディレクトリは検索されません。


subpath

バンドルのサブディレクトリの名前。



戻り値


リソースファイルの完全なパス名。ファイルが見つからない場合は nil になります。


議論


subpathnil の場合、このメソッドは、最上位のローカライズされていないリソースディレクトリと、全ての言語固有のディレクトリの最上位を検索します。(macOS では、最上位のローカライズされていないリソースディレクトリは通常 Resources と呼ばれますが、iOS では main のバンドルディレクトリです。) たとえば、最新のバンドルを含む Mac アプリがあり、subpath パラメータに @"Documentation" を指定したとします。このメソッドは、最初にバンドルの Contents/Resources/Documentation ディレクトリを検索し、次に各言語固有の .lproj ディレクトリの Documentation サブディレクトリを検索します。


このメソッドがサブディレクトリを再帰的に処理するかどうかは、extension パラメータに依存します。nil または空の文字列の場合は再帰的に処理され、それ以外の場合は再帰的に処理されません。(言語固有のディレクトリの検索順序は、ユーザの設定に応じて異なります。)ローカライズされたリソースの検索方法の詳細については、Bundle プログラミング ガイド (Bundle Programming Guide) の Bundle 検索パターン (The Bundle Search Pattern) を参照してください。





以下も見よ


リソースファイルの検索


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

指定された名前と拡張子で識別され、与えられたバンドルディレクトリに存在するリソースファイルのファイル URL を返します。


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

指定された名前とファイル拡張子によって識別されるリソースのファイル URL を返します。


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

指定されたファイル拡張子で識別され、指定されたバンドルのサブディレクトリ内にあるすべてのリソースのファイル URL の配列を返します。


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

指定されたバンドルのサブディレクトリにあり、グローバルリソースと指定されたローカリゼーションに関連したリソースに限定され、指定された名前とファイル拡張子で識別されるリソースのファイル URL を返します。


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

指定されたファイル名拡張子を持ち、指定されたリソースのサブディレクトリ内に存在し、グローバルリソースと指定されたローカリゼーションに関連したリソースに限定されたすべてのバンドルリソースのファイル URL を含む配列を返します。


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

指定されたバンドル内の指定された名前と拡張子を持つリソースのファイル URL を作成して返します。


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

指定されたバンドル内の指定されたリソースのサブディレクトリに存在する、指定されたファイル名拡張子を持つすべてのバンドルリソースのファイル URL を含む配列を返します。


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

指定された名前とファイル拡張子によって識別されるリソースの完全なパス名を返します。


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

指定された名前とファイル拡張子で識別され、指定されたバンドルのサブディレクトリにあり、グローバルリソースと指定されたローカリゼーションに関連したリソースに限定されたリソースの完全なパス名を返します。


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

指定されたファイル名拡張子を持ち、リソースのサブディレクトリに存在するすべてのバンドルリソースのパス名を含む配列を返します。


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

指定されたファイル名拡張子を持ち、指定されたリソースのサブディレクトリ内に存在し、グローバルリソースと指定されたローカリゼーションに関連したリソースに限定されたすべてのバンドルリソースのファイルを含む配列を返します。


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

指定された名前と拡張子で識別され、与えられたバンドルのディレクトリに存在するリソースファイルの完全なパス名を返します。


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

指定された拡張子を持ち、指定されたパスにあるバンドルのディレクトリに存在するすべてのバンドルリソースのパス名を含む配列を返します。


Bundle











トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ