 |
 |
 |
 |
|
|
Date: 10/23/98
- Next message: ssb: "[PHP-DEV] CVS update: php3/doc/functions"
- Previous message: ssb: "[PHP-DEV] CVS update: php3/functions"
- Next in thread: ssb: "[PHP-DEV] CVS update: php3/doc/functions"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
Date: Friday October 23, 1998 @ 7:18
Author: ssb
Update of /repository/php3/doc/functions
In directory asf:/u2/tmp/cvs-serv9396/doc/functions
Modified Files:
xml.sgml
Log Message:
Zeev wins :-)
Index: php3/doc/functions/xml.sgml
diff -c php3/doc/functions/xml.sgml:1.8 php3/doc/functions/xml.sgml:1.9
*** php3/doc/functions/xml.sgml:1.8 Thu Oct 22 10:46:38 1998
--- php3/doc/functions/xml.sgml Fri Oct 23 07:18:25 1998
***************
*** 61,67 ****
</para>
<para>
This extension lets you <link
! linkend="function.xml-parsercreate">create XML parsers</link>
and then define <emphasis>handlers</emphasis> for different XML
events. Each parser also has a few parameters you can adjust.
</para>
--- 61,67 ----
</para>
<para>
This extension lets you <link
! linkend="function.xml-parser-create">create XML parsers</link>
and then define <emphasis>handlers</emphasis> for different XML
events. Each parser also has a few parameters you can adjust.
</para>
***************
*** 78,84 ****
</thead>
<tbody>
<row>
! <entry><function>XML_SetElementHandler</function></entry>
<entry>
Element events are issued whenever the XML parser
encounters start or end tags. There are separate handlers
--- 78,84 ----
</thead>
<tbody>
<row>
! <entry><function>xml_set_element_handler</function></entry>
<entry>
Element events are issued whenever the XML parser
encounters start or end tags. There are separate handlers
***************
*** 86,92 ****
</entry>
</row>
<row>
! <entry><function>XML_SetCharacterDataHandler</function></entry>
<entry>
Character data is roughly all the non-markup contents of
XML documents, including whitespace between tags. Note
--- 86,92 ----
</entry>
</row>
<row>
! <entry><function>xml_set_character_data_handler</function></entry>
<entry>
Character data is roughly all the non-markup contents of
XML documents, including whitespace between tags. Note
***************
*** 96,102 ****
</entry>
</row>
<row>
! <entry><function>XML_SetProcessingInstructionHandler</function></entry>
<entry>
PHP programmers should be familiar with processing
instructions (PIs) already. <?php ?> is a processing
--- 96,102 ----
</entry>
</row>
<row>
! <entry><function>xml_set_processing_instruction_handler</function></entry>
<entry>
PHP programmers should be familiar with processing
instructions (PIs) already. <?php ?> is a processing
***************
*** 107,113 ****
</entry>
</row>
<row>
! <entry><function>XML_SetDefaultHandler</function></entry>
<entry>
What goes not to another handler goes to the default
handler. You will get things like the XML and document
--- 107,113 ----
</entry>
</row>
<row>
! <entry><function>xml_set_default_handler</function></entry>
<entry>
What goes not to another handler goes to the default
handler. You will get things like the XML and document
***************
*** 115,134 ****
</entry>
</row>
<row>
! <entry><function>XML_SetUnparsedEntityDeclHandler</function></entry>
<entry>
This handler will be called for declaration of an unparsed
(NDATA) entity.
</entry>
</row>
<row>
! <entry><function>XML_SetNotationDeclHandler</function></entry>
<entry>
This handler is called for declaration of a notation.
</entry>
</row>
<row>
! <entry><function>XML_SetExternalEntityRefHandler</function></entry>
<entry>
This handler is called when the XML parser finds a
reference to an external parsed general entity. This can
--- 115,134 ----
</entry>
</row>
<row>
! <entry><function>xml_set_unparsed_entity_decl_handler</function></entry>
<entry>
This handler will be called for declaration of an unparsed
(NDATA) entity.
</entry>
</row>
<row>
! <entry><function>xml_set_notation_decl_handler</function></entry>
<entry>
This handler is called for declaration of a notation.
</entry>
</row>
<row>
! <entry><function>xml_set_external_entity_ref_handler</function></entry>
<entry>
This handler is called when the XML parser finds a
reference to an external parsed general entity. This can
***************
*** 156,163 ****
By default, all the element names that are passed to the handler
functions are case-folded. This behaviour can be queried and
controlled per parser with the
! <function>XML_ParserGetOption</function> and
! <function>XML_ParserSetOption</function> functions,
respectively.
</para>
</sect2>
--- 156,163 ----
By default, all the element names that are passed to the handler
functions are case-folded. This behaviour can be queried and
controlled per parser with the
! <function>xml_parser_get_option</function> and
! <function>xml_parser_set_option</function> functions,
respectively.
</para>
</sect2>
***************
*** 165,171 ****
<title>Error Codes</title>
<para>
The following constants are defined for XML error codes (as
! returned by <function>XML_Parse</function>):
<simplelist>
<member>XML_ERROR_NONE</member>
<member>XML_ERROR_NO_MEMORY</member>
--- 165,171 ----
<title>Error Codes</title>
<para>
The following constants are defined for XML error codes (as
! returned by <function>xml_parse</function>):
<simplelist>
<member>XML_ERROR_NONE</member>
<member>XML_ERROR_NO_MEMORY</member>
***************
*** 226,244 ****
$depth[$parser]--;
}
! $xml_parser = XML_ParserCreate();
! XML_SetElementHandler($xml_parser, "startElement", "endElement");
if (!($fp = fopen($file, "r"))) {
die("could not open XML input");
}
while ($data = fread($fp, 4096)) {
! if (!XML_Parse($xml_parser, $data, feof($fp))) {
die(sprintf("XML error: %s at line %d",
! XML_ErrorString(XML_GetErrorCode($xml_parser)),
! XML_GetCurrentLineNumber($xml_parser)));
}
}
! XML_ParserFree($xml_parser);
</programlisting>
</example>
</para>
--- 226,244 ----
$depth[$parser]--;
}
! $xml_parser = xml_parser_create();
! xml_set_element_handler($xml_parser, "startElement", "endElement");
if (!($fp = fopen($file, "r"))) {
die("could not open XML input");
}
while ($data = fread($fp, 4096)) {
! if (!xml_parse($xml_parser, $data, feof($fp))) {
die(sprintf("XML error: %s at line %d",
! xml_error_string(xml_get_error_code($xml_parser)),
! xml_get_current_line_number($xml_parser)));
}
}
! xml_parser_free($xml_parser);
</programlisting>
</example>
</para>
***************
*** 282,303 ****
print $data;
}
! $xml_parser = XML_ParserCreate();
// use case-folding so we are sure to find the tag in $map_array
! XML_ParserSetOption($xml_parser, XML_OPTION_CASE_FOLDING, true);
! XML_SetElementHandler($xml_parser, "startElement", "endElement");
! XML_SetCharacterDataHandler($xml_parser, "characterData");
if (!($fp = fopen($file, "r"))) {
die("could not open XML input");
}
while ($data = fread($fp, 4096)) {
! if (!XML_Parse($xml_parser, $data, feof($fp))) {
die(sprintf("XML error: %s at line %d",
! XML_ErrorString(XML_GetErrorCode($xml_parser)),
! XML_GetCurrentLineNumber($xml_parser)));
}
}
! XML_ParserFree($xml_parser);
</programlisting>
</example>
</para>
--- 282,303 ----
print $data;
}
! $xml_parser = xml_parser_create();
// use case-folding so we are sure to find the tag in $map_array
! xml_parser_set_option($xml_parser, XML_OPTION_CASE_FOLDING, true);
! xml_set_element_handler($xml_parser, "startElement", "endElement");
! xml_set_character_data_handler($xml_parser, "characterData");
if (!($fp = fopen($file, "r"))) {
die("could not open XML input");
}
while ($data = fread($fp, 4096)) {
! if (!xml_parse($xml_parser, $data, feof($fp))) {
die(sprintf("XML error: %s at line %d",
! xml_error_string(xml_get_error_code($xml_parser)),
! xml_get_current_line_number($xml_parser)));
}
}
! xml_parser_free($xml_parser);
</programlisting>
</example>
</para>
***************
*** 387,401 ****
return false;
}
while ($data = fread($fp, 4096)) {
! if (!XML_Parse($parser, $data, feof($fp))) {
printf("XML error: %s at line %d while parsing entity %s\n",
! XML_ErrorString(XML_GetErrorCode($parser)),
! XML_GetCurrentLineNumber($parser), $openEntityNames);
! XML_ParserFree($parser);
return false;
}
}
! XML_ParserFree($parser);
return true;
}
return false;
--- 387,401 ----
return false;
}
while ($data = fread($fp, 4096)) {
! if (!xml_parse($parser, $data, feof($fp))) {
printf("XML error: %s at line %d while parsing entity %s\n",
! xml_error_string(xml_get_error_code($parser)),
! xml_get_current_line_number($parser), $openEntityNames);
! xml_parser_free($parser);
return false;
}
}
! xml_parser_free($parser);
return true;
}
return false;
***************
*** 405,417 ****
function new_xml_parser($file) {
global $parser_file;
! $xml_parser = XML_ParserCreate();
! XML_ParserSetOption($xml_parser, XML_OPTION_CASE_FOLDING, 1);
! XML_SetElementHandler($xml_parser, "startElement", "endElement");
! XML_SetCharacterDataHandler($xml_parser, "characterData");
! XML_SetProcessingInstructionHandler($xml_parser, "PIHandler");
! XML_SetDefaultHandler($xml_parser, "defaultHandler");
! XML_SetExternalEntityRefHandler($xml_parser, "externalEntityRefHandler");
if (!($fp = <email protected>($file, "r"))) {
return false;
--- 405,417 ----
function new_xml_parser($file) {
global $parser_file;
! $xml_parser = xml_parser_create();
! xml_parser_set_option($xml_parser, XML_OPTION_CASE_FOLDING, 1);
! xml_set_element_handler($xml_parser, "startElement", "endElement");
! xml_set_character_data_handler($xml_parser, "characterData");
! xml_set_processing_instruction_handler($xml_parser, "PIHandler");
! xml_set_default_handler($xml_parser, "defaultHandler");
! xml_set_external_entity_ref_handler($xml_parser, "externalEntityRefHandler");
if (!($fp = <email protected>($file, "r"))) {
return false;
***************
*** 429,443 ****
print "<pre>";
while ($data = fread($fp, 4096)) {
! if (!XML_Parse($xml_parser, $data, feof($fp))) {
die(sprintf("XML error: %s at line %d\n",
! XML_ErrorString(XML_GetErrorCode($xml_parser)),
! XML_GetCurrentLineNumber($xml_parser)));
}
}
print "</pre>";
print "parse complete\n";
! XML_ParserFree($xml_parser);
?>
--- 429,443 ----
print "<pre>";
while ($data = fread($fp, 4096)) {
! if (!xml_parse($xml_parser, $data, feof($fp))) {
die(sprintf("XML error: %s at line %d\n",
! xml_error_string(xml_get_error_code($xml_parser)),
! xml_get_current_line_number($xml_parser)));
}
}
print "</pre>";
print "parse complete\n";
! xml_parser_free($xml_parser);
?>
***************
*** 499,513 ****
</sect1>
</partintro>
! <refentry id="function.xml-parsercreate">
<refnamediv>
! <refname>XML_ParserCreate</refname>
<refpurpose>create an XML parser</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>XML_ParserCreate</function></funcdef>
<void>
</funcsynopsis>
<para>
--- 499,513 ----
</sect1>
</partintro>
! <refentry id="function.xml-parser-create">
<refnamediv>
! <refname>xml_parser_create</refname>
<refpurpose>create an XML parser</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>xml_parser_create</function></funcdef>
<void>
</funcsynopsis>
<para>
***************
*** 517,531 ****
</refsect1>
</refentry>
! <refentry id="function.xml-setelementhandler">
<refnamediv>
! <refname>XML_SetElementHandler</refname>
<refpurpose>set up start and end element handlers</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>XML_SetElementHandler</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>string <parameter>startElementHandler</parameter></paramdef>
<paramdef>string <parameter>endElementHandler</parameter></paramdef>
--- 517,531 ----
</refsect1>
</refentry>
! <refentry id="function.xml-set-element-handler">
<refnamediv>
! <refname>xml_set_element_handler</refname>
<refpurpose>set up start and end element handlers</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>xml_set_element_handler</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>string <parameter>startElementHandler</parameter></paramdef>
<paramdef>string <parameter>endElementHandler</parameter></paramdef>
***************
*** 536,542 ****
<parameter>startElementHandler</parameter> and
<parameter>endElementHandler</parameter> are strings containing
the names of functions that must exist when
! <function>XML_Parse</function> is called for
<parameter>parser</parameter>.
<para>
The function named by <parameter>startElementHandler</parameter>
--- 536,542 ----
<parameter>startElementHandler</parameter> and
<parameter>endElementHandler</parameter> are strings containing
the names of functions that must exist when
! <function>xml_parse</function> is called for
<parameter>parser</parameter>.
<para>
The function named by <parameter>startElementHandler</parameter>
***************
*** 619,633 ****
</refsect1>
</refentry>
! <refentry id="function.xml-setcharacterdatahandler">
<refnamediv>
! <refname>XML_SetCharacterDataHandler</refname>
<refpurpose>set up character data handler</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>XML_SetCharacterDataHandler</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>string <parameter>handler</parameter></paramdef>
</funcsynopsis>
--- 619,633 ----
</refsect1>
</refentry>
! <refentry id="function.xml-set-character-data-handler">
<refnamediv>
! <refname>xml_set_character_data_handler</refname>
<refpurpose>set up character data handler</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>xml_set_character_data_handler</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>string <parameter>handler</parameter></paramdef>
</funcsynopsis>
***************
*** 635,641 ****
Sets the character data handler function for the XML parser
<parameter>parser</parameter>. <parameter>handler</parameter> is
a string containing the name of a function that must exist when
! <function>XML_Parse</function> is called for
<parameter>parser</parameter>.
<para>
The function named by <parameter>handler</parameter> must accept
--- 635,641 ----
Sets the character data handler function for the XML parser
<parameter>parser</parameter>. <parameter>handler</parameter> is
a string containing the name of a function that must exist when
! <function>xml_parse</function> is called for
<parameter>parser</parameter>.
<para>
The function named by <parameter>handler</parameter> must accept
***************
*** 671,685 ****
</refsect1>
</refentry>
! <refentry id="function.xml-setprocessinginstructionhandler">
<refnamediv>
! <refname>XML_SetProcessingInstructionHandler</refname>
<refpurpose>set up processing instruction (PI) handler</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>XML_SetProcessingInstructionHandler</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>string <parameter>handler</parameter></paramdef>
</funcsynopsis>
--- 671,685 ----
</refsect1>
</refentry>
! <refentry id="function.xml-set-processing-instruction-handler">
<refnamediv>
! <refname>xml_set_processing_instruction_handler</refname>
<refpurpose>set up processing instruction (PI) handler</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>xml_set_processing_instruction_handler</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>string <parameter>handler</parameter></paramdef>
</funcsynopsis>
***************
*** 687,693 ****
Sets the processing instruction (PI) handler function for the XML
parser <parameter>parser</parameter>.
<parameter>handler</parameter> is a string containing the name of
! a function that must exist when <function>XML_Parse</function> is
called for <parameter>parser</parameter>.
<para>
A processing instruction has the following format:
--- 687,693 ----
Sets the processing instruction (PI) handler function for the XML
parser <parameter>parser</parameter>.
<parameter>handler</parameter> is a string containing the name of
! a function that must exist when <function>xml_parse</function> is
called for <parameter>parser</parameter>.
<para>
A processing instruction has the following format:
***************
*** 741,755 ****
</refsect1>
</refentry>
! <refentry id="function.xml-setdefaulthandler">
<refnamediv>
! <refname>XML_SetDefaultHandler</refname>
<refpurpose>set up default handler</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>XML_SetDefaultHandler</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>string <parameter>handler</parameter></paramdef>
</funcsynopsis>
--- 741,755 ----
</refsect1>
</refentry>
! <refentry id="function.xml-set-default-handler">
<refnamediv>
! <refname>xml_set_default_handler</refname>
<refpurpose>set up default handler</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>xml_set_default_handler</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>string <parameter>handler</parameter></paramdef>
</funcsynopsis>
***************
*** 757,763 ****
Sets the default handler function for the XML parser
<parameter>parser</parameter>. <parameter>handler</parameter> is
a string containing the name of a function that must exist when
! <function>XML_Parse</function> is called for
<parameter>parser</parameter>.
<para>
The function named by <parameter>handler</parameter> must accept
--- 757,763 ----
Sets the default handler function for the XML parser
<parameter>parser</parameter>. <parameter>handler</parameter> is
a string containing the name of a function that must exist when
! <function>xml_parse</function> is called for
<parameter>parser</parameter>.
<para>
The function named by <parameter>handler</parameter> must accept
***************
*** 795,809 ****
</refsect1>
</refentry>
! <refentry id="function.xml-setunparsedentitydeclhandler">
<refnamediv>
! <refname>XML_SetUnparsedEntityDeclHandler</refname>
<refpurpose>set up unparsed entity declaration handler</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>XML_SetUnparsedEntityDeclHandler</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>string <parameter>handler</parameter></paramdef>
</funcsynopsis>
--- 795,809 ----
</refsect1>
</refentry>
! <refentry id="function.xml-set-unparsed-entity-decl-handler">
<refnamediv>
! <refname>xml_set_unparsed_entity_decl_handler</refname>
<refpurpose>set up unparsed entity declaration handler</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>xml_set_unparsed_entity_decl_handler</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>string <parameter>handler</parameter></paramdef>
</funcsynopsis>
***************
*** 811,817 ****
Sets the unparsed entity declaration handler function for the XML
parser <parameter>parser</parameter>.
<parameter>handler</parameter> is a string containing the name of
! a function that must exist when <function>XML_Parse</function> is
called for <parameter>parser</parameter>.
<para>
The function named by <parameter>handler</parameter> must accept
--- 811,817 ----
Sets the unparsed entity declaration handler function for the XML
parser <parameter>parser</parameter>.
<parameter>handler</parameter> is a string containing the name of
! a function that must exist when <function>xml_parse</function> is
called for <parameter>parser</parameter>.
<para>
The function named by <parameter>handler</parameter> must accept
***************
*** 837,851 ****
</refsect1>
</refentry>
! <refentry id="function.xml-setnotationdeclhandler">
<refnamediv>
! <refname>XML_SetNotationDeclHandler</refname>
<refpurpose>set up notation declaration handler</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>XML_SetNotationDeclHandler</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>string <parameter>handler</parameter></paramdef>
</funcsynopsis>
--- 837,851 ----
</refsect1>
</refentry>
! <refentry id="function.xml-set-notation-decl-handler">
<refnamediv>
! <refname>xml_set_notation_decl_handler</refname>
<refpurpose>set up notation declaration handler</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>xml_set_notation_decl_handler</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>string <parameter>handler</parameter></paramdef>
</funcsynopsis>
***************
*** 853,859 ****
Sets the notation declaration handler function for the XML parser
<parameter>parser</parameter>. <parameter>handler</parameter> is
a string containing the name of a function that must exist when
! <function>XML_Parse</function> is called for
<parameter>parser</parameter>.
<para>
The function named by <parameter>handler</parameter> must accept
--- 853,859 ----
Sets the notation declaration handler function for the XML parser
<parameter>parser</parameter>. <parameter>handler</parameter> is
a string containing the name of a function that must exist when
! <function>xml_parse</function> is called for
<parameter>parser</parameter>.
<para>
The function named by <parameter>handler</parameter> must accept
***************
*** 878,892 ****
</refsect1>
</refentry>
! <refentry id="function.xml-setexternalentityrefhandler">
<refnamediv>
! <refname>XML_SetExternalEntityRefHandler</refname>
<refpurpose>set up external entity reference handler</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>XML_SetExternalEntityRefHandler</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>string <parameter>handler</parameter></paramdef>
</funcsynopsis>
--- 878,892 ----
</refsect1>
</refentry>
! <refentry id="function.xml-set-external-entity-ref-handler">
<refnamediv>
! <refname>xml_set_external_entity_ref_handler</refname>
<refpurpose>set up external entity reference handler</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>xml_set_external_entity_ref_handler</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>string <parameter>handler</parameter></paramdef>
</funcsynopsis>
***************
*** 894,907 ****
Sets the notation declaration handler function for the XML parser
<parameter>parser</parameter>. <parameter>handler</parameter> is
a string containing the name of a function that must exist when
! <function>XML_Parse</function> is called for
<parameter>parser</parameter>.
<para>
The function named by <parameter>handler</parameter> must accept
five parameters, and should return an integer value. If the
value returned from the handler is false (which it will be if no
value is returned), the XML parser will stop parsing and
! <function>XML_GetErrorCode</function> will return <systemitem
class="constant">XML_ERROR_EXTERNAL_ENTITY_HANDLING</systemitem>.
<funcsynopsis>
--- 894,907 ----
Sets the notation declaration handler function for the XML parser
<parameter>parser</parameter>. <parameter>handler</parameter> is
a string containing the name of a function that must exist when
! <function>xml_parse</function> is called for
<parameter>parser</parameter>.
<para>
The function named by <parameter>handler</parameter> must accept
five parameters, and should return an integer value. If the
value returned from the handler is false (which it will be if no
value is returned), the XML parser will stop parsing and
! <function>xml_get_error_code</function> will return <systemitem
class="constant">XML_ERROR_EXTERNAL_ENTITY_HANDLING</systemitem>.
<funcsynopsis>
***************
*** 934,940 ****
currently reserved for future use. It should be the system
identifier that should be used as the base for resolving
<parameter>systemId</parameter> if systemId was relative.
! <!-- XXX this is set by XML_SetBase -->
This parameter may be an empty string.
</varlistentry>
<varlistentry>
--- 934,940 ----
currently reserved for future use. It should be the system
identifier that should be used as the base for resolving
<parameter>systemId</parameter> if systemId was relative.
! <!-- XXX this is set by xml_set_base -->
This parameter may be an empty string.
</varlistentry>
<varlistentry>
***************
*** 966,978 ****
<refentry id="function.xml-parse">
<refnamediv>
! <refname>XML_Parse</refname>
<refpurpose>start parsing an XML document</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>XML_Parse</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>string <parameter>data</parameter></paramdef>
<paramdef>int <parameter><optional>isFinal</optional></parameter></paramdef>
--- 966,978 ----
<refentry id="function.xml-parse">
<refnamediv>
! <refname>xml_parse</refname>
<refpurpose>start parsing an XML document</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>xml_parse</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>string <parameter>data</parameter></paramdef>
<paramdef>int <parameter><optional>isFinal</optional></parameter></paramdef>
***************
*** 988,994 ****
<term><parameter>data</parameter></term>
<listitem><simpara>
Chunk of data to parse. A document may be parsed piece-wise
! by calling <function>XML_Parse</function> several times with
new data, as long as the <parameter>isFinal</parameter>
parameter is set and true when the last data is parsed.
</varlistentry>
--- 988,994 ----
<term><parameter>data</parameter></term>
<listitem><simpara>
Chunk of data to parse. A document may be parsed piece-wise
! by calling <function>xml_parse</function> several times with
new data, as long as the <parameter>isFinal</parameter>
parameter is set and true when the last data is parsed.
</varlistentry>
***************
*** 1007,1030 ****
True is returned if the parse was successful, false if it was not
successful, or if <parameter>parser</parameter> does not refer to
a valid parser. For unsuccessful parses, error information can
! be retrieved with <function>XML_GetErrorCode</function>,
! <function>XML_ErrorString</function>,
! <function>XML_GetCurrentLineNumber</function>,
! <function>XML_GetCurrentColumnNumber</function> and
! <function>XML_GetCurrentByteIndex</function>.
</para>
</refsect1>
</refentry>
! <refentry id="function.xml-geterrorcode">
<refnamediv>
! <refname>XML_GetErrorCode</refname>
<refpurpose>get XML parser error code</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>XML_GetErrorCode</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
</funcsynopsis>
<para>
--- 1007,1030 ----
True is returned if the parse was successful, false if it was not
successful, or if <parameter>parser</parameter> does not refer to
a valid parser. For unsuccessful parses, error information can
! be retrieved with <function>xml_get_error_code</function>,
! <function>xml_error_string</function>,
! <function>xml_get_current_line_number</function>,
! <function>xml_get_current_column_number</function> and
! <function>xml_get_current_byte_index</function>.
</para>
</refsect1>
</refentry>
! <refentry id="function.xml-get-error-code">
<refnamediv>
! <refname>xml_get_error_code</refname>
<refpurpose>get XML parser error code</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>xml_get_error_code</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
</funcsynopsis>
<para>
***************
*** 1044,1058 ****
</refsect1>
</refentry>
! <refentry id="function.xml-errorstring">
<refnamediv>
! <refname>XML_ErrorString</refname>
<refpurpose>get XML parser error string</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>string <function>XML_ErrorString</function></funcdef>
<paramdef>int <parameter>code</parameter></paramdef>
</funcsynopsis>
<para>
--- 1044,1058 ----
</refsect1>
</refentry>
! <refentry id="function.xml-error-string">
<refnamediv>
! <refname>xml_error_string</refname>
<refpurpose>get XML parser error string</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>string <function>xml_error_string</function></funcdef>
<paramdef>int <parameter>code</parameter></paramdef>
</funcsynopsis>
<para>
***************
*** 1060,1066 ****
<varlistentry>
<term><parameter>code</parameter></term>
<listitem><simpara>
! An error code from <function>XML_GetErrorCode</function>.
</varlistentry>
</variablelist>
<para>
--- 1060,1066 ----
<varlistentry>
<term><parameter>code</parameter></term>
<listitem><simpara>
! An error code from <function>xml_get_error_code</function>.
</varlistentry>
</variablelist>
<para>
***************
*** 1070,1084 ****
</refsect1>
</refentry>
! <refentry id="function.xml-getcurrentlinenumber">
<refnamediv>
! <refname>XML_GetCurrentLineNumber</refname>
<refpurpose>get current line number for an XML parser</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>XML_GetCurrentLineNumber</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
</funcsynopsis>
<para>
--- 1070,1084 ----
</refsect1>
</refentry>
! <refentry id="function.xml-get-current-line-number">
<refnamediv>
! <refname>xml_get_current_line_number</refname>
<refpurpose>get current line number for an XML parser</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>xml_get_current_line_number</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
</funcsynopsis>
<para>
***************
*** 1097,1111 ****
</refsect1>
</refentry>
! <refentry id="function.xml-getcurrentcolumnnumber">
<refnamediv>
! <refname>XML_GetCurrentColumnNumber</refname>
<refpurpose>get current column number for an XML parser</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>XML_GetCurrentColumnNumber</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
</funcsynopsis>
<para>
--- 1097,1111 ----
</refsect1>
</refentry>
! <refentry id="function.xml-get-current-column-number">
<refnamediv>
! <refname>xml_get_current_column_number</refname>
<refpurpose>get current column number for an XML parser</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>xml_get_current_column_number</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
</funcsynopsis>
<para>
***************
*** 1120,1140 ****
This function returns false if <parameter>parser</parameter> does
not refer to a valid parser, or else it returns which column on
the current line (as given by
! <function>XML_GetCurrentLineNumber</function>) the parser is
currently at.
</para>
</refsect1>
</refentry>
! <refentry id="function.xml-getcurrentbyteindex">
<refnamediv>
! <refname>XML_GetCurrentByteIndex</refname>
<refpurpose>get current byte index for an XML parser</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>XML_GetCurrentByteIndex</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
</funcsynopsis>
<para>
--- 1120,1140 ----
This function returns false if <parameter>parser</parameter> does
not refer to a valid parser, or else it returns which column on
the current line (as given by
! <function>xml_get_current_line_number</function>) the parser is
currently at.
</para>
</refsect1>
</refentry>
! <refentry id="function.xml-get-current-byte-index">
<refnamediv>
! <refname>xml_get_current_byte_index</refname>
<refpurpose>get current byte index for an XML parser</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>xml_get_current_byte_index</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
</funcsynopsis>
<para>
***************
*** 1153,1167 ****
</refsect1>
</refentry>
! <refentry id="function.xml-parserfree">
<refnamediv>
! <refname>XML_ParserFree</refname>
<refpurpose>free an XML parser</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>string <function>XML_ParserFree</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
</funcsynopsis>
<para>
--- 1153,1167 ----
</refsect1>
</refentry>
! <refentry id="function.xml-parser-free">
<refnamediv>
! <refname>xml_parser_free</refname>
<refpurpose>free an XML parser</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>string <function>xml_parser_free</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
</funcsynopsis>
<para>
***************
*** 1180,1194 ****
</refsect1>
</refentry>
! <refentry id="function.xml-parsersetoption">
<refnamediv>
! <refname>XML_ParserSetOption</refname>
<refpurpose>set options in an XML parser</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>XML_ParserSetOption</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>int <parameter>option</parameter></paramdef>
<paramdef>mixed <parameter>value</parameter></paramdef>
--- 1180,1194 ----
</refsect1>
</refentry>
! <refentry id="function.xml-parser-set-option">
<refnamediv>
! <refname>xml_parser_set_option</refname>
<refpurpose>set options in an XML parser</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>int <function>xml_parser_set_option</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>int <parameter>option</parameter></paramdef>
<paramdef>mixed <parameter>value</parameter></paramdef>
***************
*** 1243,1257 ****
</refsect1>
</refentry>
! <refentry id="function.xml-parsergetoption">
<refnamediv>
! <refname>XML_ParserGetOption</refname>
<refpurpose>get options from an XML parser</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>mixed <function>XML_ParserGetOption</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>int <parameter>option</parameter></paramdef>
</funcsynopsis>
--- 1243,1257 ----
</refsect1>
</refentry>
! <refentry id="function.xml-parser-get-option">
<refnamediv>
! <refname>xml_parser_get_option</refname>
<refpurpose>get options from an XML parser</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
! <funcdef>mixed <function>xml_parser_get_option</function></funcdef>
<paramdef>int <parameter>parser</parameter></paramdef>
<paramdef>int <parameter>option</parameter></paramdef>
</funcsynopsis>
***************
*** 1266,1272 ****
<term><parameter>option</parameter></term>
<listitem><simpara>
Which option to fetch. See
! <function>XML_ParserSetOption</function> for a list of options.
</varlistentry>
</variablelist>
<para>
--- 1266,1272 ----
<term><parameter>option</parameter></term>
<listitem><simpara>
Which option to fetch. See
! <function>xml_parser_set_option</function> for a list of options.
</varlistentry>
</variablelist>
<para>
***************
*** 1275,1281 ****
Else the option's value is returned.
</para>
<para>
! See <function>XML_ParserSetOption</function> for the list of
options.
</para>
</refsect1>
--- 1275,1281 ----
Else the option's value is returned.
</para>
<para>
! See <function>xml_parser_set_option</function> for the list of
options.
</para>
</refsect1>
-- PHP Development Mailing List http://www.php.net/ To unsubscribe send an empty message to php-dev-unsubscribe <email protected> For help: php-dev-help <email protected>
- Next message: ssb: "[PHP-DEV] CVS update: php3/doc/functions"
- Previous message: ssb: "[PHP-DEV] CVS update: php3/functions"
- Next in thread: ssb: "[PHP-DEV] CVS update: php3/doc/functions"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]