Standard Macros

GLIB_MAJOR_VERSION

#define GLIB_MAJOR_VERSION 1

The major version number of the GLib library.

GLIB_MINOR_VERSION

#define GLIB_MINOR_VERSION 2

The minor version number of the GLib library.

GLIB_MICRO_VERSION

#define GLIB_MICRO_VERSION 3

The micro version number of the GLib library.

GLIB_CHECK_VERSION()

#define     GLIB_CHECK_VERSION(major,minor,micro)

Checks the version of the GLib library. It returns TRUE if the GLib library is the same or newer than the given version.

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

G_DIR_SEPARATOR

#define     G_DIR_SEPARATOR

The directory separator character. This is '/' on Unix machines and '\' under Windows.

G_DIR_SEPARATOR_S

#define     G_DIR_SEPARATOR_S

The directory separator as a string. This is "/" on Unix machines and "\" under Windows.

G_SEARCHPATH_SEPARATOR

#define     G_SEARCHPATH_SEPARATOR

The search path separator character. This is ':' on Unix machines and ';' under Windows.

G_SEARCHPATH_SEPARATOR_S

#define     G_SEARCHPATH_SEPARATOR_S

The search path separator as a string. This is ":" on Unix machines and ";" under Windows.

TRUE

#define	TRUE	(!FALSE)

Defines the TRUE value for the gboolean type.

FALSE

#define	FALSE	(0)

Defines the FALSE value for the gboolean type.

NULL

#define	NULL	((void*) 0)

Defines the standard NULL pointer.

MIN()

#define MIN(a, b)  (((a) < (b)) ? (a) : (b))

Calculates the minimum of a and b.

MAX()

#define MAX(a, b)  (((a) > (b)) ? (a) : (b))

Calculates the maximum of a and b.

ABS()

#define ABS(a)	   (((a) < 0) ? -(a) : (a))

Calculates the absolute value of a. The absolute value is simply the number with any negative sign taken away.

For example,

• ABS(-10) is 10.

• ABS(10) is also 10.

CLAMP()

#define CLAMP(x, low, high)  (((x) > (high)) ? (high) : (((x) < (low)) ? (low) : (x)))

Ensures that x is between the limits set by low and high.

For example,

• CLAMP(5, 10, 15) is 10.

• CLAMP(15, 5, 10) is 10.

• CLAMP(20, 15, 25) is 20.

G_STRUCT_MEMBER()

#define     G_STRUCT_MEMBER(member_type, struct_p, struct_offset)

Returns a member of a structure at a given offset, using the given type.

G_STRUCT_MEMBER_P()

#define     G_STRUCT_MEMBER_P(struct_p, struct_offset)

Returns an untyped pointer to a given offset of a struct.

G_STRUCT_OFFSET()

#define     G_STRUCT_OFFSET(struct_type, member)

Returns the offset, in bytes, of a member of a struct.