gmime-charset

Name

gmime-charset -- 

Synopsis



void        g_mime_charset_map_init         (void);
const char* g_mime_charset_locale_name      (void);
const char* g_mime_charset_name             (const char *charset);
void        g_mime_charset_init             (GMimeCharset *charset);
void        g_mime_charset_step             (GMimeCharset *charset,
                                             const char *in,
                                             size_t len);
const char* g_mime_charset_best_name        (GMimeCharset *charset);
const char* g_mime_charset_best             (const char *in,
                                             size_t inlen);

Description

Details

g_mime_charset_map_init ()

void        g_mime_charset_map_init         (void);

Initializes the locale charset variable for later calls to gmime_charset_locale_name. Only really needs to be called for non- iso-8859-1 locales.


g_mime_charset_locale_name ()

const char* g_mime_charset_locale_name      (void);

Gets the user's locale charset (or iso-8859-1 by default).

Returns :

the user's locale charset (or iso-8859-1 by default).


g_mime_charset_name ()

const char* g_mime_charset_name             (const char *charset);

Attempts to find an iconv-friendly charset name for charset.

charset :

charset name

Returns :

an iconv-friendly charset name for charset.


g_mime_charset_init ()

void        g_mime_charset_init             (GMimeCharset *charset);

Initializes a charset mask structure.

charset :

charset mask


g_mime_charset_step ()

void        g_mime_charset_step             (GMimeCharset *charset,
                                             const char *in,
                                             size_t len);

Steps through the input buffer 1 unicode character (glyph) at a time (ie, not necessarily 1 byte at a time). Bitwise 'and' our charset->mask with the mask for each glyph. This has the effect of limiting what charsets our charset->mask can match.

charset :

in :

input text buffer (must be in UTF-8)

len :

input buffer length


g_mime_charset_best_name ()

const char* g_mime_charset_best_name        (GMimeCharset *charset);

Gets the best charset name based on the charset mask charset.

charset :

charset mask

Returns :

a pointer to a string containing the best charset name that can represent the charset mask charset.


g_mime_charset_best ()

const char* g_mime_charset_best             (const char *in,
                                             size_t inlen);

Computes the best charset to use to encode this text buffer.

in :

a UTF-8 text buffer

inlen :

length of in

Returns :

the charset name best suited for the input text or NULL if it is US-ASCII safe.