libidn                                 stringpreputf8toucs4(3)



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

SYNOPSIS
     #include 

     uint32t * stringpreputf8toucs4(const char * str, ssizet
     len, sizet * itemswritten

ARGUMENTS
     const char * str
                 a UTF-8 encoded string

     ssizet len the maximum length of str to use. If  len  <  0,
                 then the string is nul-terminated.

     sizet * itemswritten
                 location to store the number  of  characters  in
                 the result, or NUL.

DESCRIPTION
     Convert  a  string  from  UTF-8  to  a  32-bit  fixed  width
     representation  as  UCS-4, assuming valid UTF-8 input.  This
     function does no error checking on the input.

RETURN VALUE
     a pointer to a newly allocated  UCS-4  string.   This  value
     must be freed with free().

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

     should give you access to the complete manual.

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




libidn                  Last change: 1.9                        1






libidn                                 stringpreputf8toucs4(3)



     
       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