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.

Functions
cdio_charset_coverter_t *	cdio_charset_converter_create (const char *src_charset, const char *dst_charset)
	Create a charset converter.
void	cdio_charset_converter_destroy (cdio_charset_coverter_t *cnv)
	Destroy a characterset converter.
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.
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.
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.

Detailed Description

UTF-8 support.

Typedef Documentation

cdio_charset_coverter_t

typedef struct cdio_charset_coverter_s cdio_charset_coverter_t

Opaque characterset converter.

Function Documentation

cdio_charset_convert()

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

cnv	A charset converter
src	Source string
src_len	Length of source string
dst	Returns destination string
dst_len	If non NULL, returns the length of the destination string

Returns

true if conversion was successful, false else.

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

cdio_charset_converter_create()

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

Create a charset converter.

Parameters

src_charset	Source charset
dst_charset	Destination charset

Returns

A newly allocated charset converter

cdio_charset_converter_destroy()

void cdio_charset_converter_destroy

(

cdio_charset_coverter_t *

cnv

)

Destroy a characterset converter.

Parameters

cnv	A characterset converter

cdio_charset_from_utf8()

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

src	Source string (0 terminated)
dst	Returns destination string
dst_len	If non NULL, returns the length of the destination string
dst_charset	The characterset to convert to

Returns

true if conversion was successful, false else.

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

The destination string must be freed by the caller with cdio_free().

cdio_charset_to_utf8()

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

src	Source string
src_len	Length of the source string
dst	Returns destination string (0 terminated)
src_charset	The characterset to convert from 1 *

Returns

true if conversion was successful, false else.

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

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