utf.h File Reference

UTF helpers. More...

#include <stddef.h>
#include <sys/types.h>
#include <uchar.h>
#include <nds/ndstypes.h>

Functions
ssize_t	utf16_to_utf8 (char *out, size_t out_size, char16_t *in, size_t in_size)
	It converts a UTF-16LE string to UTF-8.

Detailed Description

UTF helpers.

Helpers used to handle different UTF formats.

Function Documentation

utf16_to_utf8()

ssize_t utf16_to_utf8	(	char *	out,
		size_t	out_size,
		char16_t *	in,
		size_t	in_size
	)

It converts a UTF-16LE string to UTF-8.

This can be used for the firmware user setting strings, like the user name and the personal message.

Parameters

out	Destination buffer for the resulting string encoded as UTF-8.
out_size	Size of the destination buffer in bytes.
in	Source buffer of the UTF-16LE encoded string.
in_size	Size of the source buffer in bytes.

Returns

It returns the number of saved bytes in the destination buffer on success or a negative number on error. On error, the contents of the output buffer shouldn't be used.