utf8.h File Reference

#include <cdio/types.h>

Go to the source code of this file.

Typedefs
typedef 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 (char *src, size_t src_len, cdio_utf8_t **dst, const char *src_charset)
	Convert a string from another charset to UTF-8.

---

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:

	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 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_charset	Source charset
	dst_charset	Destination charset

Returns:

A newly allocated charset converter

void cdio_charset_converter_destroy

(

cdio_charset_coverter_t *

cnv

)

Destroy a characterset converter.

Parameters:

cnv

A 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:

	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 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	(	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

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.

---