gmime-iconv

gmime-iconv —

Synopsis




void        g_mime_iconv_init               (void);
void        g_mime_iconv_shutdown           (void);
iconv_t     g_mime_iconv_open               (const char *to,
                                             const char *from);
#define     g_mime_iconv                    (cd,inbuf,inleft,outbuf,outleft)
int         g_mime_iconv_close              (iconv_t cd);

Description

Details

g_mime_iconv_init ()

void        g_mime_iconv_init               (void);

Initialize GMime's iconv cache. This *MUST* be called before any gmime-iconv interfaces will work correctly.


g_mime_iconv_shutdown ()

void        g_mime_iconv_shutdown           (void);

Frees internal iconv caches created in #g_mime_iconv_init().


g_mime_iconv_open ()

iconv_t     g_mime_iconv_open               (const char *to,
                                             const char *from);

Allocates a coversion descriptor suitable for converting byte sequences from charset from to charset to. The resulting descriptor can be used with iconv (or the g_mime_iconv wrapper) any number of times until closed using g_mime_iconv_close.

to : charset to convert to
from : charset to convert from
Returns :a new conversion descriptor for use with iconv on success or (iconv_t) -1 on fail as well as setting an appropriate errno value.

g_mime_iconv()

#define     g_mime_iconv(cd,inbuf,inleft,outbuf,outleft)

cd :
inbuf :
inleft :
outbuf :
outleft :

g_mime_iconv_close ()

int         g_mime_iconv_close              (iconv_t cd);

Closes the iconv descriptor cd.

cd : iconv conversion descriptor
Returns :0 on success or -1 on fail as well as setting an appropriate errno value.