![]() |
![]() |
![]() |
Pango Reference Manual | ![]() |
---|---|---|---|---|
#define PANGO_VERSION_ENCODE (major, minor, micro) #define PANGO_VERSION #define PANGO_VERSION_MAJOR #define PANGO_VERSION_MINOR #define PANGO_VERSION_MICRO #define PANGO_VERSION_STRING #define PANGO_VERSION_CHECK (major,minor,micro) int pango_version (void); const char* pango_version_string (void); const char* pango_version_check (int required_major, int required_minor, int required_micro);
The capital-letter macros defined here can be used to check the version of Pango at compile-time, and to encode Pango versions into integers. The functions can be used to check the version of the linked Pango library at run-time.
#define PANGO_VERSION_ENCODE(major, minor, micro)
This macro encodes the given Pango version into an integer. The numbers returned by PANGO_VERSION and pango_version() are encoded using this macro. Two encoded version numbers can be compared as integers.
major : | the major component of the version number |
minor : | the minor component of the version number |
micro : | the micro component of the version number |
#define PANGO_VERSION
The version of Pango available at compile-time, encoded using PANGO_VERSION_ENCODE().
#define PANGO_VERSION_MAJOR 1
The major component of the version of Pango available at compile-time.
#define PANGO_VERSION_MINOR 20
The minor component of the version of Pango available at compile-time.
#define PANGO_VERSION_MICRO 0
The micro component of the version of Pango available at compile-time.
#define PANGO_VERSION_STRING "1.20.0"
A string literal containing the version of Pango available at compile-time.
#define PANGO_VERSION_CHECK(major,minor,micro)
Checks that the version of Pango available at compile-time is not older than the provided version number.
major : | the major component of the version number |
minor : | the minor component of the version number |
micro : | the micro component of the version number |
int pango_version (void);
This is similar to the macro PANGO_VERSION except that it returns the encoded version of Pango available at run-time, as opposed to the version available at compile-time.
A version number can be encoded into an integer using PANGO_VERSION_ENCODE().
Returns : | The encoded version of Pango library available at run time. |
Since 1.16
const char* pango_version_string (void);
This is similar to the macro PANGO_VERSION_STRING except that it returns the version of Pango available at run-time, as opposed to the version available at compile-time.
Returns : | A string containing the version of Pango library available at run time. The returned string is owned by Pango and should not be modified or freed. |
Since 1.16
const char* pango_version_check (int required_major, int required_minor, int required_micro);
Checks that the Pango library in use is compatible with the given version. Generally you would pass in the constants PANGO_VERSION_MAJOR, PANGO_VERSION_MINOR, PANGO_VERSION_MICRO as the three arguments to this function; that produces a check that the library in use at run-time is compatible with the version of Pango 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.)
For compile-time version checking use PANGO_VERSION_CHECK().
required_major : | the required major version. |
required_minor : | the required minor version. |
required_micro : | the required major version. |
Returns : | NULL if the Pango library is compatible with the given version, or a string describing the version mismatch. The returned string is owned by Pango and should not be modified or freed. |
Since 1.16