SYNOPSIS
       #include <stringprep.h>

       char * stringprep_utf8_nfkc_normalize(const char * str, ssize_t len);

ARGUMENTS
       const char * str
                   a UTF-8 encoded string.

       ssize_t len length of str, in bytes, or -1 if str is nul-terminated.

DESCRIPTION
       Converts  a  string  into  canonical form, standardizing such issues as
       whether a character with an accent is represented as a  base  character
       and combining accent or as a single precomposed character.

       The  normalization mode is NFKC (ALL COMPOSE).  It standardizes differ-
       ences that do not affect the text content, such as the  above-mentioned
       accent  representation.  It standardizes the "compatibility" characters
       in Unicode, such as SUPERSCRIPT THREE to the standard  forms  (in  this
       case DIGIT THREE). Formatting information may be lost but for most text
       operations such characters should be considered the same. It returns  a
       result with composed forms rather than a maximally decomposed form.

RETURN VALUE
       a newly allocated string, that is the NFKC normalized form of str.

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.