idna_to_unicode_44i(3) libidn idna_to_unicode_44i(3) NNAAMMEE idna_to_unicode_44i - API function SSYYNNOOPPSSIISS ##iinncclluuddee <> iinntt iiddnnaa__ttoo__uunniiccooddee__4444ii((ccoonnsstt uuiinntt3322__tt ** _i_n,, ssiizzee__tt _i_n_l_e_n,, uuiinntt3322__tt ** _o_u_t,, ssiizzee__tt ** _o_u_t_l_e_n,, iinntt _f_l_a_g_s));; AARRGGUUMMEENNTTSS 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 IIddnnaa__ffllaaggss value, e.g., IIDDNNAA__AALLLLOOWW__UUNNAASSSSIIGGNNEEDD or IIDDNNAA__UUSSEE__SSTTDD33__AASSCCIIII__RRUULLEESS. DDEESSCCRRIIPPTTIIOONN 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 AllowUnas- signed flag, and the UseSTD3ASCIIRules flag. The output of ToUnicode is always a sequence of Unicode code points. Return value: Returns IIddnnaa__rrcc error condition, but it must only be used for debugging purposes. The output buffer is always guaranteed to con- tain 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. RREEPPOORRTTIINNGG BBUUGGSS Report bugs to . General guidelines for reporting bugs: http://www.gnu.org/gethelp/ GNU Libidn home page: http://www.gnu.org/software/libidn/ CCOOPPYYRRIIGGHHTT Copyright (C) 2002-2021 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. SSEEEE AALLSSOO The full documentation for lliibbiiddnn is maintained as a Texinfo manual. If the iinnffoo and lliibbiiddnn programs are properly installed at your site, the command iinnffoo lliibbiiddnn should give you access to the complete manual. As an alternative you may obtain the manual from: hhttttpp::////wwwwww..ggnnuu..oorrgg//ssooffttwwaarree//lliibbiiddnn//mmaannuuaall// libidn 1.38 idna_to_unicode_44i(3)