Top | ![]() |
![]() |
![]() |
![]() |
int | idn2_lookup_u8 () |
int | idn2_register_u8 () |
int | idn2_lookup_ul () |
int | idn2_register_ul () |
const char * | idn2_strerror () |
const char * | idn2_strerror_name () |
const char * | idn2_check_version () |
void | idn2_free () |
#define | IDN2_VERSION |
#define | IDN2_VERSION_NUMBER |
#define | IDN2_LABEL_MAX_LENGTH |
#define | IDN2_DOMAIN_MAX_LENGTH |
enum | idn2_flags |
enum | idn2_rc |
int idn2_lookup_u8 (const uint8_t *src
,uint8_t **lookupname
,int flags
);
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. Pass IDN2_TRANSITIONAL
to enable Unicode TR46
transitional processing, and IDN2_NONTRANSITIONAL
to enable
Unicode TR46 non-transitional processing. Multiple flags may be
specified by binary or:ing them together, for example
IDN2_NFC_INPUT
| IDN2_NONTRANSITIONAL
.
After version 0.11: lookupname
may be NULL to test lookup of src
without allocating memory.
src |
input zero-terminated UTF-8 string in Unicode NFC normalized form. |
|
lookupname |
newly allocated output variable with name to lookup in DNS. |
|
flags |
optional idn2_flags to modify behaviour. |
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.
int idn2_register_u8 (const uint8_t *ulabel
,const uint8_t *alabel
,uint8_t **insertname
,int flags
);
Perform IDNA2008 register string conversion on domain label ulabel
and alabel
, as described in section 4 of RFC 5891. Note that the
input ulabel
must be encoded in UTF-8 and be in Unicode NFC form.
Pass IDN2_NFC_INPUT
in flags
to convert input ulabel
to NFC form
before further processing.
It is recommended to supply both ulabel
and alabel
for better
error checking, but supplying just one of them will work. Passing
in only alabel
is better than only ulabel
. See RFC 5891 section
4 for more information.
After version 0.11: insertname
may be NULL to test conversion of src
without allocating memory.
ulabel |
input zero-terminated UTF-8 and Unicode NFC string, or NULL. |
|
alabel |
input zero-terminated ACE encoded string (xn--), or NULL. |
|
insertname |
newly allocated output variable with name to register in DNS. |
|
flags |
optional idn2_flags to modify behaviour. |
On successful conversion IDN2_OK
is returned, when the
given ulabel
and alabel
does not match each other
IDN2_UALABEL_MISMATCH
is returned, when either of the input
labels are too long IDN2_TOO_BIG_LABEL
is returned, when alabel
does does not appear to be a proper A-label IDN2_INVALID_ALABEL
is returned, or another error code is returned.
int idn2_lookup_ul (const char *src
,char **lookupname
,int flags
);
Perform IDNA2008 lookup string conversion on domain name src
, as
described in section 5 of RFC 5891. Note that the input is assumed
to be encoded in the locale's default coding system, and will be
transcoded to UTF-8 and NFC normalized by this function.
Pass IDN2_ALABEL_ROUNDTRIP
in flags
to convert any input A-labels
to U-labels and perform additional testing. Pass
IDN2_TRANSITIONAL
to enable Unicode TR46 transitional processing,
and IDN2_NONTRANSITIONAL
to enable Unicode TR46 non-transitional
processing. Multiple flags may be specified by binary or:ing them
together, for example IDN2_ALABEL_ROUNDTRIP
|
IDN2_NONTRANSITIONAL
. The IDN2_NFC_INPUT
in flags
is always
enabled in this function.
After version 0.11: lookupname
may be NULL to test lookup of src
without allocating memory.
src |
input zero-terminated locale encoded string. |
|
lookupname |
newly allocated output variable with name to lookup in DNS. |
|
flags |
optional idn2_flags to modify behaviour. |
On successful conversion IDN2_OK
is returned, if
conversion from locale to UTF-8 fails then IDN2_ICONV_FAIL
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.
int idn2_register_ul (const char *ulabel
,const char *alabel
,char **insertname
,int flags
);
Perform IDNA2008 register string conversion on domain label ulabel
and alabel
, as described in section 4 of RFC 5891. Note that the
input ulabel
is assumed to be encoded in the locale's default
coding system, and will be transcoded to UTF-8 and NFC normalized
by this function.
It is recommended to supply both ulabel
and alabel
for better
error checking, but supplying just one of them will work. Passing
in only alabel
is better than only ulabel
. See RFC 5891 section
4 for more information.
After version 0.11: insertname
may be NULL to test conversion of src
without allocating memory.
ulabel |
input zero-terminated locale encoded string, or NULL. |
|
alabel |
input zero-terminated ACE encoded string (xn--), or NULL. |
|
insertname |
newly allocated output variable with name to register in DNS. |
|
flags |
optional idn2_flags to modify behaviour. |
On successful conversion IDN2_OK
is returned, when the
given ulabel
and alabel
does not match each other
IDN2_UALABEL_MISMATCH
is returned, when either of the input
labels are too long IDN2_TOO_BIG_LABEL
is returned, when alabel
does does not appear to be a proper A-label IDN2_INVALID_ALABEL
is returned, or another error code is returned.
const char *
idn2_strerror (int rc
);
Convert internal libidn2 error code to a humanly readable string. The returned pointer must not be de-allocated by the caller.
const char *
idn2_strerror_name (int rc
);
Convert internal libidn2 error code to a string corresponding to internal header file symbols. For example, idn2_strerror_name(IDN2_MALLOC) will return the string "IDN2_MALLOC".
The caller must not attempt to de-allocate the returned string.
const char *
idn2_check_version (const char *req_version
);
Check IDN2 library version. This function can also be used to read
out the version of the library code used. See IDN2_VERSION
for a
suitable req_version
string, it corresponds to the idn2.h header
file version. Normally these two version numbers match, but if you
are using an application built against an older libidn2 with a
newer libidn2 shared library they will be different.
#define IDN2_VERSION "0.16"
Pre-processor symbol with a string that describe the header file
version number. Used together with idn2_check_version()
to verify
header file and run-time library consistency.
#define IDN2_VERSION_NUMBER 0x00160000
Pre-processor symbol with a hexadecimal value describing the header file version number. For example, when the header version is 1.2.4711 this symbol will have the value 0x01021267. The last four digits are used to enumerate development snapshots, but for all public releases they will be 0000.
#define IDN2_LABEL_MAX_LENGTH 63
Constant specifying the maximum length of a DNS label to 63 characters, as specified in RFC 1034.
#define IDN2_DOMAIN_MAX_LENGTH 255
Constant specifying the maximum size of the wire encoding of a DNS domain to 255 characters, as specified in RFC 1034. Note that the usual printed representation of a domain name is limited to 253 characters if it does not end with a period, or 254 characters if it ends with a period.
Flags to IDNA2008 functions, to be binary or:ed together. Specify only 0 if you want the default behaviour.
Return codes for IDN2 functions. All return codes are negative except for the successful code IDN2_OK which are guaranteed to be
Positive values are reserved for non-error return codes.
Note that the idn2_rc enumeration may be extended at a later date to include new return codes.
Successful return. |
||
Memory allocation error. |
||
Could not determine locale string encoding format. |
||
Could not transcode locale string to UTF-8. |
||
Unicode data encoding error. |
||
Error normalizing string. |
||
Punycode invalid input. |
||
Punycode output buffer too small. |
||
Punycode conversion would overflow. |
||
Domain name longer than 255 characters. |
||
Domain label longer than 63 characters. |
||
Input A-label is not valid. |
||
Input A-label and U-label does not match. |
||
Invalid combination of flags. |
||
String is not NFC. |
||
String has forbidden two hyphens. |
||
String has forbidden starting/ending hyphen. |
||
String has forbidden leading combining character. |
||
String has disallowed character. |
||
String has forbidden context-j character. |
||
String has context-j character with no rull. |
||
String has forbidden context-o character. |
||
String has context-o character with no rull. |
||
String has forbidden unassigned character. |
||
String has forbidden bi-directional properties. |
||
Label has forbidden dot (TR46). |
||
Label has character forbidden in transitional mode (TR46). |
||
Label has character forbidden in non-transitional mode (TR46). |