Contents

CFBundleCopyResourceURLForLocalization(_:_:_:_:_:)

Returns the location of a localized resource in a bundle.

Declaration

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

Parameters

  • bundle:

    The bundle to examine.

  • resourceName:

    The name of the requested resource.

  • resourceType:

    The abstract type of the resource to locate. The type is expressed as a filename extension, such as jpg.

  • subDirName:

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

  • localizationName:

    The name of the localization. This value should correspond to the name of one of the bundle’s language-specific resource directories without the .lproj extension. (This parameter is treated literally: If you pass "de", the function will not match resources in a German.lproj directory in the bundle.)

Return Value

The location of a localized resource in bundle, or NULL if the resource could not be found. Ownership follows the The Create Rule.

Discussion

Note that file names are case-sensitive, even on file systems (such as HFS+) that are not case sensitive with regards to file names.

You should typically have little reason to use this function (see Getting the Current Language and Locale)—CFBundle’s interfaces automatically apply the user’s preferences to determine which localized resource files to return in response to a programmatic request. See also CFBundleCopyBundleLocalizations(_:) for how to determine what localizations are available

See Also

Locating Bundle Resources