idn2_to_ascii_4z - man pages section 3: Library Interfaces and Headers

Language:

idn2_to_ascii_4z (3)

Name

idn2_to_ascii_4z - API function

Synopsis

#include <idn2.h>

int  idn2_to_ascii_4z(const  uint32_t  *  input,  char  **  output, int
flags);

Description

idn2_to_ascii_4z(3)                 libidn2                idn2_to_ascii_4z(3)



NAME
       idn2_to_ascii_4z - API function

SYNOPSIS
       #include <idn2.h>

       int  idn2_to_ascii_4z(const  uint32_t  *  input,  char  **  output, int
       flags);

ARGUMENTS
       const uint32_t * input
                   zero terminated input Unicode (UCS-4) string.

       char ** output
                   pointer to newly allocated zero-terminated output string.

       int flags   optional idn2_flags to modify behaviour.

DESCRIPTION
       Convert UCS-4 domain name to ASCII string  using  the  IDNA2008  rules.
       The  domain  name  may  contain several labels, separated by dots.  The
       output buffer must be deallocated by the caller.

       The default behavior of this function (when flags are zero) is to apply
       the IDNA2008 rules without the TR46 amendments. As the TR46 non-transi-
       tional processing is nowadays ubiquitous, when  unsure,  it  is  recom-
       mended  to  call  this  function  with the IDN2_NONTRANSITIONAL and the
       IDN2_NFC_INPUT flags for compatibility with other software.

       Return value: Returns IDN2_OK on success, or error code.

SINCE
       2.0.0


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/libidn2  |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

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.  As an  alternative  you
       may obtain the manual from:

              http://www.gnu.org/software/libidn/libidn2/manual/

NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source                was                downloaded                from
       https://ftp.gnu.org/gnu/libidn/libidn2-2.3.0.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.gnu.org/software/libidn/.



libidn2                              2.2.0                 idn2_to_ascii_4z(3)