Contents

path(forResource:ofType:inDirectory:forLocalization:)

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.

Declaration

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

Parameters

  • name:

    The name of the resource file.

    If you specify nil, the method returns the first resource file it finds that matches the remaining criteria.

  • ext:

    The filename extension of the files to locate.

    If you specify an empty string or nil, the extension is assumed not to exist and the file is the first file encountered that exactly matches name.

  • subpath:

    The name of the bundle subdirectory to search.

  • localizationName:

    The language ID for of the localization. This parameter should correspond to the name of one of the bundle’s language-specific resource directories without the .lproj extension.

Return Value

The full pathname for the resource file or nil if the file could not be located.

Discussion

This method is equivalent to path(forResource:ofType:inDirectory:), except that only nonlocalized resources and those in the language-specific .lproj directory specified by localizationName are searched.

There should typically be little reason to use this method—see Getting the Current Language and Locale. See also preferredLocalizations(from:forPreferences:) for how to determine what localizations are available.

See Also

Finding Resource Files