stringprep_utf8_to_ucs4(3) API function

SYNOPSIS

#include <stringprep.h>

uint32_t * stringprep_utf8_to_ucs4(const char * str, ssize_t len, size_t * items_written);

ARGUMENTS

const char * str
a UTF-8 encoded string
ssize_t len
the maximum length of str to use. If len < 0, then the string is nul-terminated.
size_t * items_written
location to store the number of characters in the result, or NULL.

DESCRIPTION

Convert a string from UTF-8 to a 32-bit fixed width representation as UCS-4. The function now performs error checking to verify that the input is valid UTF-8 (before it was documented to not do error checking).

Return value: a pointer to a newly allocated UCS-4 string. This value must be deallocated by the caller.

REPORTING BUGS

Report bugs to <[email protected]>.
General guidelines for reporting bugs: http://www.gnu.org/gethelp/
GNU Libidn home page: http://www.gnu.org/software/libidn/

COPYRIGHT

Copyright © 2002-2015 Simon Josefsson.
Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.