Function

CFBundleGetVersionNumber

Returns a bundle’s version number.

Declaration

UInt32 CFBundleGetVersionNumber(CFBundleRef bundle);

Parameters

bundle

The bundle to examine. The bundle’s version number can be number or a string of the standard form “2.5.3d5”.

Return Value

A vers resource style version number. If it is a string, it is automatically converted to the numeric representation, where the major version number is restricted to 2 BCD digits (in other words, it must be in the range 0-99) and the minor and bug fix version numbers are each restricted to a single BCD digit (0-9).

Discussion

This function is only supported for the vers resource style version numbers. Where other version number styles—namely X, or X.Y, or X.Y.Z—are used, you can use CFBundleGetValueForInfoDictionaryKey with the key kCFBundleVersionKey to extract the version number as a string from the bundle’s information dictionary.

Some version numbers of the form X, X.Y, and X.Y.Z may work with this function, if X <= 99, Y <= 9, and Z <= 9. Thus a version number 76.5.4 will work, but 76.12 will not work.

See Also

Getting Bundle Properties

CFBundleCopyBundleURL

Returns the location of a bundle.

CFBundleGetDevelopmentRegion

Returns the bundle’s development region from the bundle’s information property list.

CFBundleGetIdentifier

Returns the bundle identifier from a bundle’s information property list.

CFBundleGetInfoDictionary

Returns a bundle’s information dictionary.

CFBundleGetLocalInfoDictionary

Returns a bundle’s localized information dictionary.

CFBundleGetValueForInfoDictionaryKey

Returns a value (localized if possible) from a bundle’s information dictionary.

CFBundleCopyInfoDictionaryInDirectory

Returns a bundle’s information dictionary.

CFBundleCopyInfoDictionaryForURL

Returns the information dictionary for a given URL location.

CFBundleGetPackageInfo

Returns a bundle’s package type and creator.

CFBundleGetPackageInfoInDirectory

Returns a bundle’s package type and creator without having to create a CFBundle object.

CFBundleCopyExecutableArchitectures

Returns an array of CFNumbers representing the architectures a given bundle provides.

CFBundleCopyExecutableArchitecturesForURL

Returns an array of CFNumbers representing the architectures a given URL provides.