ML_MAJOR_VERSION

The major release number that indicates general and essential changes to the ML (which usually imply binary and header file incompatibilities).

ML_MAJOR_CAPI_VERSION

Changes to this number indicate binary incompatibilities of the C-API of the ML which require a recompilation of applications using the ML via the C-API.

ML_CPPAPI_VERSION

Changes to this number indicate binary incompatibilities of the C++ interface of the ML which require a recompilation of all classes using C++ ML symbols. Also, changes to this number sometimes indicate C++ header file incompatibilities. Note that the C++ API is also considered changed when the C-API has changed.

ML_CAPI_REVISION

Changes to this number indicate a revision of the C-API of the ML which normally does not require a recompilation of applications using the ML via the C-API; this is typically caused by additional functionality in the C-API.

ML_REVISION

Changes to this number indicate any revision of the ML which does not influence the binary compatibility (also docs, comments, installers); thus dependent classes do not need to be recompiled.

ML_VERSION_STRING

The version string is put together by the above five strings, the individual strings are separated by ".". So, the version string would begin with:

ML_MAJOR_VERSION.ML_MAJOR_CAPI_VERSION. (to be followed by the other three above strings).

void MLGetVersion(int *majorVersion, int *majorCAPIVersion, int *verCPPAPI, int *revCAPI, int *rev, const char **vString);

Returns version information about the ML. It is legal to call it before the MLInitializeUtils() is called.

For all parameters, a NULL may be passed if that parameter is not needed.

int MLIsCAPILinkCompatible(int majorVersion, int majorCAPIVersion, int revCAPI);

Checks whether the ML API is link compatible. It is legal to call this function before MLInitializeUtils() is called. Normally, it is not necessary to call this function "manually" because the ML does these checks automatically when the ML is initialized or modules are loaded. A typical call looks like the following:

if (!MLIsCAPILinkCompatible(ML_MAJOR_VERSION, ML_MAJOR_CAPI_VERSION, ML_CAPI_REVISION))
{
  handleErr();
}

Parameters are

int MLIsCPPAPILinkCompatible(int majorVersion, int majorCAPIVersion, int verCPPAPI, int revCAPI);

Checks whether the C++-API of the ML is link compatible. It is legal to call this function before MLInitializeUtils() is called.

Normally, it is not necessary to call this function "manually" because the ML does these checks automatically when initializing the ML is initialized or modules are loaded. A typical call looks like the following:

if (!MLIsCPPAPILinkCompatible(ML_MAJOR_VERSION,
                              ML_MAJOR_CAPI_VERSION,
                              ML_CPPAPI_VERSION,
                              ML_CAPI_REVISION))
{
  handleErr();
}