libidn                                 stringprepucs4toutf8(3)



NAME
     stringprepucs4toutf8 - convert UCS-4 string to UTF-8

SYNOPSIS
     #include 

     char * stringprepucs4toutf8(const uint32t * str, ssizet
     len, sizet * itemsread

ARGUMENTS
     const uint32t * str
                 a UCS-4 encoded string

     ssizet len the maximum length of str to use. If  len  <  0,
                 then  the  string is terminated with a 0 charac-
                 ter.

     sizet * itemsread
                 location to  store  number  of  characters  read
                 read, or NUL.

     sizet * itemswritten
                 location to store number  of  bytes  written  or
                 NUL.   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 freed with free(). If an error occurs, NUL will be
     returned and error set.

REPORTING BUGS
     Report bugs to .

COPYRIGHT
     Copyright O 2002, 2003, 2004, 2005, 2006, 2007,  2008  Simon
     Josefsson.
     Permission is granted to make and distribute verbatim copies
     of  this  manual provided the copyright notice and this per-
     mission notice are preserved on all copies.

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



libidn                  Last change: 1.9                        1






libidn                                 stringprepucs4toutf8(3)



     should give you access to the complete manual.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWlibidn     
    
     Interface Stability  Uncommitted    
    

NOTES
     Source for LibIDN is available on http:/opensolaris.org.







































libidn                  Last change: 1.9                        2