mgtk_check_version ()

mconstchars         mgtk_check_version                  (muint required_major,
                                                         muint required_minor,
                                                         muint required_micro);

stability: Unstable

Checks that the MGtk library in use is compatible with the given version. Generally you would pass in the constants MGTK_MAJOR_VERSION, MGTK_MINOR_VERSION, MGTK_MICRO_VERSION as the three arguments to this function; that produces a check that the library in use is compatible with the version of MGtk the application or module was compiled against.

Compatibility is defined by two things: first the version of the running library is newer than the version required_major.required_minor.required_micro. Second the running library must be binary compatible with the version required_major.required_minor.required_micro (same major version.)

#include <mgtk.h>
#include <glib/gprintf.h>


    int
    mgtk_main ( argc, argv )
{
    mgtk_main_init ( argc, argv );

    g_printf ( "\n mgtk_check_version: %s ", ifelse ( mgtk_check_version ( 0,0,0 ) == NULL,
                                                      "is compatible",
                                                      mgtk_check_version ( 0,0,0 ) ) );

    return MCORRECT;
}

  

Since 0.0.1

mgtk_major_version

extern const muint mgtk_major_version;

The major version number of the MGtk library. (e.g. in MGtk version 1.2.5 this is 1.)

This variable is in the library, so represents the MGtk library you have linked against. Contrast with the MGTK_MAJOR_VERSION macro, which represents the major version of the MGtk headers you have included.

mgtk_minor_version

extern const muint mgtk_minor_version;

The minor version number of the MGtk library. (e.g. in MGtk version 1.2.5 this is 2.)

This variable is in the library, so represents the MGtk library you have linked against. Contrast with the MGTK_MINOR_VERSION macro, which represents the minor version of the MGtk headers you have included.

mgtk_micro_version

extern const muint mgtk_micro_version;

The micro version number of the MGtk library. (e.g. in MGtk version 1.2.5 this is 5.)

This variable is in the library, so represents the MGtk library you have linked against. Contrast with the MGTK_MICRO_VERSION macro, which represents the micro version of the MGtk headers you have included.

mgtk_interface_age

extern const muint mgtk_interface_age;

This is the interface age passed to libtool. If libtool means nothing to you, don't worry about it. ;-)

mgtk_binary_age

extern const muint mgtk_binary_age;

This is the binary age passed to libtool. If libtool means nothing to you, don't worry about it. ;-)

MGTK_CHECK_VERSION()

#define             MGTK_CHECK_VERSION(major,minor,micro)

stability: Unstable

Checks the version of the MGtk library.

    if (!MGTK_CHECK_VERSION (1, 2, 0))
    g_error ("MGtk version 1.2.0 or above is needed");