idn2_lookup_u8(3) libidn2 idn2_lookup_u8(3)NAMEidn2_lookup_u8 - API function
SYNOPSIS
#include <idn2.h>
int idn2_lookup_u8(const uint8_t * src, uint8_t ** lookupname, int
flags);
ARGUMENTS
const uint8_t * src
input zero-terminated UTF-8 string in Unicode NFC normal‐
ized form.
uint8_t ** lookupname
newly allocated output variable with name to lookup in DNS.
int flags optional idn2_flags to modify behaviour.
DESCRIPTION
Perform IDNA2008 lookup string conversion on domain name src, as
described in section 5 of RFC 5891. Note that the input string must be
encoded in UTF-8 and be in Unicode NFC form.
Pass IDN2_NFC_INPUT in flags to convert input to NFC form before fur‐
ther processing. Pass IDN2_ALABEL_ROUNDTRIP in flags to convert any
input A-labels to U-labels and perform additional testing. Multiple
flags may be specified by binary or:ing them together, for example
IDN2_NFC_INPUT | IDN2_ALABEL_ROUNDTRIP.
RETURNS
On successful conversion IDN2_OK is returned, if the output domain or
any label would have been too long IDN2_TOO_BIG_DOMAIN or
IDN2_TOO_BIG_LABEL is returned, or another error code is returned.
SEE ALSO
The full documentation for libidn2 is maintained as a Texinfo manual.
If the info and libidn2 programs are properly installed at your site,
the command
info libidn2
should give you access to the complete manual.
libidn2 0.8 idn2_lookup_u8(3)