stringprep_profile(3)

stringprep_profile3

Api function

Usage

#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.

Overview

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.

Releases

11 releases since Debian 3.1 (Sarge); the text changed 8 times.

  1. 3.1
  2. 4.0
  3. 5.0
  4. 6.0
  5. 7
  6. 9–11
  7. 12
  8. 13
  9. Arch

Reporting bugs

Report bugs to <[email protected]>.
General guidelines for reporting bugs: https://www.gnu.org/gethelp/
GNU Libidn home page: https://www.gnu.org/software/libidn/

From libidn 1.44-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.