php-doc-en/reference/xml/functions/xml-parser-create-ns.xml

95 lines
2.9 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id='function.xml-parser-create-ns'>
<refnamediv>
<refname>xml_parser_create_ns</refname>
<refpurpose>Create an XML parser with namespace support</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>resource</type><methodname>xml_parser_create_ns</methodname>
<methodparam choice="opt"><type>string</type><parameter>encoding</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>separator</parameter><initializer>":"</initializer></methodparam>
</methodsynopsis>
<para>
<function>xml_parser_create_ns</function> creates a new XML parser
with XML namespace support and returns a resource handle referencing
it to be used by the other XML functions.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>encoding</parameter></term>
<listitem>
<para>
The optional <parameter>encoding</parameter> specifies the character
encoding for the input/output in PHP 4. Starting from PHP 5, the input
encoding is automatically detected, so that the
<parameter>encoding</parameter> parameter specifies only the output
encoding. In PHP 4, the default output encoding is the same as the
input charset. In PHP 5.0.0 and 5.0.1, the default output charset is
ISO-8859-1, while in PHP 5.0.2 and upper is UTF-8. The supported
encodings are <literal>ISO-8859-1</literal>, <literal>UTF-8</literal> and
<literal>US-ASCII</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>separator</parameter></term>
<listitem>
<para>
With a namespace aware parser tag parameters passed to the various
handler functions will consist of namespace and tag name separated by
the string specified in <parameter>separator</parameter>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns a resource handle for the new XML parser.
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>xml_parser_create</function></member>
<member><function>xml_parser_free</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->