libidn                                           stringprep4i(3)



NAME
     stringprep4i - prepare internationalized string

SYNOPSIS
     #include 

     int stringprep4i(uint32t *  ucs4,  sizet  *  len,  sizet
     maxucs4len

ARGUMENTS
     uint32t * ucs4
                 input/output array with string to prepare.

     sizet * len
                 on input, length of  input  array  with  Unicode
                 code  points,  on  exit,  length of output array
                 with Unicode code points.

     sizet maxucs4len
                 maximum length of input/output array.

     Stringprepprofileflags flags
                 a Stringprepprofileflags value, or 0.

     const Stringprepprofile * profile
                 pointer to Stringprepprofile to use.

DESCRIPTION
     Prepare the input UCS-4 string according to  the  stringprep
     profile, and write back the result to the input string.

     The input is not required to be zero terminated (ucs4[len] =
     0).  The output will not be zero terminated unless ucs4[len]
     = 0.  Instead, see stringprep4zi() if your  input  is  zero
     terminated or if you want the output to be.

     Since  the  stringprep  operation  can  expand  the  string,
     maxucs4len  indicate how large the buffer holding the string
     is.  This function will not read or  write  to  code  points
     outside that size.

     The flags are one of Stringprepprofileflags values, or 0.

     The profile contain the Stringprepprofile  instructions  to
     perform.  Your application can define new profiles, possibly
     re-using the generic stringprep tables that always  will  be
     part  of  the library, or use one of the currently supported
     profiles.

RETURN VALUE
     Returns STRINGPREPOK iff successful,  or  an  Stringpreprc
     error code.



libidn                  Last change: 1.9                        1






libidn                                           stringprep4i(3)



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:

     
       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