reference/xml/functions/xml-parser-create-ns.xml
f9c4a68ef4f89e51e6d9b905ad3ddb6492386dd3
f9c4a68ef4f89e51e6d9b905ad3ddb6492386dd3
...
...
@@ -1,6 +1,6 @@
1
1
<?xml version="1.0" encoding="utf-8"?>
2
2
<!-- $Revision$ -->
3
-
<refentry xmlns="http://docbook.org/ns/docbook" xml:id='function.xml-parser-create-ns'>
3
+
<refentry xml:id="function.xml-parser-create-ns" xmlns="http://docbook.org/ns/docbook">
4
4
<refnamediv>
5
5
<refname>xml_parser_create_ns</refname>
6
6
<refpurpose>Create an XML parser with namespace support</refpurpose>
...
...
@@ -9,14 +9,14 @@
9
9
<refsect1 role="description">
10
10
&reftitle.description;
11
11
<methodsynopsis>
12
-
<type>resource</type><methodname>xml_parser_create_ns</methodname>
13
-
<methodparam choice="opt"><type>string</type><parameter>encoding</parameter></methodparam>
12
+
<type>XMLParser</type><methodname>xml_parser_create_ns</methodname>
13
+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
14
14
<methodparam choice="opt"><type>string</type><parameter>separator</parameter><initializer>":"</initializer></methodparam>
15
15
</methodsynopsis>
16
16
<para>
17
17
<function>xml_parser_create_ns</function> creates a new XML parser
18
-
with XML namespace support and returns a resource handle referencing
19
-
it to be used by the other XML functions.
18
+
with XML namespace support and returns a <classname>XMLParser</classname>
19
+
instance to be used by the other XML functions.
20
20
</para>
21
21
</refsect1>
22
22
...
...
@@ -28,13 +28,9 @@
28
28
<term><parameter>encoding</parameter></term>
29
29
<listitem>
30
30
<para>
31
-
The optional <parameter>encoding</parameter> specifies the character
32
-
encoding for the input/output in PHP 4. Starting from PHP 5, the input
33
-
encoding is automatically detected, so that the
31
+
The input encoding is automatically detected, so that the
34
32
<parameter>encoding</parameter> parameter specifies only the output
35
-
encoding. In PHP 4, the default output encoding is the same as the
36
-
input charset. In PHP 5.0.0 and 5.0.1, the default output charset is
37
-
ISO-8859-1, while in PHP 5.0.2 and upper is UTF-8. The supported
33
+
encoding. The default output charset is UTF-8. The supported
38
34
encodings are <literal>ISO-8859-1</literal>, <literal>UTF-8</literal> and
39
35
<literal>US-ASCII</literal>.
40
36
</para>
...
...
@@ -57,10 +53,39 @@
57
53
<refsect1 role="returnvalues">
58
54
&reftitle.returnvalues;
59
55
<para>
60
-
Returns a resource handle for the new XML parser.
56
+
Returns a new <classname>XMLParser</classname> instance.
61
57
</para>
62
58
</refsect1>
63
59
60
+
<refsect1 role="changelog">
61
+
&reftitle.changelog;
62
+
<informaltable>
63
+
<tgroup cols="2">
64
+
<thead>
65
+
<row>
66
+
<entry>&Version;</entry>
67
+
<entry>&Description;</entry>
68
+
</row>
69
+
</thead>
70
+
<tbody>
71
+
<row>
72
+
<entry>8.0.0</entry>
73
+
<entry>
74
+
This function returns an <classname>XMLParser</classname> instance now;
75
+
previously, a <type>resource</type> was returned, &return.falseforfailure;.
76
+
</entry>
77
+
</row>
78
+
<row>
79
+
<entry>8.0.0</entry>
80
+
<entry>
81
+
<parameter>encoding</parameter> is nullable now.
82
+
</entry>
83
+
</row>
84
+
</tbody>
85
+
</tgroup>
86
+
</informaltable>
87
+
</refsect1>
88
+
64
89
<refsect1 role="seealso">
65
90
&reftitle.seealso;
66
91
<para>
...
...
@@ -72,7 +97,6 @@
72
97
</refsect1>
73
98
74
99
</refentry>
75
-
76
100
<!-- Keep this comment at the end of the file
77
101
Local variables:
78
102
mode: sgml
79
103