## gmime

gmime — Initialization, shutdown and version-check routines

## Synopsis

    #define             GMIME_CHECK_VERSION                 (major,minor,micro)
    #define             GMIME_INIT_FLAG_UTF8
    void                g_mime_init                         (guint32 flags);
    void                g_mime_shutdown                     (void);
    extern              const guint gmime_major_version;
    extern              const guint gmime_minor_version;
    extern              const guint gmime_micro_version;
    extern              const guint gmime_binary_age;
    extern              const guint gmime_interface_age;
    gboolean            g_mime_check_version                (guint major,
                                                             guint minor,
                                                             guint micro);

## Description

Initialization, shutdown, and version-check functions.

## Details

### GMIME_CHECK_VERSION()

    #define GMIME_CHECK_VERSION(major,minor,micro) g_mime_check_version (major, minor, micro)

Macro that just calls `g_mime_check_version()`

`major` : | Minimum major version
`minor` : | Minimum minor version
`micro` : | Minimum micro version

### GMIME_INIT_FLAG_UTF8

    #define GMIME_INIT_FLAG_UTF8  (1 << 0)

Initialization flag to enable UTF-8 interfaces throughout GMime.

Note: this flag is really a no-op and remains only for backward compatablity. Interfaces will be UTF-8 whether this flag is used or not.

### g_mime_init ()

    void                g_mime_init                         (guint32 flags);

Initializes GMime.

Note: Calls `g_mime_charset_map_init()` and `g_mime_iconv_init()` as well.

`flags` : | initialization flags

### g_mime_shutdown ()

    void                g_mime_shutdown                     (void);

Frees internally allocated tables created in `g_mime_init()`. Also calls `g_mime_charset_map_shutdown()` and `g_mime_iconv_shutdown()`.

### gmime_major_version

    extern const guint gmime_major_version;

GMime's major version.

### gmime_minor_version

    extern const guint gmime_minor_version;

GMime's minor version.

### gmime_micro_version

    extern const guint gmime_micro_version;

GMime's micro version.

### gmime_binary_age

    extern const guint gmime_binary_age;

GMime's binary age.

### gmime_interface_age

    extern const guint gmime_interface_age;

GMime's interface age.

### g_mime_check_version ()

    gboolean            g_mime_check_version                (guint major,
                                                             guint minor,
                                                             guint micro);

Checks that the GMime library version meets the requirements of the required version.

`major` : | Minimum major version
`minor` : | Minimum minor version
`micro` : | Minimum micro version
Returns : | `TRUE` if the requirement is met or `FALSE` otherwise.