idna_strerror(3) libidn idna_strerror(3)NAME
idna_strerror - API function
SYNOPSIS
#include <idna.h>
const char * idna_strerror(Idna_rc rc);
ARGUMENTS
Idna_rc rc an Idna_rc return code.
DESCRIPTION
Convert a return code integer to a text string. This string can be used to output a diagnostic message to the user.
IDNA_SUCCESS
Successful operation. This value is guaranteed to always be zero, the remaining ones are only guaranteed to hold non-zero values, for log-
ical comparison purposes.
IDNA_STRINGPREP_ERROR
Error during string preparation.
IDNA_PUNYCODE_ERROR
Error during punycode operation.
IDNA_CONTAINS_NON_LDH
For IDNA_USE_STD3_ASCII_RULES, indicate that the string contains non-LDH ASCII characters.
IDNA_CONTAINS_MINUS
For IDNA_USE_STD3_ASCII_RULES, indicate that the string contains a leading or trailing hyphen-minus (U+002D).
IDNA_INVALID_LENGTH
The final output string is not within the (inclusive) range 1 to 63 characters.
IDNA_NO_ACE_PREFIX
The string does not contain the ACE prefix (for ToUnicode).
IDNA_ROUNDTRIP_VERIFY_ERROR
The ToASCII operation on output string does not equal the input.
IDNA_CONTAINS_ACE_PREFIX
The input contains the ACE prefix (for ToASCII).
IDNA_ICONV_ERROR
Could not convert string in locale encoding.
IDNA_MALLOC_ERROR
Could not allocate buffer (this is typically a fatal error).
IDNA_DLOPEN_ERROR
Could not dlopen the libcidn DSO (only used internally in libc).
RETURN VALUE
Returns a pointer to a statically allocated string containing a description of the error with the return code rc.
REPORTING BUGS
Report bugs to <bug-libidn@gnu.org>. GNU Libidn home page: http://www.gnu.org/software/libidn/ General help using GNU software:
http://www.gnu.org/gethelp/
COPYRIGHT
Copyright (C) 2002-2012 Simon Josefsson.
Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
SEE ALSO
The full documentation for libidn is maintained as a Texinfo manual. If the info and libidn programs are properly installed at your site,
the command
info libidn
should give you access to the complete manual.
libidn 1.25 idna_strerror(3)
Check Out this Related Man Page
idna_to_unicode_44i(3) libidn idna_to_unicode_44i(3)NAME
idna_to_unicode_44i - API function
SYNOPSIS
#include <idna.h>
int idna_to_unicode_44i(const uint32_t * in, size_t inlen, uint32_t * out, size_t * outlen, int flags);
ARGUMENTS
const uint32_t * in
input array with unicode code points.
size_t inlen
length of input array with unicode code points.
uint32_t * out
output array with unicode code points.
size_t * outlen
on input, maximum size of output array with unicode code points, on exit, actual size of output array with unicode code points.
int flags an Idna_flags value, e.g., IDNA_ALLOW_UNASSIGNED or IDNA_USE_STD3_ASCII_RULES.
DESCRIPTION
The ToUnicode operation takes a sequence of Unicode code points that make up one domain label and returns a sequence of Unicode code
points. If the input sequence is a label in ACE form, then the result is an equivalent internationalized label that is not in ACE form,
otherwise the original sequence is returned unaltered.
ToUnicode never fails. If any step fails, then the original input sequence is returned immediately in that step.
The Punycode decoder can never output more code points than it inputs, but Nameprep can, and therefore ToUnicode can. Note that the number
of octets needed to represent a sequence of code points depends on the particular character encoding used.
The inputs to ToUnicode are a sequence of code points, the AllowUnassigned flag, and the UseSTD3ASCIIRules flag. The output of ToUnicode is
always a sequence of Unicode code points.
RETURN VALUE
Returns Idna_rc error condition, but it must only be used for debugging purposes. The output buffer is always guaranteed to contain the
correct data according to the specification (sans malloc induced errors). NB! This means that you normally ignore the return code from
this function, as checking it means breaking the standard.
REPORTING BUGS
Report bugs to <bug-libidn@gnu.org>. GNU Libidn home page: http://www.gnu.org/software/libidn/ General help using GNU software:
http://www.gnu.org/gethelp/
COPYRIGHT
Copyright (C) 2002-2012 Simon Josefsson.
Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
SEE ALSO
The full documentation for libidn is maintained as a Texinfo manual. If the info and libidn programs are properly installed at your site,
the command
info libidn
should give you access to the complete manual.
libidn 1.25 idna_to_unicode_44i(3)