reference/intl/idn/idn-to-utf8.xml
d6aee4a5004f7d532f24c06ea2ab2ac0b91b8664
d6aee4a5004f7d532f24c06ea2ab2ac0b91b8664
...
...
@@ -3,20 +3,20 @@
3
3
<refentry xml:id="function.idn-to-utf8" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
4
4
<refnamediv>
5
5
<refname>idn_to_utf8</refname>
6
-
<refpurpose>Convert domain name from IDNA ASCII to Unicode.</refpurpose>
6
+
<refpurpose>Convert domain name from IDNA ASCII to Unicode</refpurpose>
7
7
</refnamediv>
8
8
<refsect1 role="description">
9
9
&reftitle.description;
10
10
<para>&style.procedural;</para>
11
11
<methodsynopsis>
12
-
<type>string</type><methodname>idn_to_utf8</methodname>
12
+
<type class="union"><type>string</type><type>false</type></type><methodname>idn_to_utf8</methodname>
13
13
<methodparam><type>string</type><parameter>domain</parameter></methodparam>
14
-
<methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
15
-
<methodparam choice="opt"><type>int</type><parameter>variant</parameter><initializer>INTL_IDNA_VARIANT_2003</initializer></methodparam>
16
-
<methodparam choice="opt"><type>array</type><parameter role="reference">idna_info</parameter></methodparam>
14
+
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>IDNA_DEFAULT</constant></initializer></methodparam>
15
+
<methodparam choice="opt"><type>int</type><parameter>variant</parameter><initializer><constant>INTL_IDNA_VARIANT_UTS46</constant></initializer></methodparam>
16
+
<methodparam choice="opt"><type>array</type><parameter role="reference">idna_info</parameter><initializer>&null;</initializer></methodparam>
17
17
</methodsynopsis>
18
18
<para>
19
-
This function converts Unicode domain name from IDNA ASCII-compatible format to plain Unicode, encoded in UTF-8.
19
+
This function converts a Unicode domain name from an IDNA ASCII-compatible format to plain Unicode, encoded in UTF-8.
20
20
</para>
21
21
</refsect1>
22
22
...
...
@@ -28,12 +28,12 @@
28
28
<term><parameter>domain</parameter></term>
29
29
<listitem>
30
30
<para>
31
-
Domain to convert in IDNA ASCII-compatible format.
31
+
Domain to convert in an IDNA ASCII-compatible format.
32
32
</para>
33
33
</listitem>
34
34
</varlistentry>
35
35
<varlistentry>
36
-
<term><parameter>options</parameter></term>
36
+
<term><parameter>flags</parameter></term>
37
37
<listitem>
38
38
<para>
39
39
Conversion options - combination of IDNA_* constants
...
...
@@ -45,8 +45,8 @@
45
45
<term><parameter>variant</parameter></term>
46
46
<listitem>
47
47
<para>
48
-
Either <constant>INTL_IDNA_VARIANT_2003</constant> for IDNA 2003 or
49
-
<constant>INTL_IDNA_VARIANT_UTS46</constant> for UTS #46.
48
+
Either <constant>INTL_IDNA_VARIANT_2003</constant> (deprecated as of PHP 7.2.0) for IDNA 2003 or
49
+
<constant>INTL_IDNA_VARIANT_UTS46</constant> (only available as of ICU 4.6) for UTS #46.
50
50
</para>
51
51
</listitem>
52
52
</varlistentry>
...
...
@@ -74,7 +74,7 @@
74
74
<refsect1 role="returnvalues">
75
75
&reftitle.returnvalues;
76
76
<para>
77
-
Domain name in Unicode, encoded in UTF-8. &return.falseforfailure;
77
+
The domain name in Unicode, encoded in UTF-8, &return.falseforfailure;
78
78
</para>
79
79
</refsect1>
80
80
...
...
@@ -91,10 +91,18 @@
91
91
</thead>
92
92
<tbody>
93
93
<row>
94
-
<entry>5.4.0/PECL 2.0.0b1</entry>
94
+
<entry>7.4.0</entry>
95
95
<entry>
96
-
Added the parameters <parameter>variant</parameter> and
97
-
<parameter>idna_info</parameter>; UTS #46 support.
96
+
The default value of <parameter>variant</parameter> is now
97
+
<constant>INTL_IDNA_VARIANT_UTS46</constant> instead of the deprecated
98
+
<constant>INTL_IDNA_VARIANT_2003</constant>.
99
+
</entry>
100
+
</row>
101
+
<row>
102
+
<entry>7.2.0</entry>
103
+
<entry>
104
+
<constant>INTL_IDNA_VARIANT_2003</constant> has been deprecated; use
105
+
<constant>INTL_IDNA_VARIANT_UTS46</constant> instead.
98
106
</entry>
99
107
</row>
100
108
</tbody>
...
...
@@ -129,12 +137,11 @@ täst.de
129
137
&reftitle.seealso;
130
138
<para>
131
139
<simplelist>
132
-
<member><function>idn_to_unicode</function></member>
140
+
<member><function>idn_to_ascii</function></member>
133
141
</simplelist>
134
142
</para>
135
143
</refsect1>
136
144
</refentry>
137
-
138
145
<!-- Keep this comment at the end of the file
139
146
Local variables:
140
147
mode: sgml
141
148