<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.11 $ -->
<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></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>seperator</parameter> or
       <literal>':'</literal> by default. 
      </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:"../../../../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
-->