stringprep_profile

stringprep_profile(3)		    libidn		stringprep_profile(3)



NAME
       stringprep_profile

SYNOPSIS
       #include <stringprep.h>

       int stringprep_profile(const char * in, char ** out, const char * pro-
       file, Stringprep_profile_flags flags);

ARGUMENTS
       const char * in
		    input array with UTF-8 string to prepare.

       char ** out  output variable with pointer to newly allocate string.

       const char * profile
		    name of stringprep profile to use.

       Stringprep_profile_flags flags
		    stringprep profile flags, or 0.

DESCRIPTION
       Prepare the input  zero	terminated  UTF-8  string  according  to  the
       stringprep  profile,  and return the result in a newly allocated vari-
       able.

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

       stringprep_locale_to_utf8()

       The output out variable must be deallocated by the caller.

       The flags are one of Stringprep_profile_flags, or 0.

       The  profile  specifies the name of the stringprep profile to use.  It
       must be one of the internally supported stringprep profiles.

RETURN VALUE
	Returns STRINGPREP_OK
	iff successful, or an error code.

REPORTING BUGS
       Report bugs to <bug-libidn@gnu.org>.

COPYRIGHT
       Copyright © 2002, 2003, 2004 Simon Josefsson.
       Permission is granted to make and distribute verbatim copies  of	 this
       manual  provided	 the  copyright notice and this permission 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.



libidn				    0.5.6		stringprep_profile(3)