CFBundleCopyResourceURL(_:_:_:_:)

Declaration

func CFBundleCopyResourceURL(_ bundle: CFBundle!, _ resourceName: CFString!, _ resourceType: CFString!, _ subDirName: CFString!) -> CFURL!

Parameters

• bundle:

  The bundle to examine.

• resourceName:

  The name of the requested resource.

• resourceType:

  The abstract type of the requested resource. The type is expressed as a filename extension, such as jpg. Pass NULL if resourceName is the complete name of the file you’re looking for, including any extension.

• subDirName:

  The name of the subdirectory of the bundle’s resources directory to search. Pass NULL to search the standard CFBundle resource locations.

Return Value

A CFURL object describing the location of the requested resource, or NULL if the resource cannot be found. Ownership follows the The Create Rule.

Discussion

For example, if a bundle contains a subdirectory WaterSounds that includes a file Water1.aiff, you can retrieve the URL for the file using:

CFBundleCopyResourceURL(bundle, CFSTR("Water1"), CFSTR("aiff"), CFSTR("WaterSounds"));

See Also

Locating Bundle Resources

• CFBundleCloseBundleResourceMap(_:_:)
• CFBundleCopyResourceURLInDirectory(_:_:_:_:)
• CFBundleCopyResourceURLsOfType(_:_:_:)
• CFBundleCopyResourceURLsOfTypeInDirectory(_:_:_:)
• CFBundleCopyResourceURLForLocalization(_:_:_:_:_:)
• CFBundleCopyResourceURLsOfTypeForLocalization(_:_:_:_:)
• CFBundleOpenBundleResourceFiles(_:_:_:)
• CFBundleOpenBundleResourceMap(_:)