Function

CFBundleGetMainBundle

Returns an application’s main bundle.

Declaration

CFBundleRef CFBundleGetMainBundle(void);

Return Value

A CFBundle object representing the application’s main bundle, or NULL if it is not possible to create a bundle. Ownership follows the The Get Rule.

Discussion

CFBundle creates a main bundle whenever it possibly can, even for unbundled apps. There are a few situations in which it is not possible, so you should check the return value against NULL, but this happens only in exceptional circumstances.

For an explanation of the main bundle, see Locating and Opening Bundles in Bundle Programming Guide.

See Also

Creating and Accessing Bundles

CFBundleCreate

Creates a CFBundle object.

CFBundleCreateBundlesFromDirectory

Searches a directory and constructs an array of CFBundle objects from all valid bundles in the specified directory.

CFBundleGetAllBundles

Returns an array containing all of the bundles currently open in the application.

CFBundleGetBundleWithIdentifier

Locate a bundle given its program-defined identifier.