<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.xml-parser-create">
 <refnamediv>
  <refname>xml_parser_create</refname>
  <refpurpose>Create an XML parser</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>resource</type><methodname>xml_parser_create</methodname>
   <methodparam choice="opt"><type>string</type><parameter>encoding</parameter></methodparam>
  </methodsynopsis>
  <para>
   <function>xml_parser_create</function> creates a new XML parser
   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. If empty string is passed, the parser attempts to identify
       which encoding the document is encoded in by looking at the heading 3 or
       4 bytes. 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>
   </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_ns</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
-->