 |
 |
 |
 |
|
|
Date: 10/27/98
- Next message: ssb: "[PHP-DEV] CVS update: php3/functions"
- Previous message: Stig Bakken: "Re: [PHP-DEV] There is something wrong with the HTML Manual (one BIG file)"
- Next in thread: ssb: "[PHP-DEV] CVS update: php3/doc/functions"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
Date: Tuesday October 27, 1998 @ 22:35
Author: ssb
Update of /repository/php3/doc/functions
In directory asf:/u2/tmp/cvs-serv14955/doc/functions
Modified Files:
xml.sgml
Log Message:
Unicode support (still no UTF-16, of course)
Index: php3/doc/functions/xml.sgml
diff -c php3/doc/functions/xml.sgml:1.13 php3/doc/functions/xml.sgml:1.14
*** php3/doc/functions/xml.sgml:1.13 Tue Oct 27 18:02:41 1998
--- php3/doc/functions/xml.sgml Tue Oct 27 22:35:52 1998
***************
*** 41,47 ****
somewhere exotic.
</para>
<para>
! Build PHP. Tada! That should be it.
</para>
</sect2>
<sect2 id="xml.about">
--- 41,47 ----
somewhere exotic.
</para>
<para>
! Build PHP. <emphasis>Tada!</emphasis> That should be it.
</para>
</sect2>
<sect2 id="xml.about">
***************
*** 49,69 ****
<para>
This PHP extension implements support for James Clark's
<productname>expat</productname> in PHP. This toolkit lets you
! parse, but not validate, XML documents. Although
! <productname>expat</productname> features full
! <acronym>UNICODE</acronym> character set support, this extension
! currently uses single-byte characters.
</para>
<para>
- The function names, parameters and constant names in this
- extension are as much as possible based on the names used in
- <productname>expat</productname>.
- </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>
<para>
The XML event handlers defined are:
--- 49,67 ----
<para>
This PHP extension implements support for James Clark's
<productname>expat</productname> in PHP. This toolkit lets you
! parse, but not validate, XML documents. It supports three
! source <link linkend="xml.encoding">character encodings</link>
! also provided by PHP: <literal>US-ASCII</literal>,
! <literal>ISO-8859-1</literal> and <literal>UTF-8</literal>.
! <literal>UTF-16</literal> is not supported.
</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 XML parser also has a few <link
! linkend="function.xml-parser-set-option">parameters</link> you
! can adjust.
</para>
<para>
The XML event handlers defined are:
***************
*** 155,161 ****
<para>
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.
--- 153,159 ----
<para>
By default, all the element names that are passed to the handler
functions are case-folded. This behaviour can be queried and
! controlled per XML parser with the
<function>xml_parser_get_option</function> and
<function>xml_parser_set_option</function> functions,
respectively.
***************
*** 194,217 ****
</sect2>
<sect2 id="xml.encoding">
<title>Character Encoding</title>
<para>
! Each XML parser can be created for a given <glossterm>character
! encoding</glossterm>. Currently, the supported encodings are
! ISO-8859-1, US-ASCII and UTF-8. The former two are single-byte
encodings, which means that each character is represented by a
! single byte. UTF-8 can encode characters composed by a
! variable number of bits (max 21) in one to four bytes. The
! default encoding used by PHP is ISO-8859-1.
! <note>
! <para>
! The character encoding given to
! <function>xml_parser_create</function> is only used on the
! parsed XML documents. All string passed to handler functions
! has been decoded to single bytes, and characters with values
! that can not be represented by a singly byte have been
! replaced by question marks.
! </para>
! </note>
</sect2>
</sect1>
<sect1 id="xml.examples">
--- 192,239 ----
</sect2>
<sect2 id="xml.encoding">
<title>Character Encoding</title>
+ <para>
+ PHP's XML extension supports the <ulink
+ url="&url.unicode;">Unicode</ulink> character set through
+ different <glossterm>character encoding</glossterm>s. There
+ are two types of character encodings, <glossterm>source
+ encoding</glossterm> and <glossterm>target
+ encoding</glossterm>. PHP's internal representation of the
+ document is always encoded with <literal>UTF-8</literal>.
+ </para>
<para>
! Source encoding is done when an XML document is <link
! linkend="function.xml-parse">parsed</link>. Upon <link
! linkend="function.xml-parser-create">creating an XML
! parser</link>, a source encoding can be specified (this
! encoding can not be changed later in the XML parser's
! lifetime). The supported source encodings are
! <literal>ISO-8859-1</literal>, <literal>US-ASCII</literal> and
! <literal>UTF-8</literal>. The former two are single-byte
encodings, which means that each character is represented by a
! single byte. <literal>UTF-8</literal> can encode characters
! composed by a variable number of bits (up to 21) in one to four
! bytes. The default source encoding used by PHP is
! <literal>ISO-8859-1</literal>.
! </para>
! <para>
! Target encoding is done when PHP passes data to XML handler
! functions. When an XML parser is created, the target encoding
! is set to the same as the source encoding, but this may be
! changed at any point. The target encoding will affect character
! data as well as tag names and processing instruction targets.
! </para>
! <para>
! If the XML parser encounters characters outside the range that
! its source encoding is capable of representing, it will return
! an error.
! </para>
! <para>
! If PHP encounters characters in the parsed XML document that can
! not be represented in the chosen target encoding, the problem
! characters will be "demoted". Currently, this means that such
! characters are replaced by a question mark.
! </para>
</sect2>
</sect1>
<sect1 id="xml.examples">
***************
*** 545,552 ****
</listitem>
</varlistentry>
</variablelist>
! Creates an XML parser and returns a handle for use by other XML
! functions. Returns <literal>false</literal> on failure.
</para>
</refsect1>
</refentry>
--- 567,575 ----
</listitem>
</varlistentry>
</variablelist>
! This function creates an XML parser and returns a handle for use
! by other XML functions. Returns <literal>false</literal> on
! failure.
</para>
</refsect1>
</refentry>
***************
*** 1268,1274 ****
<entry>integer</entry>
<entry>Controls whether <link
linkend="xml.case-folding">case-folding</link> is enabled for
! this parser. Enabled by default.</entry>
</row>
</tbody>
</tgroup>
--- 1291,1308 ----
<entry>integer</entry>
<entry>Controls whether <link
linkend="xml.case-folding">case-folding</link> is enabled for
! this XML parser. Enabled by default.</entry>
! </row>
! <row>
! <entry>XML_OPTION_TARGET_ENCODING</entry>
! <entry>string</entry> <entry>Sets which <link
! linkend="xml.encoding">target encoding</link> to use in this
! XML parser. By default, it is set to the same as the source
! encoding used by <function>xml_parser_create</function>.
! Supported target encodings are
! <literal>ISO-8859-1</literal>, <literal>US-ASCII</literal>
! and <literal>UTF-8</literal>.
! </entry>
</row>
</tbody>
</tgroup>
-- 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/functions"
- Previous message: Stig Bakken: "Re: [PHP-DEV] There is something wrong with the HTML Manual (one BIG file)"
- Next in thread: ssb: "[PHP-DEV] CVS update: php3/doc/functions"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]