Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

idn2_to_ascii_lz (3)

Name

idn2_to_ascii_lz - API function

Synopsis

#include <idn2.h>

int idn2_to_ascii_lz(const char * input, char ** output, int flags);

Description

idn2_to_ascii_lz(3)                 libidn2                idn2_to_ascii_lz(3)



NAME
       idn2_to_ascii_lz - API function

SYNOPSIS
       #include <idn2.h>

       int idn2_to_ascii_lz(const char * input, char ** output, int flags);

ARGUMENTS
       const char * input
                   zero terminated input UTF-8 string.

       char ** output
                   pointer to newly allocated output string.

       int flags   optional idn2_flags to modify behaviour.

DESCRIPTION
       Convert  a  domain  name in locale's encoding 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.

       When unsure, it is recommended to call this function with the IDN2_NON-
       TRANSITIONAL and IDN2_NFC_INPUT flags.

RETURNS
       IDN2_OK  on  success,  or   error   code.    Same   as   described   in
       idn2_lookup_ul() documentation.

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/libidn2/manual/

NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source        was         downloaded         from          https://git-
       lab.com/libidn/libidn2/uploads/15020b7769a7c69cebd38654ddf0648a/libidn2-2.0.4.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.0.4                 idn2_to_ascii_lz(3)