gmime-iconv-utils

gmime-iconv-utils — High-level routines for converting text from one charset to another

Synopsis

char*               g_mime_iconv_strdup                 (iconv_t cd,
                                                         const char *str);
char*               g_mime_iconv_strndup                (iconv_t cd,
                                                         const char *str,
                                                         size_t n);
char*               g_mime_iconv_utf8_to_locale         (const char *str);
char*               g_mime_iconv_utf8_to_locale_length  (const char *str,
                                                         size_t n);
char*               g_mime_iconv_locale_to_utf8         (const char *str);
char*               g_mime_iconv_locale_to_utf8_length  (const char *str,
                                                         size_t n);

Description

Charset conversion utility functions.

Details

g_mime_iconv_strdup ()

char*               g_mime_iconv_strdup                 (iconv_t cd,
                                                         const char *str);

Allocates a new string buffer containing str converted to the destination charset described in cd.

cd :

 conversion descriptor

str :

 string in source charset

Returns :

 a new string buffer containing the original string converted to the new charset.

g_mime_iconv_strndup ()

char*               g_mime_iconv_strndup                (iconv_t cd,
                                                         const char *str,
                                                         size_t n);

Allocates a new string buffer containing the first n bytes of str converted to the destination charset as described by the conversion descriptor cd.

cd :

 conversion descriptor

str :

 string in source charset

n :

 number of bytes to convert

Returns :

 a new string buffer containing the first n bytes of str converted to the destination charset as described by the conversion descriptor cd.

g_mime_iconv_utf8_to_locale ()

char*               g_mime_iconv_utf8_to_locale         (const char *str);

Allocates a new string buffer containing str converted to the user's locale charset.

str :

 string in UTF-8 charset

Returns :

 a new string buffer containing str converted to the user's locale charset.

g_mime_iconv_utf8_to_locale_length ()

char*               g_mime_iconv_utf8_to_locale_length  (const char *str,
                                                         size_t n);

Allocates a new string buffer containing the first n bytes of str converted to the user's locale charset.

str :

 string in UTF-8 charset

n :

 number of bytes to convert

Returns :

 a new string buffer containing the first n bytes of str converted to the user's locale charset.

g_mime_iconv_locale_to_utf8 ()

char*               g_mime_iconv_locale_to_utf8         (const char *str);

Allocates a new string buffer containing str in UTF-8.

str :

 string in locale charset

Returns :

 a new string buffer containing str converted to UTF-8.

g_mime_iconv_locale_to_utf8_length ()

char*               g_mime_iconv_locale_to_utf8_length  (const char *str,
                                                         size_t n);

Allocates a new string buffer containing the first n bytes of str converted to UTF-8.

str :

 string in locale charset

n :

 number of bytes to convert

Returns :

 a new string buffer containing the first n bytes of str converted to UTF-8.
Generated by GTK-Doc V1.10