fileDescriptorForPath:searchingInAssetPackWithIdentifier:error:

Opens and returns a file descriptor for the asset file at the specified relative path.

Declaration

- (int) fileDescriptorForPath:(NSString *) path searchingInAssetPackWithIdentifier:(NSString *) assetPackIdentifier error:(NSError **) error;

Parameters

path:
The relative file path.
assetPackIdentifier:
The identifier of the asset pack in which you want to search for the file or nil if you want to search in all asset packs.
error:
A pointer to an error that will be set if an error occurs. If no file is found at path, then it will point to an NSError object with Bamanagederrorcodefilenotfound as its code.

Return Value

A descriptor for the opened file.

Discussion

All asset packs share the same namespace, so you can treat the overall collection of downloaded asset packs as if it were a single root directory that contains all of your subdirectories and asset files, regardless of the specific asset pack in which any particular file resides. If there’s a file-path collision across multiple asset packs, then it’s undefined from which asset pack the file will be opened unless you explicitly limit the search to a particular asset pack by passing a non-nil identifier to the assetPackIdentifier parameter. A return value of -1 indicates that an error occurred.