## gmime-iconv-utils

gmime-iconv-utils —

## Synopsis

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

## Description

## Details

### g_mime_iconv_strdup ()

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

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

`cd` : | conversion descriptor
`string` : | 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 *string,
                                                 size_t n);

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

`cd` : | conversion descriptor
`string` : | string in source charset
`n` : | number of bytes to convert
Returns : | a new string buffer containing the first `n` bytes of `string` 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 *string);

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

`string` : | string in UTF-8 charset
Returns : | a new string buffer containing `string` converted to the user's locale charset.

### g_mime_iconv_utf8_to_locale_length ()

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

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

`string` : | string in UTF-8 charset
`n` : | number of bytes to convert
Returns : | a new string buffer containing the first `n` bytes of `string` converted to the user's locale charset.

### g_mime_iconv_locale_to_utf8 ()

    char*       g_mime_iconv_locale_to_utf8     (const char *string);

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

`string` : | string in locale charset
Returns : | a new string buffer containing `string` converted to UTF-8.

### g_mime_iconv_locale_to_utf8_length ()

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

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

`string` : | string in locale charset
`n` : | number of bytes to convert
Returns : | a new string buffer containing the first `n` bytes of `string` converted to UTF-8.