libcdio  0.92
Typedefs | Functions
utf8.h File Reference

UTF-8 support. More...

#include <cdio/types.h>

Go to the source code of this file.

Typedefs

typedef struct
cdio_charset_coverter_s 
cdio_charset_coverter_t
 Opaque characterset converter. More...
 

Functions

cdio_charset_coverter_tcdio_charset_converter_create (const char *src_charset, const char *dst_charset)
 Create a charset converter. More...
 
void cdio_charset_converter_destroy (cdio_charset_coverter_t *cnv)
 Destroy a characterset converter. More...
 
bool cdio_charset_convert (cdio_charset_coverter_t *cnv, char *src, int src_len, char **dst, int *dst_len)
 Convert a string from one character set to another. More...
 
bool cdio_charset_from_utf8 (cdio_utf8_t *src, char **dst, int *dst_len, const char *dst_charset)
 Convert a string from UTF-8 to another charset. More...
 
bool cdio_charset_to_utf8 (const char *src, size_t src_len, cdio_utf8_t **dst, const char *src_charset)
 Convert a string from another charset to UTF-8. More...
 

Detailed Description

UTF-8 support.

Typedef Documentation

typedef struct cdio_charset_coverter_s cdio_charset_coverter_t

Opaque characterset converter.

Function Documentation

bool cdio_charset_convert ( cdio_charset_coverter_t cnv,
char *  src,
int  src_len,
char **  dst,
int *  dst_len 
)

Convert a string from one character set to another.

Parameters
cnvA charset converter
srcSource string
src_lenLength of source string
dstReturns destination string
dst_lenIf non NULL, returns the length of the destination string
Returns
true if conversion was sucessful, false else.

The destination string must be freed by the caller with free(). If you pass -1 for src_len, strlen() will be used.

cdio_charset_coverter_t* cdio_charset_converter_create ( const char *  src_charset,
const char *  dst_charset 
)

Create a charset converter.

Parameters
src_charsetSource charset
dst_charsetDestination charset
Returns
A newly allocated charset converter
void cdio_charset_converter_destroy ( cdio_charset_coverter_t cnv)

Destroy a characterset converter.

Parameters
cnvA characterset converter
bool cdio_charset_from_utf8 ( cdio_utf8_t src,
char **  dst,
int *  dst_len,
const char *  dst_charset 
)

Convert a string from UTF-8 to another charset.

Parameters
srcSource string (0 terminated)
dstReturns destination string
dst_lenIf non NULL, returns the length of the destination string
dst_charsetThe characterset to convert to
Returns
true if conversion was sucessful, false else.

This is a convenience function, which creates a charset converter, converts one string and destroys the charset converter.

bool cdio_charset_to_utf8 ( const char *  src,
size_t  src_len,
cdio_utf8_t **  dst,
const char *  src_charset 
)

Convert a string from another charset to UTF-8.

Parameters
srcSource string
src_lenLength of the source string
dstReturns destination string (0 terminated)
src_charsetThe characterset to convert from
Returns
true if conversion was sucessful, false else.

This is a convenience function, which creates a charset converter, converts one string and destroys the charset converter. If you pass -1 for src_len, strlen() will be used.


Generated for libcdio by doxygen 1.8.7