Returns the file URL for the resource file identified by the specified name and extension and residing in a given bundle directory.
SDKs
- iOS 4.0+
- macOS 10.6+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
Framework
- Foundation
Declaration
Parameters
name
The name of a resource file contained in the directory specified by
subpath
.If you specify
nil
, the method returns the first resource file it finds with the specified extension in that directory.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 matchesname
.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/My
.App .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 bundle
parameter does not exist or is not a readable directory.
Discussion
For details on how localized resources are found, read The Bundle Search Pattern in Bundle Programming Guide.