![]() |
![]() |
![]() |
GMime Reference Manual | ![]() |
---|
gmime-charsetgmime-charset — |
void g_mime_charset_map_init (void); void g_mime_charset_map_shutdown (void); const char* g_mime_locale_charset (void); const char* g_mime_locale_language (void); const char* g_mime_charset_language (const char *charset); const char* g_mime_charset_canon_name (const char *charset); const char* g_mime_charset_iconv_name (const char *charset); const char* g_mime_charset_name (const char *charset); const char* g_mime_charset_locale_name (void); const char* g_mime_charset_iso_to_windows (const char *isocharset); 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);
void g_mime_charset_map_init (void);
Initializes the locale charset variable for later calls to
g_mime_locale_charset()
. Only really needs to be called for non-
iso-8859-1 locales.
void g_mime_charset_map_shutdown (void);
Frees internal lookup tables created in g_mime_charset_map_init()
.
const char* g_mime_locale_charset (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). |
const char* g_mime_locale_language (void);
Gets the user's locale language code (or NULL
by default).
Returns : | the user's locale language code (or NULL by default).
|
const char* g_mime_charset_language (const char *charset);
Attempts to find a specific language code that is specific to
charset
. Currently only handles CJK and Russian/Ukranian
charset->lang mapping. Everything else will return NULL
.
charset : |
charset name |
Returns : | a language code that is specific to charset , or NULL on
fail.
|
const char* g_mime_charset_canon_name (const char *charset);
Attempts to find a canonical charset name for charset
.
Note: Will normally return the same value as
g_mime_charset_iconv_name()
unless the system iconv does not use
the canonical ISO charset names (such as using ISO8859-1 rather
than the canonical form ISO-8859-1).
charset : |
charset name |
Returns : | a canonical charset name for charset .
|
const char* g_mime_charset_iconv_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 .
|
const char* g_mime_charset_name (const char *charset);
g_mime_charset_name
is deprecated and should not be used in newly-written code.
Attempts to find an iconv-friendly charset name for charset
.
Note: This function is deprecated. Use g_mime_charset_iconv_name()
instead.
charset : |
charset name |
Returns : | an iconv-friendly charset name for charset .
|
const char* g_mime_charset_locale_name (void);
g_mime_charset_locale_name
is deprecated and should not be used in newly-written code.
Gets the user's locale charset (or iso-8859-1 by default).
Note: This function is deprecated. Use g_mime_locale_charset()
instead.
Returns : | the user's locale charset (or iso-8859-1 by default). |
const char* g_mime_charset_iso_to_windows (const char *isocharset);
Maps the ISO-8859-# charset to the equivalent Windows-CP125# charset.
isocharset : |
ISO-8859-# charset |
Returns : | equivalent Windows charset. |
void g_mime_charset_init (GMimeCharset *charset);
Initializes a charset mask structure.
charset : |
charset mask |
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 : |
charset structure |
in : |
input text buffer (must be in UTF-8) |
len : |
input buffer length |
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 .
|
<< gmime | gmime-iconv >> |