php man page for idn_to_utf8

IDN_TO_UTF8(3)								 1							    IDN_TO_UTF8(3)

idn_to_utf8 - Convert domain name from IDNA ASCII to Unicode.

       Procedural style

SYNOPSIS
       string idn_to_utf8 (string  $domain, [int  $options], [int  $variant = INTL_IDNA_VARIANT_2003], [array  &$idna_info])

DESCRIPTION
	This function converts Unicode domain name from IDNA ASCII-compatible format to plain Unicode, encoded in UTF-8.

PARAMETERS
	      o $domain
		- Domain to convert in IDNA ASCII-compatible format.

	      o $options
		- Conversion options - combination of IDNA_* constants (except IDNA_ERROR_* constants).

	      o $variant
		- Either INTL_IDNA_VARIANT_2003 for IDNA 2003 or INTL_IDNA_VARIANT_UTS46 for UTS #46.

	      o $idna_info
		-  This parameter can be used only if INTL_IDNA_VARIANT_UTS46 was used for $variant. In that case, it will be filled with an array
		with the keys 'result', the possibly illegal result of the transformation, 'isTransitionalDifferent', a boolean indicating whether
		the usage of the transitional mechanisms of UTS #46 either has or would have changed the result and 'errors', which is an int rep-
		resenting a bitset of the error constants IDNA_ERROR_*.

RETURN VALUES
	Domain name in Unicode, encoded in UTF-8. or FALSE on failure

CHANGELOG
       +-------------------+---------------------------------------------------+
       |     Version	   |						       |
       |		   |						       |
       |		   |			Description		       |
       |		   |						       |
       +-------------------+---------------------------------------------------+
       |5.4.0/PECL 2.0.0b1 |						       |
       |		   |						       |
       |		   |  Added the parameters  $variant  and  $idna_info; |
       |		   | UTS #46 support.				       |
       |		   |						       |
       +-------------------+---------------------------------------------------+
EXAMPLES
       Example #1

	      idn_to_utf8(3) example

	      <?php

	      echo idn_to_utf8('xn--tst-qla.de');

	      ?>

       The above example will output:

       tast.de

SEE ALSO
       idn_to_unicode(3).

PHP Documentation Group 													    IDN_TO_UTF8(3)