Mode parameter (bug #24722)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@165650 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Jakub Vrana 2004-08-07 16:18:12 +00:00
parent aaf36db3fc
commit 51c248a7d2
2 changed files with 34 additions and 2 deletions

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- $Revision: 1.6 $ -->
<!-- splitted from ./en/functions/domxml.xml, last change in rev 1.1 -->
<refentry id="function.domxml-open-file">
<refnamediv>
@ -11,6 +11,8 @@
<methodsynopsis>
<type>object</type><methodname>domxml_open_file</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>&amp;error</parameter></methodparam>
</methodsynopsis>
<para>
The function parses the XML document in the file named
@ -18,6 +20,23 @@
"Dom document", having the properties as listed above.
The file is accessed read-only.
</para>
<para>
Optional parameter <parameter>mode</parameter> can be used to change the
behavior of this function. It was added in PHP 4.3.0. You can use one of
<constant>DOMXML_LOAD_PARSING</constant> (default),
<constant>DOMXML_LOAD_VALIDATING</constant> or
<constant>DOMXML_LOAD_RECOVERING</constant> for it.
You can add to it also <constant>DOMXML_LOAD_DONT_KEEP_BLANKS</constant>,
<constant>DOMXML_LOAD_SUBSTITUTE_ENTITIES</constant> and
<constant>DOMXML_LOAD_COMPLETE_ATTRS</constant> by
<link linkend="language.operators.bitwise">bitwise or</link>.
</para>
<para>
If the <parameter>error</parameter> parameter is used, it will contain the
error messages. <parameter>error</parameter> must be passed in by
<link linkend="language.references">reference</link>. The parameter was
added in PHP 4.3.0.
</para>
<para>
<example>
<title>Opening an XML document from a file</title>

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- $Revision: 1.6 $ -->
<!-- splitted from ./en/functions/domxml.xml, last change in rev 1.1 -->
<refentry id="function.domxml-open-mem">
<refnamediv>
@ -11,6 +11,8 @@
<methodsynopsis>
<type>object</type><methodname>domxml_open_mem</methodname>
<methodparam><type>string</type><parameter>str</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>&amp;error</parameter></methodparam>
</methodsynopsis>
<para>
The function parses the XML document in
@ -19,6 +21,17 @@
<function>domxml_open_file</function> or <function>domxml_new_doc</function>
must be called before any other function calls.
</para>
<para>
Optional parameter <parameter>mode</parameter> can be used to change the
behavior of this function. It was added in PHP 4.3.0. See
<function>domxml_open_file</function> for possible values.
</para>
<para>
If the <parameter>error</parameter> parameter is used, it will contain the
error messages. <parameter>error</parameter> must be passed in by
<link linkend="language.references">reference</link>. The parameter was
added in PHP 4.3.0.
</para>
<para>
<example>
<title>Opening an XML document in a string</title>