Instance Method

URLsForResourcesWithExtension:subdirectory:localization:

Returns an array containing the file URLs for all bundle resources having the specified filename extension, residing in the specified resource subdirectory, and limited to global resources and those associated with the specified localization.

Declaration

- (NSArray<NSURL *> *)URLsForResourcesWithExtension:(NSString *)ext subdirectory:(NSString *)subpath localization:(NSString *)localizationName;

Parameters

extension

The filename extension of the files to locate.

If you specify an empty string or nil, the extension is assumed not to exist and all of the files in subpath are returned.

subpath

The name of the bundle subdirectory to search.

localizationName

The language ID for 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

An array containing the file URLs for all bundle resources matching the specified criteria. This method returns an empty array if no matching resource files are found.

Discussion

This method is equivalent to URLsForResourcesWithExtension:subdirectory:, except that only nonlocalized resources and those in the language-specific .lproj directory specified by localizationName are searched.

See Also

Finding Resource Files

- URLForResource:withExtension:subdirectory:

Returns the file URL for the resource file identified by the specified name and extension and residing in a given bundle directory.

- URLForResource:withExtension:

Returns the file URL for the resource identified by the specified name and file extension.

- URLsForResourcesWithExtension:subdirectory:

Returns an array of file URLs for all resources identified by the specified file extension and located in the specified bundle subdirectory.

- URLForResource:withExtension:subdirectory:localization:

Returns the file URL 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.

+ URLForResource:withExtension:subdirectory:inBundleWithURL:

Creates and returns a file URL for the resource with the specified name and extension in the specified bundle.

+ URLsForResourcesWithExtension:subdirectory:inBundleWithURL:

Returns an array containing the file URLs for all bundle resources having the specified filename extension, residing in the specified resource subdirectory, within the specified bundle.

- pathForResource:ofType:

Returns the full pathname for the resource identified by the specified name and file extension.

- pathForResource:ofType:inDirectory:

Returns the full pathname for the resource identified by the specified name and file extension and located in the specified bundle subdirectory.

- pathForResource: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.

- pathsForResourcesOfType:inDirectory:

Returns an array containing the pathnames for all bundle resources having the specified filename extension and residing in the resource subdirectory.

- pathsForResourcesOfType:inDirectory:forLocalization:

Returns an array containing the file for all bundle resources having the specified filename extension, residing in the specified resource subdirectory, and limited to global resources and those associated with the specified localization.

+ pathForResource:ofType:inDirectory:

Returns the full pathname for the resource file identified by the specified name and extension and residing in a given bundle directory.

+ pathsForResourcesOfType:inDirectory:

Returns an array containing the pathnames for all bundle resources having the specified extension and residing in the bundle directory at the specified path.