1idn2_lookup_ul(3)                   libidn2                  idn2_lookup_ul(3)
2
3
4

NAME

6       idn2_lookup_ul - API function
7

SYNOPSIS

9       #include <idn2.h>
10
11       int idn2_lookup_ul(const char * src, char ** lookupname, int flags);
12

ARGUMENTS

14       const char * src
15                   input zero-terminated locale encoded string.
16
17       char ** lookupname
18                   newly allocated output variable with name to lookup in DNS.
19
20       int flags   optional idn2_flags to modify behaviour.
21

DESCRIPTION

23       Perform  IDNA2008  lookup  string  conversion  on  domain  name src, as
24       described in section 5 of RFC 5891.  Note that the input is assumed  to
25       be  encoded  in  the  locale's  default  coding  system,  and  will  be
26       transcoded to UTF-8 and NFC normalized by this function.
27
28       Pass IDN2_ALABEL_ROUNDTRIP in flags to convert any  input  A-labels  to
29       U-labels and perform additional testing.
30

RETURNS

32       On successful conversion IDN2_OK is returned, if conversion from locale
33       to UTF-8 fails then IDN2_ICONV_FAIL is returned, if the  output  domain
34       or   any   label  would  have  been  too  long  IDN2_TOO_BIG_DOMAIN  or
35       IDN2_TOO_BIG_LABEL is returned, or another error code is returned.
36

SEE ALSO

38       The full documentation for libidn2 is maintained as a  Texinfo  manual.
39       If  the  info and libidn2 programs are properly installed at your site,
40       the command
41
42              info libidn2
43
44       should give you access to the complete manual.
45
46
47
48libidn2                               0.7                    idn2_lookup_ul(3)