libidn                                              stringprep(3)



NAME
     stringprep - prepare internationalized string

SYNOPSIS
     #include 

     int     stringprep(char     *     in,     sizet     maxlen,
     Stringprepprofileflags flags

ARGUMENTS
     char * in   input/ouput array with string to prepare.

     sizet maxlen
                 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 zero terminated UTF-8 string according  to
     the  stringprep  profile,  and  write back the result to the
     input string.

     Note that you must convert strings entered  in  the  systems
     locale   into   UTF-8   before   using  this  function,  see
     stringpreplocaletoutf8().

     Since the stringprep operation can expand the string, maxlen
     indicate  how  large the buffer holding the string is.  This
     function will not read or write to characters  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 error code.

REPORTING BUGS
     Report bugs to .

COPYRIGHT
     Copyright O 2002, 2003, 2004, 2005, 2006, 2007,  2008  Simon
     Josefsson.



libidn                  Last change: 1.9                        1






libidn                                              stringprep(3)



     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