NAME¶
idn2_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 normalized 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
further 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.