## 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.