stringprep_profile (3) - Linux Manuals

stringprep_profile: API function

NAME

stringprep_profile - API function

SYNOPSIS

#include <stringprep.h>

int stringprep_profile(const char * in, char ** out, const char * profile, 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

a Stringprep_profile_flags value, or 0.

DESCRIPTION

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

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 values, 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 [at] gnu.org>. GNU Libidn home page: http://www.gnu.org/software/libidn/ General help using GNU software: http://www.gnu.org/gethelp/

COPYRIGHT

Copyright © 2002-2013 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.