UTF

UTF encoding functions. More...

Collaboration diagram for UTF:

Functions
size_t	gf_utf8_wcstombs (char *dst, size_t dst_len, const unsigned short **srcp)
	wide-char to multibyte conversion More...
size_t	gf_utf8_mbstowcs (unsigned short *dst, size_t dst_len, const char **srcp)
	multibyte to wide-char conversion More...
size_t	gf_utf8_wcslen (const unsigned short *s)
	wide-char string length More...
Bool	gf_utf8_reorder_bidi (u16 *utf_string, u32 len)
	string bidi reordering More...

Detailed Description

This section documents the UTF functions of the GPAC framework.
The wide characters in GPAC are unsignad shorts, in other words GPAC only supports UTF8 and UTF16 coding styles.

Note

these functions are just ports of libutf8 library tools into GPAC.

Function Documentation

size_t gf_utf8_wcstombs	(	char *	dst,
		size_t	dst_len,
		const unsigned short **	srcp
	)

Converts a wide-char string to a multibyte string

Parameters

dst	multibyte destination buffer
dst_len	multibyte destination buffer size
srcp	address of the wide-char string. This will be set to the next char to be converted in the input buffer if not enough space in the destination, or NULL if conversion was completed.

Returns

length (in byte) of the multibyte string or -1 if error.

Here is the call graph for this function:

Here is the caller graph for this function:

size_t gf_utf8_mbstowcs	(	unsigned short *	dst,
		size_t	dst_len,
		const char **	srcp
	)

Converts a multibyte string to a wide-char string

Parameters

dst	wide-char destination buffer
dst_len	wide-char destination buffer size
srcp	address of the multibyte character buffer. This will be set to the next char to be converted in the input buffer if not enough space in the destination, or NULL if conversion was completed.

Returns

length (in unsigned short) of the wide-char string or -1 if error.

Here is the call graph for this function:

Here is the caller graph for this function:

size_t gf_utf8_wcslen

(

const unsigned short *

s

)

Returns the length in character of a wide-char string

Parameters

s	the wide-char string

Returns

the wide-char string length

Here is the caller graph for this function:

Bool gf_utf8_reorder_bidi	(	u16 *	utf_string,
		u32	len
	)

Performs a simple reordering of words in the string based on each word direction, so that glyphs are sorted in display order.

Parameters

utf_string	the wide-char string
len	the len of the wide-char string

Returns

1 if the main direction is right-to-left, 0 otherwise

Here is the call graph for this function:

Here is the caller graph for this function: