SYNOPSIS
       #include <stringprep.h>

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

ARGUMENTS
       const uint32_t * str
                   a UCS-4 encoded string

       ssize_t len the maximum length of str to use. If  len  <  0,  then  the
                   string is terminated with a 0 character.

       size_t * items_read
                   location to store number of characters read read, or NULL.

       size_t * items_written
                   location  to  store  number  of bytes written or NULL.  The
                   value here stored does not include the trailing 0 byte.

DESCRIPTION
       Convert a string from a 32-bit fixed width representation as UCS-4.  to
       UTF-8. The result will be terminated with a 0 byte.

RETURN VALUE
       a  pointer to a newly allocated UTF-8 string.  This value must be deal-
       located by the caller.  If an error occurs, NULL will be  returned  and
       error set.

REPORTING BUGS
       Report   bugs   to   <bug-libidn@gnu.org>.    GNU   Libidn  home  page:
       http://www.gnu.org/software/libidn/ General help  using  GNU  software:
       http://www.gnu.org/gethelp/

COPYRIGHT
       Copyright  (C)  2002,  2003,  2004,  2005, 2006, 2007, 2008, 2009 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.

SEE ALSO
       The full documentation for libidn is maintained as  a  Texinfo  manual.
       If  the  info  and libidn programs are properly installed at your site,
       the command

              info libidn

       should give you access to the complete manual.