GNU Info

(gimpprint.info)Version functions

---

Prev: Settings functions Up: Functions

---

Enter node , (file) or (file)node

Version functions
=================

 - Function: const char * stp_check_version (unsigned int
          REQUIRED_MAJOR,
     unsigned int REQUIRED_MINOR, unsigned int REQUIRED_MICRO)

     This function checks whether the version of libgimpprint that the
     program is linked with is equal to the version number passed to
     it. If the version is the same, the function returns `NULL'. If
     any of the version numbers do not match (i.e. the library version
     is too old or too new), a string containing a desription of the
     difference is returned. The first error found is returned. The
     function checks in the order major, minor, micro.

Version macros
--------------

 - Macro: GIMPPRINT_CHECK_VERSION (major,minor,micro)
     This macro returns zero if the version of the libgimpprint headers
     are greater or equal to the version given as an argument. It
     returns nonzero if the version of the libgimpprint headers are
     less than the argument.

 - Macro: GIMPPRINT_MAJOR_VERSION

 - Macro: GIMPPRINT_MINOR_VERSION

 - Macro: GIMPPRINT_MICRO_VERSION

 - Macro: GIMPPRINT_CURRENT_INTERFACE

 - Macro: GIMPPRINT_BINARY_AGE

 - Macro: GIMPPRINT_INTERFACE_AGE

   These macros are integers holding the version numbers. They should be
used for compile-time checking only. To check version numbers at
run-time, use the equivalent variables. Note that at present (4.1.x
development branch) the library interface version numbers are not used.

Version variables
-----------------

 - Variable: const unsigned int gimpprint_major_version

 - Variable: const unsigned int gimpprint_minor_version

 - Variable: const unsigned int gimpprint_micro_version

 - Variable: const unsigned int gimpprint_current_interface

 - Variable: const unsigned int gimpprint_binary_age

 - Variable: const unsigned int gimpprint_interface_age

   These variables hold the library version numbers. Because the
version of the library may change on a system using shared libraries,
these should be used instead of the equivalent macros when checking the
library version at run-time. Note that library interface version
numbers are not used in the development branch, but are in the stable
branch.