cvs: phpdoc-fr /reference/xml reference.xml /reference/xml/functions utf8-decode.xml utf8-encode.xml xml-error-string.xml
xml-get-current-byte-index.xml xml-get-error-code.xml xml-parse-into-struct.xml xml-parse.xml xml-parser-create-ns.xml xml-parser-create.xml
xml-parser-free.xml xml-parser-get-option.xml xml-parser-set-option.xml xml-set-character-data-handler.xml xml-set-default-handler.xml
xml-set-element-handler.xml xml-set-end-namespace-decl-handler.xml xml-set-external-entity-ref-handler.xml xml-set-notation-decl-handler.xml
xml-set-object.xml xml-set-processing-instruction-handler.xml xml-set-start-namespace-decl-handler.xml xml-set-unparsed-entity-decl-handler.xml

From: Date: Mon, 28 Apr 2003 15:47:14 +0000
Subject: cvs: phpdoc-fr /reference/xml reference.xml /reference/xml/functions utf8-decode.xml utf8-encode.xml xml-error-string.xml
xml-get-current-byte-index.xml xml-get-error-code.xml xml-parse-into-struct.xml xml-parse.xml xml-parser-create-ns.xml xml-parser-create.xml
xml-parser-free.xml xml-parser-get-option.xml xml-parser-set-option.xml xml-set-character-data-handler.xml xml-set-default-handler.xml
xml-set-element-handler.xml xml-set-end-namespace-decl-handler.xml xml-set-external-entity-ref-handler.xml xml-set-notation-decl-handler.xml
xml-set-object.xml xml-set-processing-instruction-handler.xml xml-set-start-namespace-decl-handler.xml xml-set-unparsed-entity-decl-handler.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-310@lists.php.net to get a copy of this message
dams Mon Apr 28 11:47:14 2003 EDT Added files: /phpdoc-fr/reference/xml/functions xml-parser-create-ns.xml xml-set-end-namespace-decl-handler.xml xml-set-start-namespace-decl-handler.xml Modified files: /phpdoc-fr/reference/xml reference.xml /phpdoc-fr/reference/xml/functions utf8-decode.xml utf8-encode.xml xml-error-string.xml xml-get-current-byte-index.xml xml-get-error-code.xml xml-parse-into-struct.xml xml-parse.xml xml-parser-create.xml xml-parser-free.xml xml-parser-get-option.xml xml-parser-set-option.xml xml-set-character-data-handler.xml xml-set-default-handler.xml xml-set-element-handler.xml xml-set-external-entity-ref-handler.xml xml-set-notation-decl-handler.xml xml-set-object.xml xml-set-processing-instruction-handler.xml xml-set-unparsed-entity-decl-handler.xml Log: easy commit

Index: phpdoc-fr/reference/xml/reference.xml diff -u phpdoc-fr/reference/xml/reference.xml:1.2 phpdoc-fr/reference/xml/reference.xml:1.3 --- phpdoc-fr/reference/xml/reference.xml:1.2 Mon Apr 15 20:55:28 2002 +++ phpdoc-fr/reference/xml/reference.xml Mon Apr 28 11:47:14 2003 @@ -3,10 +3,8 @@ <title>Analyseur syntaxique XML</title> <titleabbrev>XML</titleabbrev> <partintro> - <section id="xml.partintro"> - <title>Introduction</title> <section id="xml.intro"> - <title>A propos de XML</title> + &reftitle.intro; <para> Le langage XML (eXtensible Markup Language (Langage &agrave; Balises Etendu)) est un format structur&eacute; de donn&eacute;es pour les @@ -15,48 +13,6 @@ du XML et des technologies aff&eacute;rentes sont accessibles (en anglais) <ulink url="&url.xml;">&url.xml;</ulink>. </para> - </section> - <section id="xml.install"> - <title>Installation</title> - <para> - Cette extension de PHP utilise <productname>expat</productname>, - disponible &agrave; <ulink url="&url.expat;">&url.expat;</ulink>. - Le fichier Makefile livr&eacute; avec <productname>expat</productname> - ne construit pas par d&eacute;faut de librairie : il faut utiliser - la ligne suivante : - <programlisting role="makefile"> -libexpat.a: $(OBJS) - ar -rc $@ $(OBJS) - ranlib $@ - </programlisting> - Les sources RPM de expat sont disponibles &agrave; - <ulink url="&url.expat.rpm;">&url.expat.rpm;</ulink>. - </para> - <para> - Notez que si vous utilisez Apache-1.3.7 ou plus r&eacute;cent, - vous disposez d&eacute;j&agrave; de la librairie expat. - Configurez simplement PHP avec - <link linkend="install.configure.with-xml"><option role="configure">--with-xml</option></link> - (sans aucun autre information) et la librairie expat d'Apache sera - automatiquement utilis&eacute;e. - </para> - <para> - Sous UNIX, lancez la configuration de PHP avec l'option - <link linkend="install.configure.with-xml"><option role="configure">--with-xml</option></link>, - la librairie <productname>expat</productname> &eacute;tant install&eacute;e - l&agrave; o&ugrave; votre compilateur peut la trouver. - Si vous compilez PHP comme module de PHP 1.3.9 ou plus r&eacute;cent, - PHP utilisera automatiquement le module <productname>expat</productname> - livr&eacute; avec Apache. Il vous faudra peut &ecirc;tre fixer - les valeurs des variables d'environnement <envar>CPPFLAGS</envar> - et <envar>LDFLAGS</envar>, si vous avez fait une installation exotique. - </para> - <para> - Compilez PHP. <emphasis>Tada!</emphasis> C'est fait ! - </para> - </section> - <section id="xml.about"> - <title>A propos de cette extension :</title> <para> Cette extension PHP supporte la librairie <productname>expat</productname> de James Clark sous PHP. Cela vous permettra d'analyser mais @@ -73,6 +29,52 @@ de quelques <link linkend="function.xml-parser-set-option">param&eacute;trages</link>. </para> + </section> + <section id="xml.requirements"> + &reftitle.required; + <para> + Cette extension de PHP utilise <productname>expat</productname>, + disponible &agrave; <ulink url="&url.expat;">&url.expat;</ulink>. + Le fichier Makefile livr&eacute; avec <productname>expat</productname> + ne construit pas par d&eacute;faut de librairie : il faut utiliser + la ligne suivante : + <programlisting role="makefile"> +<![CDATA[ +libexpat.a: $(OBJS) + ar -rc $@ $(OBJS) + ranlib $@ +]]> + </programlisting> + Les sources RPM de expat sont disponibles &agrave; + <ulink url="&url.expat.rpm;">&url.expat.rpm;</ulink>. + </para> + </section> + + &reference.xml.configure; + + <section id="xml.configuration"> + &reftitle.runtime; + &no.config; + </section> + + <section id="xml.resources"> + &reftitle.resources; + <section id="xml.resources.xml"> + <title><literal>xml</literal></title> + <para> + La ressource <literal>xml</literal> est retourn&eacute;e par + <function>xml_parser_create</function> et + <function>xml_parser_create_ns</function>, et repr&eacute;sente + un analysueur XML &agrave; utiliser avec les autres fonctions de l'extension. + </para> + </section> + </section> + + &reference.xml.constants; + + + <section id="xml.eventhandlers"> + <title>gestionnaires d'&eacute;v&egrave;nements</title> <para> Les gestionnaires d'&eacute;v&egrave;nements XML sont: <table> @@ -186,28 +188,28 @@ Les constantes suivantes sont d&eacute;finies comme des codes d'erreurs XML : (retourn&eacute;e par <function>xml_parse</function>) <simplelist> - <member>XML_ERROR_NONE</member> - <member>XML_ERROR_NO_MEMORY</member> - <member>XML_ERROR_SYNTAX</member> - <member>XML_ERROR_NO_ELEMENTS</member> - <member>XML_ERROR_INVALID_TOKEN</member> - <member>XML_ERROR_UNCLOSED_TOKEN</member> - <member>XML_ERROR_PARTIAL_CHAR</member> - <member>XML_ERROR_TAG_MISMATCH</member> - <member>XML_ERROR_DUPLICATE_ATTRIBUTE</member> - <member>XML_ERROR_JUNK_AFTER_DOC_ELEMENT</member> - <member>XML_ERROR_PARAM_ENTITY_REF</member> - <member>XML_ERROR_UNDEFINED_ENTITY</member> - <member>XML_ERROR_RECURSIVE_ENTITY_REF</member> - <member>XML_ERROR_ASYNC_ENTITY</member> - <member>XML_ERROR_BAD_CHAR_REF</member> - <member>XML_ERROR_BINARY_ENTITY_REF</member> - <member>XML_ERROR_ATTRIBUTE_EXTERNAL_ENTITY_REF</member> - <member>XML_ERROR_MISPLACED_XML_PI</member> - <member>XML_ERROR_UNKNOWN_ENCODING</member> - <member>XML_ERROR_INCORRECT_ENCODING</member> - <member>XML_ERROR_UNCLOSED_CDATA_SECTION</member> - <member>XML_ERROR_EXTERNAL_ENTITY_HANDLING</member> + <member><constant>XML_ERROR_NONE</constant></member> + <member><constant>XML_ERROR_NO_MEMORY</constant></member> + <member><constant>XML_ERROR_SYNTAX</constant></member> + <member><constant>XML_ERROR_NO_ELEMENTS</constant></member> + <member><constant>XML_ERROR_INVALID_TOKEN</constant></member> + <member><constant>XML_ERROR_UNCLOSED_TOKEN</constant></member> + <member><constant>XML_ERROR_PARTIAL_CHAR</constant></member> + <member><constant>XML_ERROR_TAG_MISMATCH</constant></member> + <member><constant>XML_ERROR_DUPLICATE_ATTRIBUTE</constant></member> + <member><constant>XML_ERROR_JUNK_AFTER_DOC_ELEMENT</constant></member> + <member><constant>XML_ERROR_PARAM_ENTITY_REF</constant></member> + <member><constant>XML_ERROR_UNDEFINED_ENTITY</constant></member> + <member><constant>XML_ERROR_RECURSIVE_ENTITY_REF</constant></member> + <member><constant>XML_ERROR_ASYNC_ENTITY</constant></member> + <member><constant>XML_ERROR_BAD_CHAR_REF</constant></member> + <member><constant>XML_ERROR_BINARY_ENTITY_REF</constant></member> + <member><constant>XML_ERROR_ATTRIBUTE_EXTERNAL_ENTITY_REF</constant></member> + <member><constant>XML_ERROR_MISPLACED_XML_PI</constant></member> + <member><constant>XML_ERROR_UNKNOWN_ENCODING</constant></member> + <member><constant>XML_ERROR_INCORRECT_ENCODING</constant></member> + <member><constant>XML_ERROR_UNCLOSED_CDATA_SECTION</constant></member> + <member><constant>XML_ERROR_EXTERNAL_ENTITY_HANDLING</constant></member> </simplelist> </para> </section> @@ -259,9 +261,8 @@ ult&eacute;rieurement). </para> </section> - </section> <section id="xml.examples"> - <title>Quelques exemples</title> + &reftitle.examples; <para> Voici une liste d'exemple de code PHP qui analyse un document XML. </para> @@ -273,96 +274,109 @@ <example> <title>Afficher une structure XML</title> <programlisting role="php"> -&lt;?php -$file = "data.xml"; +<![CDATA[ +<?php +$file = "donnees.xml"; $depth = array(); -function startElement($parser, $name, $attrs) { + +function debutElement($parser, $name, $attrs) { global $depth; - for ($i = 0; $i &lt; $depth[$parser]; $i++) { + for ($i = 0; $i < $depth[$parser]; $i++) { print " "; } print "$name\n"; $depth[$parser]++; } -function endElement($parser, $name) { + +function finElement($parser, $name) { global $depth; $depth[$parser]--; } + $xml_parser = xml_parser_create(); -xml_set_element_handler($xml_parser, "startElement", "endElement"); +xml_set_element_handler($xml_parser, "debutElement", "finElement"); if (!($fp = fopen($file, "r"))) { - die("could not open XML input"); + die("Impossible d'ouvrir le fichier XML"); } + while ($data = fread($fp, 4096)) { if (!xml_parse($xml_parser, $data, feof($fp))) { - die(sprintf("XML error: %s at line %d", + die(sprintf("erreur XML : %s &agrave; la ligne %d", xml_error_string(xml_get_error_code($xml_parser)), xml_get_current_line_number($xml_parser))); } } xml_parser_free($xml_parser); -?&gt; +?> +]]> </programlisting> </example> </para> </section> <section id="example.xml-map-tags"> - <title>XML Transtypage XML -> HTML</title> + <title>Transtypage XML -> HTML</title> <para> <example> - <title>XML Transtypage XML -> HTML</title> + <title>Transtypage XML -> HTML</title> <para> Cet exemple remplace les balises XML d'un document par des balises HTML. Les &eacute;l&eacute;ments inconnus seront ignor&eacute;s. Bien entendu, cet exemple sera appliqu&eacute; &agrave; un type pr&eacute;cis de fichiers XML. <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $file = "data.xml"; $map_array = array( - "BOLD" =&gt; "B", - "EMPHASIS" =&gt; "I", - "LITERAL" =&gt; "TT" + "BOLD" => "B", + "EMPHASIS" => "I", + "LITERAL" => "TT" ); + function startElement($parser, $name, $attrs) { global $map_array; if ($htmltag = $map_array[$name]) { - print "&lt;$htmltag&gt;"; + print "<$htmltag>"; } } + function endElement($parser, $name) { global $map_array; if ($htmltag = $map_array[$name]) { - print "&lt;/$htmltag&gt;"; + print "</$htmltag>"; } } + function characterData($parser, $data) { 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); +// Utilison la gestion de casse, de mani&egrave;re &agrave; &ecirc;tre sur de trouver la balise dans $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"); + die("Impossible de trouver le fichier XML"); } + while ($data = fread($fp, 4096)) { if (!xml_parse($xml_parser, $data, feof($fp))) { - die(sprintf("XML error: %s at line %d", + die(sprintf("erreur XML : %s &agrave; la ligne %d", xml_error_string(xml_get_error_code($xml_parser)), xml_get_current_line_number($xml_parser))); } } xml_parser_free($xml_parser); -?&gt; +?> +]]> </programlisting> </para> </example> </para> </section> <section id="example.xml-external-entity"> - <title>XML Entit&eacute; externe</title> + <title>Entit&eacute; externe</title> <para> Cet exemple exploite les r&eacute;f&eacute;rences externes de XML : il est possible d'utiliser un gestionnaire d'entit&eacute; externe @@ -380,32 +394,38 @@ <example> <title>Entit&eacute; externe</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $file = "xmltest.xml"; + function trustedFile($file) { // only trust local files owned by ourselves - if (!eregi("^([a-z]+)://", $file) - &amp;&amp; fileowner($file) == getmyuid()) { - return TRUE; + if (!eregi("^([a-z]+)://", $file) + && fileowner($file) == getmyuid()) { + return true; } - return FALSE; + return false; } + function startElement($parser, $name, $attribs) { - print "&amp;lt;&lt;font color=\"#0000cc\"&gt;$name&lt;/font&gt;"; + print "<<font color=\"#0000cc\">$name</font>"; if (sizeof($attribs)) { while (list($k, $v) = each($attribs)) { - print " &lt;font color=\"#009900\"&gt;$k&lt;/font&gt;=\"&lt;font - color=\"#990000\"&gt;$v&lt;/font&gt;\""; + print " <font color=\"#009900\">$k</font>=\"<font + color=\"#990000\">$v</font>\""; } } - print "&amp;gt;"; + print ">"; } + function endElement($parser, $name) { - print "&amp;lt;/&lt;font color=\"#0000cc\"&gt;$name&lt;/font&gt;&amp;gt;"; + print "</<font color=\"#0000cc\">$name</font>>"; } + function characterData($parser, $data) { - print "&lt;B&gt;$data&lt;/B&gt;"; + print "<b>$data</b>"; } + function PIHandler($parser, $target, $data) { switch (strtolower($target)) { case "php": @@ -416,45 +436,49 @@ if (trustedFile($parser_file[$parser])) { eval($data); } else { - printf("Code PHP peu s&ucirc;r : &lt;B&gt;%s&lt;/B&gt;", + printf("Untrusted PHP code: <i>%s</i>", htmlspecialchars($data)); } break; } } + function defaultHandler($parser, $data) { - if (substr($data, 0, 1) == "&amp;" &amp;&amp; substr($data, -1, 1) == ";") { - printf('&lt;font color="#aa00aa"&gt;%s&lt;/font&gt;', + if (substr($data, 0, 1) == "&" && substr($data, -1, 1) == ";") { + printf('<font color="#aa00aa">%s</font>', htmlspecialchars($data)); } else { - printf('&lt;font size="-1"&gt;%s&lt;/font&gt;', + printf('<font size="-1">%s</font>', htmlspecialchars($data)); } } + function externalEntityRefHandler($parser, $openEntityNames, $base, $systemId, $publicId) { if ($systemId) { if (!list($parser, $fp) = new_xml_parser($systemId)) { printf("Could not open entity %s at %s\n", $openEntityNames, $systemId); - return FALSE; + 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", + printf("erreur XML : %s &agrave; la ligne %d lors de l'analyse de l'entit&eacute; %s\n", xml_error_string(xml_get_error_code($parser)), xml_get_current_line_number($parser), $openEntityNames); xml_parser_free($parser); - return FALSE; + return false; } } xml_parser_free($parser); - return TRUE; + return true; } - return FALSE; + return false; } + 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"); @@ -462,8 +486,9 @@ 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 = @fopen($file, "r"))) { - return FALSE; + return false; } if (!is_array($parser_file)) { settype($parser_file, "array"); @@ -471,21 +496,25 @@ $parser_file[$xml_parser] = $file; return array($xml_parser, $fp); } + if (!(list($xml_parser, $fp) = new_xml_parser($file))) { - die("could not open XML input"); + die("Impossible d'ouvrir le fichier XML"); } -print "&lt;pre&gt;"; + +print "<pre>"; while ($data = fread($fp, 4096)) { if (!xml_parse($xml_parser, $data, feof($fp))) { - die(sprintf("XML error: %s at line %d\n", + die(sprintf("Erreur XML : %s &agrave; la ligne %d\n", xml_error_string(xml_get_error_code($xml_parser)), xml_get_current_line_number($xml_parser))); } } -print "&lt;/pre&gt;"; +print "</pre>"; print "parse complete\n"; xml_parser_free($xml_parser); -?&gt; + +?> +]]> </programlisting> </example> </para> @@ -493,33 +522,35 @@ <example> <title>xmltest.xml</title> <programlisting role="xml"> -&lt;?xml version='1.0'?&gt; -&lt;!DOCTYPE chapter SYSTEM "/just/a/test.dtd" [ -&lt;!ENTITY plainEntity "FOO entity"&gt; -&lt;!ENTITY systemEntity SYSTEM "xmltest2.xml"&gt; -]&gt; -&lt;chapter&gt; - &lt;TITLE&gt;Title &amp;plainEntity;&lt;/TITLE&gt; - &lt;para&gt; - &lt;informaltable&gt; - &lt;tgroup cols="3"&gt; - &lt;tbody&gt; - &lt;row&gt;&lt;entry&gt;a1&lt;/entry&gt;&lt;entry morerows="1"&gt;b1&lt;/entry&gt;&lt;entry&gt;c1&lt;/entry&gt;&lt;/row&gt; - &lt;row&gt;&lt;entry&gt;a2&lt;/entry&gt;&lt;entry&gt;c2&lt;/entry&gt;&lt;/row&gt; - &lt;row&gt;&lt;entry&gt;a3&lt;/entry&gt;&lt;entry&gt;b3&lt;/entry&gt;&lt;entry&gt;c3&lt;/entry&gt;&lt;/row&gt; - &lt;/tbody&gt; - &lt;/tgroup&gt; - &lt;/informaltable&gt; - &lt;/para&gt; - &amp;systemEntity; - &lt;sect1 id="about"&gt; - &lt;title&gt;About this Document&lt;/title&gt; - &lt;para&gt; - &lt;!-- this is a comment --&gt; - &lt;?php print 'Hi! This is PHP version '.phpversion(); ?&gt; - &lt;/para&gt; - &lt;/sect1&gt; -&lt;/chapter&gt; +<![CDATA[ +<?xml version='1.0'?> +<!DOCTYPE chapter SYSTEM "/just/a/test.dtd" [ +<!ENTITY plainEntity "FOO entity"> +<!ENTITY systemEntity SYSTEM "xmltest2.xml"> +]> +<chapter> + <TITLE>Title &plainEntity;</TITLE> + <para> + <informaltable> + <tgroup cols="3"> + <tbody> + <row><entry>a1</entry><entry morerows="1">b1</entry><entry>c1</entry></row> + <row><entry>a2</entry><entry>c2</entry></row> + <row><entry>a3</entry><entry>b3</entry><entry>c3</entry></row> + </tbody> + </tgroup> + </informaltable> + </para> + &systemEntity; + <section id="about"> + <title>About this Document</title> + <para> + <!-- Ceci est un commentaire --> + <?php print 'Salut! Ceci est PHP version '.phpversion(); ?> + </para> + </section> +</chapter> +]]> </programlisting> </example> </para> @@ -528,15 +559,17 @@ <example> <title>xmltest2.xml</title> <programlisting role="xml"> -&lt;?xml version="1.0" ?&gt; -&lt;!DOCTYPE foo [ -&lt;!ENTITY testEnt "test entity"&gt; -?&gt; -&lt;foo&gt; - &lt;element attrib="value"?&gt; - &amp;testEnt; - &lt;?php print "This is some more PHP code being executed."; ?&gt; -&lt;/foo&gt; +<![CDATA[ +<?xml version="1.0"?> +<!DOCTYPE foo [ +<!ENTITY testEnt "test entity"> +]> +<foo> + <element attrib="value"/> + &testEnt; + <?php print "Ceci est du code PHP qui est ex&eacute;cut&eacute;."; ?> +</foo> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/xml/functions/utf8-decode.xml diff -u phpdoc-fr/reference/xml/functions/utf8-decode.xml:1.1 phpdoc-fr/reference/xml/functions/utf8-decode.xml:1.2 --- phpdoc-fr/reference/xml/functions/utf8-decode.xml:1.1 Sun Apr 14 20:39:59 2002 +++ phpdoc-fr/reference/xml/functions/utf8-decode.xml Mon Apr 28 11:47:14 2003 @@ -4,7 +4,7 @@ <refentry id="function.utf8-decode"> <refnamediv> <refname>utf8_decode</refname> - <refpurpose>Convertit une cha&icirc;ne UTF-8 en ISO-8859.</refpurpose> + <refpurpose>Convertit une cha&icirc;ne UTF-8 en ISO-8859</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -19,8 +19,9 @@ <literal>ISO-8859-1</literal>. </para> <para> - Voir aussi <function>utf8_encode</function>pour plus de - d&eacute;tails sur le codage <literal>UTF-8</literal>. + Voir aussi + <function>utf8_encode</function> + pour plus de d&eacute;tails sur le codage <literal>UTF-8</literal>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/xml/functions/utf8-encode.xml diff -u phpdoc-fr/reference/xml/functions/utf8-encode.xml:1.1 phpdoc-fr/reference/xml/functions/utf8-encode.xml:1.2 --- phpdoc-fr/reference/xml/functions/utf8-encode.xml:1.1 Sun Apr 14 20:39:59 2002 +++ phpdoc-fr/reference/xml/functions/utf8-encode.xml Mon Apr 28 11:47:14 2003 @@ -4,7 +4,7 @@ <refentry id="function.utf8-encode"> <refnamediv> <refname>utf8_encode</refname> - <refpurpose>Convertit une cha&icirc;ne ISO-8859-1 en UTF-8.</refpurpose> + <refpurpose>Convertit une cha&icirc;ne ISO-8859-1 en UTF-8</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -17,10 +17,10 @@ <literal>UTF-8</literal>, et retourne la version cod&eacute;e. <literal>UTF-8</literal> est un m&eacute;canisme standardis&eacute; utilis&eacute; par Unicode pour coder les caract&egrave;re de grande - taille dans des flots d'octets. <literal>UTF-8</literal> est transparent + taille dans des fl&ocirc;ts d'octets. <literal>UTF-8</literal> est transparent pour les caract&egrave;res <abbrev>ASCII</abbrev>, il est auto-synchronis&eacute; (c'est &agrave; - dire qu'un programme peut toujours savoir dans un flot d'octet o&ugrave; + dire qu'un programme peut toujours savoir dans un fl&ocirc;t d'octet o&ugrave; un caract&egrave;re commence), et peut &ecirc;tre utilis&eacute; pour faire des comparaisons de cha&icirc;nes standard, comme pour le tri. PHP utilise l'<literal>UTF-8</literal> pour coder les caract&egrave;res Index: phpdoc-fr/reference/xml/functions/xml-error-string.xml diff -u phpdoc-fr/reference/xml/functions/xml-error-string.xml:1.2 phpdoc-fr/reference/xml/functions/xml-error-string.xml:1.3 --- phpdoc-fr/reference/xml/functions/xml-error-string.xml:1.2 Tue Aug 13 22:19:35 2002 +++ phpdoc-fr/reference/xml/functions/xml-error-string.xml Mon Apr 28 11:47:14 2003 @@ -4,7 +4,7 @@ <refentry id="function.xml-error-string"> <refnamediv> <refname>xml_error_string</refname> - <refpurpose>Lit le message d'erreur de l'analyseur XML.</refpurpose> + <refpurpose>Lit le message d'erreur de l'analyseur XML</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/xml/functions/xml-get-current-byte-index.xml diff -u phpdoc-fr/reference/xml/functions/xml-get-current-byte-index.xml:1.2 phpdoc-fr/reference/xml/functions/xml-get-current-byte-index.xml:1.3 --- phpdoc-fr/reference/xml/functions/xml-get-current-byte-index.xml:1.2 Tue Aug 13 22:19:35 2002 +++ phpdoc-fr/reference/xml/functions/xml-get-current-byte-index.xml Mon Apr 28 11:47:14 2003 @@ -4,7 +4,7 @@ <refentry id="function.xml-get-current-byte-index"> <refnamediv> <refname>xml_get_current_byte_index</refname> - <refpurpose>Retourne l'index de l'octet courant d'un analyseur XML.</refpurpose> + <refpurpose>Retourne l'index de l'octet courant d'un analyseur XML</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/xml/functions/xml-get-error-code.xml diff -u phpdoc-fr/reference/xml/functions/xml-get-error-code.xml:1.1 phpdoc-fr/reference/xml/functions/xml-get-error-code.xml:1.2 --- phpdoc-fr/reference/xml/functions/xml-get-error-code.xml:1.1 Sun Apr 14 20:40:01 2002 +++ phpdoc-fr/reference/xml/functions/xml-get-error-code.xml Mon Apr 28 11:47:14 2003 @@ -4,7 +4,7 @@ <refentry id="function.xml-get-error-code"> <refnamediv> <refname>xml_get_error_code</refname> - <refpurpose>Retourne le nombre courant de colonne d'un analyseur XML.</refpurpose> + <refpurpose>Retourne le nombre courant de colonne d'un analyseur XML</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -13,7 +13,7 @@ <methodparam><type>resource</type><parameter>parser</parameter></methodparam> </methodsynopsis> <para> - <function>xml_get_error_code</function> retourne <literal>FALSE</literal> + <function>xml_get_error_code</function> retourne &false; si <parameter>parser</parameter> n'est pas valide, ou sinon, retourne le num&eacute;ro de colonne courante de la ligne courante de l'analyseur, qui correspond &agrave; la position d'analyse courante de l'analyseur XML. Index: phpdoc-fr/reference/xml/functions/xml-parse-into-struct.xml diff -u phpdoc-fr/reference/xml/functions/xml-parse-into-struct.xml:1.1 phpdoc-fr/reference/xml/functions/xml-parse-into-struct.xml:1.2 --- phpdoc-fr/reference/xml/functions/xml-parse-into-struct.xml:1.1 Sun Apr 14 20:40:01 2002 +++ phpdoc-fr/reference/xml/functions/xml-parse-into-struct.xml Mon Apr 28 11:47:14 2003 @@ -8,13 +8,13 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>xml_parse_into_struct</methodname> - <methodparam><type>resource</type><parameter>parser</parameter></methodparam> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam><type>array</type><parameter>&amp;values</parameter></methodparam> - <methodparam><type>array</type><parameter>&amp;index</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>int</type><methodname>xml_parse_into_struct</methodname> + <methodparam><type>resource</type><parameter>parser</parameter></methodparam> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + <methodparam><type>array</type><parameter>&amp;values</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>&amp;index</parameter></methodparam> + </methodsynopsis> <para> <function>xml_parse_into_struct</function> analyse le fichier XML <parameter>data</parameter>, et le place dans deux tableaux : @@ -31,59 +31,68 @@ affiche la structure g&eacute;n&eacute;r&eacute;e : <informalexample> <programlisting role="php"> -&lt;?php -$simple = &quot;&lt;para&gt;&lt;note&gt;simple note&lt;/note&gt;&lt;/para&gt;&quot;; -$p = xml_parser_create(); -xml_parse_into_struct($p,$simple,$vals,$index); -xml_parser_free($p); -echo "Tableau d'index\n"; -print_r($index); -echo "\nTableau de valeurs\n"; -print_r($vals); -?&gt; +<![CDATA[ +<?php + $simple = "<para><note>Simple Note</note></para>"; + $p = xml_parser_create(); + xml_parse_into_struct($p,$simple,$vals,$index); + xml_parser_free($p); + echo "Tableau d'index \n"; + print_r($index); + echo "\nTableau de valeurs \n"; + print_r($vals); +?> +]]> </programlisting> </informalexample> Lors de l'&eacute;x&eacute;cution du code, l'affichage sera : <informalexample> <literallayout> <computeroutput> -Tableau d'index +<![CDATA[ +Tableau d'index Array ( - [PARA] =&gt; Array + [PARA] => Array ( - [0] =&gt; 0 - [1] =&gt; 2 + [0] => 0 + [1] => 2 ) - [NOTE] =&gt; Array + + [NOTE] => Array ( - [0] =&gt; 1 + [0] => 1 ) + ) -Tableau de valeurs + +Tableau de valeurs Array ( - [0] =&gt; Array + [0] => Array ( - [tag] =&gt; PARA - [type] =&gt; open - [level] =&gt; 1 + [tag] => PARA + [type] => open + [level] => 1 ) - [1] =&gt; Array + + [1] => Array ( - [tag] =&gt; NOTE - [type] =&gt; complete - [level] =&gt; 2 - [value] =&gt; simple note + [tag] => NOTE + [type] => complete + [level] => 2 + [value] => Simple Note ) - [2] =&gt; Array + + [2] => Array ( - [tag] =&gt; PARA - [type] =&gt; close - [level] =&gt; 1 + [tag] => PARA + [type] => close + [level] => 1 ) + ) - </computeroutput> +]]> </computeroutput> </literallayout> </informalexample> </para> @@ -98,21 +107,26 @@ <example> <title>moldb.xml - Petite base de donn&eacute;es mol&eacute;culaire</title> <programlisting role="xml"> -&lt;?xml version=&quot;1.0&quot;?&gt; -&lt;moldb&gt; - &lt;molecule&gt; - &lt;name&gt;Alanine&lt;/name&gt; - &lt;symbol&gt;ala&lt;/symbol&gt; - &lt;code&gt;A&lt;/code&gt; - &lt;type&gt;hydrophobic&lt;/type&gt; - &lt;/molecule&gt; - &lt;molecule&gt; - &lt;name&gt;Lysine&lt;/name&gt; - &lt;symbol&gt;lys&lt;/symbol&gt; - &lt;code&gt;K&lt;/code&gt; - &lt;type&gt;charged&lt;/type&gt; - &lt;/molecule&gt; -&lt;/moldb&gt; +<![CDATA[ +<?xml version="1.0"?> +<moldb> + + <molecule> + <name>Alanine</name> + <symbol>ala</symbol> + <code>A</code> + <type>hydrophobic</type> + </molecule> + + <molecule> + <name>Lysine</name> + <symbol>lys</symbol> + <code>K</code> + <type>charged</type> + </molecule> + +</moldb> +]]> </programlisting> </example> Et maitenant, un code qui analyse le document, et g&eacute;n&egrave;re les @@ -123,32 +137,37 @@ d'objet mol&eacute;culaires </title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php + class AminoAcid { - var $name; // nom de l'amino acide - var $symbol; // symbole en trois lettres - var $code; // code en une lettre - var $type; // hydrophobe, charg&eacute; ou neutre + var $name; // aa name + var $symbol; // three letter symbol + var $code; // one letter code + var $type; // hydrophobic, charged or neutral + function AminoAcid ($aa) { - foreach ($aa as $k-&gt;$v) - $this-&gt;$k = $aa[$k]; + foreach ($aa as $k=>$v) + $this->$k = $aa[$k]; } } + function readDatabase($filename) { // read the xml database of aminoacids - $data = implode(&quot;&quot;,file($filename)); + $data = implode("",file($filename)); $parser = xml_parser_create(); xml_parser_set_option($parser,XML_OPTION_CASE_FOLDING,0); xml_parser_set_option($parser,XML_OPTION_SKIP_WHITE,1); - xml_parse_into_struct($parser,$data,&amp;$values,&amp;$tags); + xml_parse_into_struct($parser,$data,$values,$tags); xml_parser_free($parser); - // parcourt les structures - foreach ($tags as $key-&gt;$val) { - if ($key == &quot;molecule&quot;) { + + // loop through the structures + foreach ($tags as $key=>$val) { + if ($key == "molecule") { $molranges = $val; - // chaque paire contigue sont les d&eacute;finitions sup&eacute;rieures - // et inf&eacute;rieures de la mol&eacute;cule - for ($i=0; $i &lt; count($molranges); $i+=2) { + // each contiguous pair of array entries are the + // lower and upper range for each molecule definition + for ($i=0; $i < count($molranges); $i+=2) { $offset = $molranges[$i] + 1; $len = $molranges[$i + 1] - $offset; $tdb[] = parseMol(array_slice($values, $offset, $len)); @@ -159,44 +178,50 @@ } return $tdb; } + function parseMol($mvalues) { - for ($i=0; $i &lt; count($mvalues); $i++) - $mol[$mvalues[$i][&quot;tag&quot;]] = $mvalues[$i][&quot;value&quot;]; + for ($i=0; $i < count($mvalues); $i++) + $mol[$mvalues[$i]["tag"]] = $mvalues[$i]["value"]; return new AminoAcid($mol); } -$db = readDatabase(&quot;moldb.xml&quot;); + +$db = readDatabase("moldb.xml"); echo "** Database of AminoAcid objects:\n"; print_r($db); -?&gt; + +?> +]]> </programlisting> </example> Apr&egrave;s ex&eacute;cution de <filename>parsemoldb.php</filename>, la variable <varname>$db</varname> contient un tableau d'objets <classname>AminoAcid</classname>, et l'affichage le confirme : - <informalexample> - <literallayout> - <computeroutput> + <informalexample> + <screen> +<![CDATA[ ** Database of AminoAcid objects: Array ( - [0] =&gt; aminoacid Object + [0] => aminoacid Object ( - [name] =&gt; Alanine - [symbol] =&gt; ala - [code] =&gt; A - [type] =&gt; hydrophobic - ) - [1] =&gt; aminoacid Object - ( - [name] =&gt; Lysine - [symbol] =&gt; lys - [code] =&gt; K - [type] =&gt; charged + [name] => Alanine + [symbol] => ala + [code] => A + [type] => hydrophobic + ) + + [1] => aminoacid Object + ( + [name] => Lysine + [symbol] => lys + [code] => K + [type] => charged ) + ) - </computeroutput> - </literallayout> - </informalexample> +]]> + </screen> + </informalexample> </para> </refsect1> </refentry> Index: phpdoc-fr/reference/xml/functions/xml-parse.xml diff -u phpdoc-fr/reference/xml/functions/xml-parse.xml:1.2 phpdoc-fr/reference/xml/functions/xml-parse.xml:1.3 --- phpdoc-fr/reference/xml/functions/xml-parse.xml:1.2 Tue Aug 13 22:19:35 2002 +++ phpdoc-fr/reference/xml/functions/xml-parse.xml Mon Apr 28 11:47:14 2003 @@ -4,16 +4,16 @@ <refentry id="function.xml-parse"> <refnamediv> <refname>xml_parse</refname> - <refpurpose>Commence l'analyse d'un fichier XML.</refpurpose> + <refpurpose>Commence l'analyse d'un fichier XML</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>xml_parse</methodname> - <methodparam><type>resource</type><parameter>parser</parameter></methodparam> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>isFinal</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>xml_parse</methodname> + <methodparam><type>resource</type><parameter>parser</parameter></methodparam> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>is_final</parameter></methodparam> + </methodsynopsis> <para> <variablelist> <varlistentry> @@ -31,13 +31,13 @@ Une partie des donn&eacute;es &agrave; analyser. Un document peut &ecirc;tre analys&eacute; morceau par morceau, en appelant <function>xml_parse</function> plusieurs fois, tant que le - param&egrave;tre <parameter>isFinal</parameter> est mis &agrave; + param&egrave;tre <parameter>isfinal</parameter> est mis &agrave; &true; pour le dernier morceau. </simpara> </listitem> </varlistentry> <varlistentry> - <term><parameter>isFinal</parameter> (optional)</term> + <term><parameter>isfinal</parameter> (optional)</term> <listitem> <simpara> S'il vaut &true;, <parameter>data</parameter> est la derni&egrave;re partie @@ -50,7 +50,7 @@ <para> Lorsqu'un document XML est analys&eacute;, les gestionnaires d'&eacute;v&eacute;nements sont appel&eacute;s aussi souvent que - n&eacute;cessaire, et retournent &true; ou <literal>FALSE</literal>. + n&eacute;cessaire, et retournent &true; ou &false;. </para> <para> &true; est retourn&eacute; lorsque l'analyse a &eacute;t&eacute; concluante, Index: phpdoc-fr/reference/xml/functions/xml-parser-create.xml diff -u phpdoc-fr/reference/xml/functions/xml-parser-create.xml:1.2 phpdoc-fr/reference/xml/functions/xml-parser-create.xml:1.3 --- phpdoc-fr/reference/xml/functions/xml-parser-create.xml:1.2 Tue Aug 13 22:19:35 2002 +++ phpdoc-fr/reference/xml/functions/xml-parser-create.xml Mon Apr 28 11:47:14 2003 @@ -4,7 +4,7 @@ <refentry id="function.xml-parser-create"> <refnamediv> <refname>xml_parser_create</refname> - <refpurpose>Cr&eacute;ation d'un analyseur XML.</refpurpose> + <refpurpose>Cr&eacute;ation d'un analyseur XML</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -13,12 +13,17 @@ <methodparam choice="opt"><type>string</type><parameter>encoding</parameter></methodparam> </methodsynopsis> <para> + <function>xml_parser_create</function> cr&eacute;e un analyseur XML et + retourne une r&eacute;f&eacute;rence sur cet analyseur pour qu'il puisse + &ecirc;tre utilis&eacute; ult&eacute;rieurement par d'autres + fonctions XML. <function>xml_parser_create</function> retourne + &false;en cas d'erreur. <variablelist> <varlistentry> - <term><parameter>encoding</parameter> (optional)</term> + <term><parameter>encoding</parameter> (optionnel)</term> <listitem> <para> - Le codage de caract&egrave;re de l'analyseur : les codages suivants + Le codage de caract&egrave;re de l'analyseur. Les codages suivants sont support&eacute;s : <simplelist> <member><literal>ISO-8859-1</literal> (par d&eacute;faut)</member> @@ -29,11 +34,11 @@ </listitem> </varlistentry> </variablelist> - <function>xml_parser_create</function> cr&eacute;e un analyseur XML et - retourne une r&eacute;f&eacute;rence sur cet analyseur pour qu'il puisse - &ecirc;tre utilis&eacute; ult&eacute;rieurement par d'autres - fonctions XML. <function>xml_parser_create</function> retourne - &false;en cas d'erreur. + </para> + <para> + Voir aussi + <function>xml_parser_create_ns</function> et + <function>xml_parser_free</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/xml/functions/xml-parser-free.xml diff -u phpdoc-fr/reference/xml/functions/xml-parser-free.xml:1.2 phpdoc-fr/reference/xml/functions/xml-parser-free.xml:1.3 --- phpdoc-fr/reference/xml/functions/xml-parser-free.xml:1.2 Tue Aug 13 22:19:35 2002 +++ phpdoc-fr/reference/xml/functions/xml-parser-free.xml Mon Apr 28 11:47:14 2003 @@ -4,12 +4,12 @@ <refentry id="function.xml-parser-free"> <refnamediv> <refname>xml_parser_free</refname> - <refpurpose> D&eacute;truit un analyseur XML.</refpurpose> + <refpurpose> D&eacute;truit un analyseur XML</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>xml_parser_free</methodname> + <type>bool</type><methodname>xml_parser_free</methodname> <methodparam><type>resource</type><parameter>parser</parameter></methodparam> </methodsynopsis> <para> @@ -25,7 +25,7 @@ </variablelist> </para> <para> - <function>xml_parser_free</function> retourne <literal>FALSE</literal> + <function>xml_parser_free</function> retourne &false; si <parameter>parser</parameter> n'est pas une r&eacute;f&eacute;rence valide, ou sinon, d&eacute;truit l'analyseur et retourne &true;. </para> Index: phpdoc-fr/reference/xml/functions/xml-parser-get-option.xml diff -u phpdoc-fr/reference/xml/functions/xml-parser-get-option.xml:1.2 phpdoc-fr/reference/xml/functions/xml-parser-get-option.xml:1.3 --- phpdoc-fr/reference/xml/functions/xml-parser-get-option.xml:1.2 Tue Aug 13 22:19:35 2002 +++ phpdoc-fr/reference/xml/functions/xml-parser-get-option.xml Mon Apr 28 11:47:14 2003 @@ -4,7 +4,7 @@ <refentry id="function.xml-parser-get-option"> <refnamediv> <refname>xml_parser_get_option</refname> - <refpurpose>Lit les options d'un analyseur XML.</refpurpose> + <refpurpose>Lit les options d'un analyseur XML</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/xml/functions/xml-parser-set-option.xml diff -u phpdoc-fr/reference/xml/functions/xml-parser-set-option.xml:1.2 phpdoc-fr/reference/xml/functions/xml-parser-set-option.xml:1.3 --- phpdoc-fr/reference/xml/functions/xml-parser-set-option.xml:1.2 Tue Aug 13 22:19:35 2002 +++ phpdoc-fr/reference/xml/functions/xml-parser-set-option.xml Mon Apr 28 11:47:14 2003 @@ -4,16 +4,16 @@ <refentry id="function.xml-parser-set-option"> <refnamediv> <refname>xml_parser_set_option</refname> - <refpurpose>Affecte les options d'un analyseur XML.</refpurpose> + <refpurpose>Affecte les options d'un analyseur XML</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>xml_parser_set_option</methodname> - <methodparam><type>resource</type><parameter>parser</parameter></methodparam> - <methodparam><type>int</type><parameter>option</parameter></methodparam> - <methodparam><type>mixed</type><parameter>value</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>xml_parser_set_option</methodname> + <methodparam><type>resource</type><parameter>parser</parameter></methodparam> + <methodparam><type>int</type><parameter>option</parameter></methodparam> + <methodparam><type>mixed</type><parameter>value</parameter></methodparam> + </methodsynopsis> <para> <variablelist> <varlistentry> @@ -43,7 +43,7 @@ </variablelist> </para> <para> - <function>xml_parser_set_option</function> retourne <literal>FALSE</literal> + <function>xml_parser_set_option</function> retourne &false; si <parameter>parser</parameter> n'est pas une r&eacute;f&eacute;rence valide sur un analyseur XML, ou si l'option n'a pas pu &ecirc;tre modifi&eacute;e. Sinon, l'option est effectivement modifi&eacute;e, et la fonction retourne @@ -63,7 +63,7 @@ </thead> <tbody> <row> - <entry>XML_OPTION_CASE_FOLDING</entry> + <entry><constant>XML_OPTION_CASE_FOLDING</constant></entry> <entry>entier</entry> <entry> Contr&ocirc;le la gestion de la <link linkend="xml.case-folding">casse</link> @@ -71,7 +71,7 @@ </entry> </row> <row> - <entry>XML_OPTION_TARGET_ENCODING</entry> + <entry><constant>XML_OPTION_TARGET_ENCODING</constant></entry> <entry>string</entry> <entry> Modifie le <link linkend="xml.encoding">codage &agrave; la cible</link> Index: phpdoc-fr/reference/xml/functions/xml-set-character-data-handler.xml diff -u phpdoc-fr/reference/xml/functions/xml-set-character-data-handler.xml:1.2 phpdoc-fr/reference/xml/functions/xml-set-character-data-handler.xml:1.3 --- phpdoc-fr/reference/xml/functions/xml-set-character-data-handler.xml:1.2 Tue Aug 13 22:19:35 2002 +++ phpdoc-fr/reference/xml/functions/xml-set-character-data-handler.xml Mon Apr 28 11:47:14 2003 @@ -4,29 +4,30 @@ <refentry id="function.xml-set-character-data-handler"> <refnamediv> <refname>xml_set_character_data_handler</refname> - <refpurpose>Affecte les gestionnaires de caract&egrave;re bruts.</refpurpose> + <refpurpose>Affecte les gestionnaires de texte litt&eacute;ral</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>xml_set_character_data_handler</methodname> - <methodparam><type>resource</type><parameter>parser</parameter></methodparam> - <methodparam><type>string</type><parameter>handler</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>xml_set_character_data_handler</methodname> + <methodparam><type>resource</type><parameter>parser</parameter></methodparam> + <methodparam><type>callback</type><parameter>handler</parameter></methodparam> + </methodsynopsis> <para> - Affecte les gestionnaires de d&eacute;but et de fin de l'analyseur XML + <function>xml_set_character_data_handler</function> + affecte les gestionnaires de d&eacute;but et de fin de l'analyseur XML <parameter>parser</parameter>. <parameter>handler</parameter> est une cha&icirc;ne qui contient le nom d'une fonction qui existe lorsque <function>xml_parse</function> est appel&eacute; pour cr&eacute;er <parameter>parser</parameter>. </para> <para> - La fonction <parameter>handler</parameter> doit accepter deux param&egrave;tres: - <methodsynopsis> - <methodname><replaceable>handler</replaceable></methodname> - <methodparam><type>resource</type><parameter>parser</parameter></methodparam> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - </methodsynopsis> + La fonction <parameter>handler</parameter> doit accepter deux param&egrave;tres : + <methodsynopsis> + <methodname><replaceable>handler</replaceable></methodname> + <methodparam><type>resource</type><parameter>parser</parameter></methodparam> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + </methodsynopsis> <variablelist> <varlistentry> <term><parameter>parser</parameter></term> @@ -49,7 +50,7 @@ </variablelist> </para> <para> - Si un gestionnaire re&ccedil;oit une cha&icirc;ne vide ou <literal>FALSE</literal>, c'est + Si un gestionnaire re&ccedil;oit une cha&icirc;ne vide ou &false;, c'est qu'il est en train d'&ecirc;tre d&eacute;sactiv&eacute;. </para> <para> @@ -58,11 +59,7 @@ &false;sinon, ou si <parameter>parser</parameter> n'est pas un analyseur. </para> - <para> - Il n'est pas pour l'instant possible d'utiliser des objets pour servir de - gestionnaire. Reportez-vous &agrave; <function>xml_set_object</function> pour - utiliser l'analyseur XML depuis un objet. - </para> + &note.func-callback; </refsect1> </refentry> Index: phpdoc-fr/reference/xml/functions/xml-set-default-handler.xml diff -u phpdoc-fr/reference/xml/functions/xml-set-default-handler.xml:1.2 phpdoc-fr/reference/xml/functions/xml-set-default-handler.xml:1.3 --- phpdoc-fr/reference/xml/functions/xml-set-default-handler.xml:1.2 Tue Aug 13 22:19:35 2002 +++ phpdoc-fr/reference/xml/functions/xml-set-default-handler.xml Mon Apr 28 11:47:14 2003 @@ -4,17 +4,18 @@ <refentry id="function.xml-set-default-handler"> <refnamediv> <refname>xml_set_default_handler</refname> - <refpurpose>Affecte le gestionnaire par d&eacute;faut.</refpurpose> + <refpurpose>Affecte le gestionnaire XML par d&eacute;faut</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>xml_set_default_handler</methodname> - <methodparam><type>resource</type><parameter>parser</parameter></methodparam> - <methodparam><type>string</type><parameter>handler</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>xml_set_default_handler</methodname> + <methodparam><type>resource</type><parameter>parser</parameter></methodparam> + <methodparam><type>callback</type><parameter>handler</parameter></methodparam> + </methodsynopsis> <para> - Affecte le gestionnaire par d&eacute;faut de l'analyseur XML + <function>xml_set_default_handler</function> + affecte le gestionnaire par d&eacute;faut de l'analyseur XML <parameter>parser</parameter>. <parameter>handler</parameter> est une cha&icirc;ne qui contient le nom d'une fonction qui existe lorsque <function>xml_parse</function> est appel&eacute; pour cr&eacute;er @@ -22,11 +23,11 @@ </para> <para> La fonction <parameter>handler</parameter> doit accepter deux param&egrave;tres: - <methodsynopsis> - <methodname><replaceable>handler</replaceable></methodname> - <methodparam><type>resource</type><parameter>parser</parameter></methodparam> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <methodname><replaceable>handler</replaceable></methodname> + <methodparam><type>resource</type><parameter>parser</parameter></methodparam> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + </methodsynopsis> <variablelist> <varlistentry> <term> @@ -55,7 +56,7 @@ </variablelist> </para> <para> - Si un gestionnaire re&ccedil;oit une cha&icirc;ne vide ou <literal>FALSE</literal>, c'est + Si un gestionnaire re&ccedil;oit une cha&icirc;ne vide ou &false;, c'est qu'il est en train d'&ecirc;tre d&eacute;sactiv&eacute;. </para> <para> @@ -69,6 +70,7 @@ gestionnaire. Reportez-vous &agrave; <function>xml_set_object</function> pour utiliser l'analyseur XML depuis un objet. </para> + &note.func-callback; </refsect1> </refentry> Index: phpdoc-fr/reference/xml/functions/xml-set-element-handler.xml diff -u phpdoc-fr/reference/xml/functions/xml-set-element-handler.xml:1.2 phpdoc-fr/reference/xml/functions/xml-set-element-handler.xml:1.3 --- phpdoc-fr/reference/xml/functions/xml-set-element-handler.xml:1.2 Tue Aug 13 22:19:35 2002 +++ phpdoc-fr/reference/xml/functions/xml-set-element-handler.xml Mon Apr 28 11:47:14 2003 @@ -4,34 +4,34 @@ <refentry id="function.xml-set-element-handler"> <refnamediv> <refname>xml_set_element_handler</refname> - <refpurpose>Affecte les gestionnaires de d&eacute;but et de fin.</refpurpose> + <refpurpose>Affecte les gestionnaires de d&eacute;but et de fin de balise XML</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>xml_set_element_handler</methodname> - <methodparam><type>resource</type><parameter>parser</parameter></methodparam> - <methodparam><type>string</type><parameter>startElementHandler</parameter></methodparam> - <methodparam><type>string</type><parameter>endElementHandler</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>xml_set_element_handler</methodname> + <methodparam><type>resource</type><parameter>parser</parameter></methodparam> + <methodparam><type>callback</type><parameter>start_element_handler</parameter></methodparam> + <methodparam><type>callback</type><parameter>end_element_handler</parameter></methodparam> + </methodsynopsis> <para> <function>xml_set_element_handler</function> affecte les gestionnaires de d&eacute;but et de fin de l'analyseur XML - <parameter>parser</parameter>. <parameter>startElementHandler</parameter> - et <parameter>endElementHandler</parameter> sont des cha&icirc;nes qui + <parameter>parser</parameter>. <parameter>startelementhandler</parameter> + et <parameter>endelementhandler</parameter> sont des cha&icirc;nes qui contiennent les noms de fonctions qui existent lorsque <function>xml_parse</function> est appel&eacute; pour cr&eacute;er <parameter>parser</parameter>. </para> <para> - La fonction <parameter>startElementHandler</parameter> doit + La fonction <parameter>startelementhandler</parameter> doit accepter trois param&egrave;tres: - <methodsynopsis> - <methodname><replaceable>startElementHandler</replaceable></methodname> - <methodparam><type>resource</type><parameter>parser</parameter></methodparam> - <methodparam><type>string</type><parameter>name</parameter></methodparam> - <methodparam><type>array</type><parameter>attribs</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <methodname><replaceable>start_element_handler</replaceable></methodname> + <methodparam><type>resource</type><parameter>parser</parameter></methodparam> + <methodparam><type>string</type><parameter>name</parameter></methodparam> + <methodparam><type>array</type><parameter>attribs</parameter></methodparam> + </methodsynopsis> <variablelist> <varlistentry> <term><parameter>parser</parameter></term> @@ -78,13 +78,13 @@ </variablelist> </para> <para> - La fonction <parameter>endElementHandler</parameter> doit accepter deux + La fonction <parameter>endelementhandler</parameter> doit accepter deux param&egrave;tres: - <methodsynopsis> - <methodname><replaceable>endElementHandler</replaceable></methodname> + <methodsynopsis> + <methodname><replaceable>end_element_handler</replaceable></methodname> <methodparam><type>resource</type><parameter>parser</parameter></methodparam> <methodparam><type>string</type><parameter>name</parameter></methodparam> - </methodsynopsis> + </methodsynopsis> <variablelist> <varlistentry> <term><parameter>parser</parameter></term> @@ -110,7 +110,7 @@ </variablelist> </para> <para> - Si un gestionnaire re&ccedil;oit une cha&icirc;ne vide, ou <literal>FALSE</literal>, + Si un gestionnaire re&ccedil;oit une cha&icirc;ne vide, ou &false;, c'est qu'il est en train d'&ecirc;tre d&eacute;sactiv&eacute;. </para> <para> @@ -118,11 +118,7 @@ si le gestionnaire est actif, et &false;sinon, ou si <parameter>parser</parameter> n'est pas un analyseur. </para> - <para> - Il n'est pas pour l'instant possible d'utiliser des objets pour servir de - gestionnaire. Reportez-vous &agrave; <function>xml_set_object</function> pour - utiliser l'analyseur XML depuis un objet. - </para> + &note.func-callback; </refsect1> </refentry> Index: phpdoc-fr/reference/xml/functions/xml-set-external-entity-ref-handler.xml diff -u phpdoc-fr/reference/xml/functions/xml-set-external-entity-ref-handler.xml:1.2 phpdoc-fr/reference/xml/functions/xml-set-external-entity-ref-handler.xml:1.3 --- phpdoc-fr/reference/xml/functions/xml-set-external-entity-ref-handler.xml:1.2 Tue Aug 13 22:19:35 2002 +++ phpdoc-fr/reference/xml/functions/xml-set-external-entity-ref-handler.xml Mon Apr 28 11:47:14 2003 @@ -4,19 +4,20 @@ <refentry id="function.xml-set-external-entity-ref-handler"> <refnamediv> <refname>xml_set_external_entity_ref_handler</refname> - <refpurpose>Modifie le gestionnaire de r&eacute;f&eacute;rence externes.</refpurpose> + <refpurpose>Configure le gestionnaire XML de r&eacute;f&eacute;rences externes</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>xml_set_external_entity_ref_handler</methodname> - <methodparam><type>resource</type><parameter>parser</parameter></methodparam> - <methodparam><type>string</type><parameter>handler</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>xml_set_external_entity_ref_handler</methodname> + <methodparam><type>resource</type><parameter>parser</parameter></methodparam> + <methodparam><type>callback</type><parameter>handler</parameter></methodparam> + </methodsynopsis> <para> - Fixe le gestionnaire d'entit&eacute; externe de l'analyseur XML + <function>xml_set_external_entity_ref_handler</function> affecte + le gestionnaire d'entit&eacute; externe de l'analyseur XML <parameter>parser</parameter>. <parameter>handler</parameter> et - <parameter>endElementHandler</parameter> sont des cha&icirc;nes qui + <parameter>endelementhandler</parameter> sont des cha&icirc;nes qui contiennent les noms de fonction qui existent lorsque <function>xml_parse</function> est appel&eacute; pour cr&eacute;er le <parameter>parser</parameter>. @@ -24,17 +25,17 @@ <para> La fonction <parameter>handler</parameter> doit accepter 5 param&egrave;tres, et retourner un entier. Si la valeur retourn&eacute; par - le gestionnaire est &false;(comme par exemple si aucune valeur n'est + le gestionnaire est &false; (comme par exemple si aucune valeur n'est retourn&eacute;e), l'analyseur XML s'arr&ecirc;tera, et la fonction <function>xml_get_error_code</function> retournera <systemitem class="constant">XML_ERROR_EXTERNAL_ENTITY_HANDLING</systemitem>. <methodsynopsis> - <type>int</type><methodname><replaceable>handler</replaceable></methodname> - <methodparam><type>resource</type><parameter>parser</parameter></methodparam> - <methodparam><type>string</type><parameter>openEntityNames</parameter></methodparam> - <methodparam><type>string</type><parameter>base</parameter></methodparam> - <methodparam><type>string</type><parameter>systemId</parameter></methodparam> - <methodparam><type>string</type><parameter>publicId</parameter></methodparam> + <methodname><replaceable>handler</replaceable></methodname> + <methodparam><type>resource</type><parameter>parser</parameter></methodparam> + <methodparam><type>string</type><parameter>open_entity_names</parameter></methodparam> + <methodparam><type>string</type><parameter>base</parameter></methodparam> + <methodparam><type>string</type><parameter>system_id</parameter></methodparam> + <methodparam><type>string</type><parameter>public_id</parameter></methodparam> </methodsynopsis> <variablelist> <varlistentry> @@ -47,10 +48,10 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>openEntityNames</parameter></term> + <term><parameter>openentitynames</parameter></term> <listitem> <simpara> - Le deuxi&egrave;me param&egrave;tre, <parameter>openEntityNames</parameter>, + Le deuxi&egrave;me param&egrave;tre, <parameter>openentitynames</parameter>, est la liste de noms d'entit&eacute;, s&eacute;par&eacute;s par des espaces. Ces entit&eacute;s sont accessibles &agrave; l'analyse par cet entit&eacute; (y compris le nom de l'entit&eacute; ref&eacute;renc&eacute;). @@ -68,7 +69,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>systemId</parameter></term> + <term><parameter>systemid</parameter></term> <listitem> <simpara> Identifiant syst&egrave;me pour cet entit&eacute; externe. @@ -76,10 +77,10 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>publicId</parameter></term> + <term><parameter>publicid</parameter></term> <listitem> <simpara> - Le cinqui&egrave;me param&egrave;tre, <parameter>publicId</parameter>, + Le cinqui&egrave;me param&egrave;tre, <parameter>publicid</parameter>, est l'identifiant public, comme sp&eacute;cifi&eacute; dans la d&eacute;claration d'entit&eacute;, ou un cha&icirc;ne vide, si aucune d&eacute;claration n'a &eacute;t&eacute; sp&eacute;cifi&eacute;e. @@ -91,7 +92,7 @@ </variablelist> </para> <para> - Si un gestionnaire re&ccedil;oit une cha&icirc;ne vide, ou <literal>FALSE</literal>, + Si un gestionnaire re&ccedil;oit une cha&icirc;ne vide, ou &false;, c'est qu'il est en train d'&ecirc;tre d&eacute;sactiv&eacute;. </para> <para> @@ -100,11 +101,7 @@ &false;sinon ou si <parameter>parser</parameter> n'est pas un analyseur. </para> - <para> - Il n'est pas pour l'instant possible d'utiliser des objets pour servir de - gestionnaire. Reportez-vous &agrave; <function>xml_set_object</function> pour - utiliser l'analyseur XML depuis un objet. - </para> + &note.func-callback; </refsect1> </refentry> Index: phpdoc-fr/reference/xml/functions/xml-set-notation-decl-handler.xml diff -u phpdoc-fr/reference/xml/functions/xml-set-notation-decl-handler.xml:1.2 phpdoc-fr/reference/xml/functions/xml-set-notation-decl-handler.xml:1.3 --- phpdoc-fr/reference/xml/functions/xml-set-notation-decl-handler.xml:1.2 Tue Aug 13 22:19:35 2002 +++ phpdoc-fr/reference/xml/functions/xml-set-notation-decl-handler.xml Mon Apr 28 11:47:14 2003 @@ -4,17 +4,18 @@ <refentry id="function.xml-set-notation-decl-handler"> <refnamediv> <refname>xml_set_notation_decl_handler</refname> - <refpurpose>Affecte les gestionnaires de notation.</refpurpose> + <refpurpose>Configure le gestionnaire XML de notations</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>xml_set_notation_decl_handler</methodname> - <methodparam><type>resource</type><parameter>parser</parameter></methodparam> - <methodparam><type>string</type><parameter>handler</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>xml_set_notation_decl_handler</methodname> + <methodparam><type>resource</type><parameter>parser</parameter></methodparam> + <methodparam><type>callback</type><parameter>handler</parameter></methodparam> + </methodsynopsis> <para> - Affecte les gestionnaires de d&eacute;but et de fin de l'analyseur XML + <function>xml_set_notation_decl_handler</function> + affecte les gestionnaires de d&eacute;but et de fin de l'analyseur XML <parameter>parser</parameter>. <parameter>handler</parameter> est une cha&icirc;ne qui contient le nom d'une fonction qui existe lorsque <function>xml_parse</function> est appel&eacute; pour cr&eacute;er @@ -23,8 +24,10 @@ <para> Une notation est une partie du DTD du document, qui a le format suivant : <programlisting role="xml"> -&lt;!NOTATION <parameter>name</parameter> -{ <parameter>systemId</parameter> | <parameter>publicId</parameter>?&gt; +<![CDATA[ +<!NOTATION <parameter>name</parameter> +{ <parameter>systemid</parameter> | <parameter>publicid</parameter>?> +]]> </programlisting> Reportez-vous &agrave; la section <ulink url="&url.rec-xml;#sec-external-ent">des sp&eacute;cifications XML 1.0</ulink> @@ -32,15 +35,15 @@ </para> <para> La fonction <parameter>handler</parameter> doit accepter cinq - param&egrave;tres: - <methodsynopsis> - <methodname><replaceable>handler</replaceable></methodname> - <methodparam><type>resource</type><parameter>parser</parameter></methodparam> - <methodparam><type>string</type><parameter>notationName</parameter></methodparam> - <methodparam><type>string</type><parameter>base</parameter></methodparam> - <methodparam><type>string</type><parameter>systemId</parameter></methodparam> - <methodparam><type>string</type><parameter>publicId</parameter></methodparam> - </methodsynopsis> + param&egrave;tres : + <methodsynopsis> + <methodname><replaceable>handler</replaceable></methodname> + <methodparam><type>resource</type><parameter>parser</parameter></methodparam> + <methodparam><type>string</type><parameter>notation_name</parameter></methodparam> + <methodparam><type>string</type><parameter>base</parameter></methodparam> + <methodparam><type>string</type><parameter>system_id</parameter></methodparam> + <methodparam><type>string</type><parameter>public_id</parameter></methodparam> + </methodsynopsis> <variablelist> <varlistentry> <term> @@ -54,7 +57,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>notationName</parameter></term> + <term><parameter>notationname</parameter></term> <listitem> <simpara> Le nom de la notation,<parameter>name</parameter>, comme @@ -75,7 +78,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>systemId</parameter></term> + <term><parameter>systemid</parameter></term> <listitem> <simpara> Identifiant syst&egrave;me pour cet entit&eacute; externe. @@ -84,7 +87,7 @@ </varlistentry> <varlistentry> <term> - <parameter>publicId</parameter> + <parameter>publicid</parameter> </term> <listitem> <simpara> @@ -95,7 +98,7 @@ </variablelist> </para> <para> - Si un gestionnaire re&ccedil;oit une cha&icirc;ne vide ou <literal>FALSE</literal>, + Si un gestionnaire re&ccedil;oit une cha&icirc;ne vide ou &false;, c'est qu'il est en train d'&ecirc;tre d&eacute;sactiv&eacute;. </para> <para> @@ -104,11 +107,7 @@ &false;sinon ou si <parameter>parser</parameter> n'est pas un analyseur. </para> - <para> - Il n'est pas pour l'instant possible d'utiliser des objets pour servir de - gestionnaires. Reportez-vous &agrave; <function>xml_set_object</function> pour - utiliser l'analyseur XML depuis un objet. - </para> + &note.func-callback; </refsect1> </refentry> Index: phpdoc-fr/reference/xml/functions/xml-set-object.xml diff -u phpdoc-fr/reference/xml/functions/xml-set-object.xml:1.1 phpdoc-fr/reference/xml/functions/xml-set-object.xml:1.2 --- phpdoc-fr/reference/xml/functions/xml-set-object.xml:1.1 Sun Apr 14 20:40:05 2002 +++ phpdoc-fr/reference/xml/functions/xml-set-object.xml Mon Apr 28 11:47:14 2003 @@ -13,7 +13,7 @@ <methodsynopsis> <type>void</type><methodname>xml_set_object</methodname> <methodparam><type>resource</type><parameter>parser</parameter></methodparam> - <methodparam><type>object</type><parameter>&amp;object</parameter></methodparam> + <methodparam><type>object</type><parameter>object</parameter></methodparam> </methodsynopsis> <para> <function>xml_set_object</function> rend l'analyseur <parameter>parser</parameter> @@ -22,31 +22,46 @@ seront les m&eacute;thodes de cet objet. </para> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php class xml { -var $parser; -function xml() { - $this-&gt;parser = xml_parser_create(); - xml_set_object($this-&gt;parser,&amp;$this); - xml_set_element_handler($this-&gt;parser,"tag_open","tag_close"); - xml_set_character_data_handler($this-&gt;parser,"cdata"); -} -function parse($data) { - xml_parse($this-&gt;parser,$data); -} -function tag_open($parser,$tag,$attributes) { - var_dump($parser,$tag,$attributes); -} -function cdata($parser,$cdata) { - var_dump($parser,$cdata); -} -function tag_close($parser,$tag) { - var_dump($parser,$tag); -} -} // Fin de la classe xml + var $parser; + + function xml() + { + $this->parser = xml_parser_create(); + + xml_set_object($this->parser, &$this); + xml_set_element_handler($this->parser, "tag_open", "tag_close"); + xml_set_character_data_handler($this->parser, "cdata"); + } + + function parse($data) + { + xml_parse($this->parser, $data); + } + + function tag_open($parser, $tag, $attributes) + { + var_dump($parser, $tag, $attributes); + } + + function cdata($parser, $cdata) + { + var_dump($parser, $cdata); + } + + function tag_close($parser, $tag) + { + var_dump($parser, $tag); + } + +} // end of class xml + $xml_parser = new xml(); -$xml_parser-&gt;parse("&lt;A ID=\"bonjour\"&gt;PHP&lt;/?&gt;"); -?&gt; +$xml_parser->parse("<A ID='hallo'>PHP</A>"); +?> +]]> </programlisting> </refsect1> </refentry> Index: phpdoc-fr/reference/xml/functions/xml-set-processing-instruction-handler.xml diff -u phpdoc-fr/reference/xml/functions/xml-set-processing-instruction-handler.xml:1.2 phpdoc-fr/reference/xml/functions/xml-set-processing-instruction-handler.xml:1.3 --- phpdoc-fr/reference/xml/functions/xml-set-processing-instruction-handler.xml:1.2 Tue Aug 13 22:19:35 2002 +++ phpdoc-fr/reference/xml/functions/xml-set-processing-instruction-handler.xml Mon Apr 28 11:47:14 2003 @@ -10,13 +10,14 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>xml_set_processing_instruction_handler</methodname> - <methodparam><type>resource</type><parameter>parser</parameter></methodparam> - <methodparam><type>string</type><parameter>handler</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>xml_set_processing_instruction_handler</methodname> + <methodparam><type>resource</type><parameter>parser</parameter></methodparam> + <methodparam><type>callback</type><parameter>handler</parameter></methodparam> + </methodsynopsis> <para> - Affecte les gestionnaires d'instructions ex&eacute;cutables de l'analyseur + <function>xml_set_processing_instruction_handler</function> + affecte le gestionnaire d'instructions ex&eacute;cutables de l'analyseur XML <parameter>parser</parameter>. <parameter>handler</parameter> est une cha&icirc;ne qui contient le nom d'une fonction qui existe lorsque <function>xml_parse</function> est appel&eacute; pour cr&eacute;er @@ -43,12 +44,12 @@ </para> <para> La fonction <parameter>handler</parameter> doit accepter trois param&egrave;tres: - <methodsynopsis> - <methodname><replaceable>handler</replaceable></methodname> - <methodparam><type>resource</type><parameter>parser</parameter></methodparam> - <methodparam><type>string</type><parameter>target</parameter></methodparam> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <methodname><replaceable>handler</replaceable></methodname> + <methodparam><type>resource</type><parameter>parser</parameter></methodparam> + <methodparam><type>string</type><parameter>target</parameter></methodparam> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + </methodsynopsis> <variablelist> <varlistentry> <term><parameter>parser</parameter></term> @@ -78,7 +79,7 @@ </variablelist> </para> <para> - Si un gestionnaire re&ccedil;oit une cha&icirc;ne vide, ou <literal>FALSE</literal>, + Si un gestionnaire re&ccedil;oit une cha&icirc;ne vide, ou &false;, c'est qu'il est en train d'&ecirc;tre d&eacute;sactiv&eacute;. </para> <para> @@ -87,11 +88,7 @@ &false;sinon, ou si <parameter>parser</parameter> n'est pas un analyseur. </para> - <para> - Il n'est pas pour l'instant possible d'utiliser des objets pour servir de - gestionnaire. Reportez-vous &agrave; <function>xml_set_object</function> pour - utiliser l'analyseur XML depuis un objet. - </para> + &note.func-callback; </refsect1> </refentry> Index: phpdoc-fr/reference/xml/functions/xml-set-unparsed-entity-decl-handler.xml diff -u phpdoc-fr/reference/xml/functions/xml-set-unparsed-entity-decl-handler.xml:1.2 phpdoc-fr/reference/xml/functions/xml-set-unparsed-entity-decl-handler.xml:1.3 --- phpdoc-fr/reference/xml/functions/xml-set-unparsed-entity-decl-handler.xml:1.2 Tue Aug 13 22:19:35 2002 +++ phpdoc-fr/reference/xml/functions/xml-set-unparsed-entity-decl-handler.xml Mon Apr 28 11:47:14 2003 @@ -5,18 +5,19 @@ <refnamediv> <refname>xml_set_unparsed_entity_decl_handler</refname> <refpurpose> - Affecte les gestionnaires d'entit&eacute; non d&eacute;clar&eacute;. + Affecte les gestionnaires d'entit&eacute;s non d&eacute;clar&eacute;s </refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>xml_set_unparsed_entity_decl_handler</methodname> - <methodparam><type>resource</type><parameter>parser</parameter></methodparam> - <methodparam><type>string</type><parameter>handler</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>xml_set_unparsed_entity_decl_handler</methodname> + <methodparam><type>resource</type><parameter>parser</parameter></methodparam> + <methodparam><type>callback</type><parameter>handler</parameter></methodparam> + </methodsynopsis> <para> - Affecte les gestionnaires d'entit&eacute; non d&eacute;clar&eacute; de + <function>xml_set_unparsed_entity_decl_handler</function> + affecte les gestionnaires d'entit&eacute; non d&eacute;clar&eacute; de l'analyseur XML <parameter>parser</parameter>. <parameter>handler</parameter> est une cha&icirc;ne qui contient le nom d'une fonction qui existe lorsque <function>xml_parse</function> est appel&eacute; pour cr&eacute;er @@ -27,8 +28,10 @@ d&eacute;claration d'entit&eacute; externe avec une d&eacute;claration de NDATA, comme suit : <programlisting role="xml"> -&lt;!ENTITY <parameter>name</parameter> {<parameter>publicId</parameter> | <parameter>systemId</parameter>} - NDATA <parameter>notationName</parameter> +<![CDATA[ +<!ENTITY <parameter>name</parameter> {<parameter>publicid</parameter> | <parameter>systemid</parameter>} + NDATA <parameter>notationname</parameter> +]]> </programlisting> </para> <para> @@ -38,15 +41,15 @@ </para> <para> La fonction <parameter>handler</parameter> doit accepter six param&egrave;tres: - <methodsynopsis> - <methodname><replaceable>handler</replaceable></methodname> - <methodparam><type>resource</type><parameter>parser</parameter></methodparam> - <methodparam><type>string</type><parameter>entityName</parameter></methodparam> - <methodparam><type>string</type><parameter>base</parameter></methodparam> - <methodparam><type>string</type><parameter>systemId</parameter></methodparam> - <methodparam><type>string</type><parameter>publicId</parameter></methodparam> - <methodparam><type>string</type><parameter>notationName</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <methodname><replaceable>handler</replaceable></methodname> + <methodparam><type>resource</type><parameter>parser</parameter></methodparam> + <methodparam><type>string</type><parameter>entity_name</parameter></methodparam> + <methodparam><type>string</type><parameter>base</parameter></methodparam> + <methodparam><type>string</type><parameter>system_id</parameter></methodparam> + <methodparam><type>string</type><parameter>public_id</parameter></methodparam> + <methodparam><type>string</type><parameter>notation_name</parameter></methodparam> + </methodsynopsis> <variablelist> <varlistentry> <term><parameter>parser</parameter></term> @@ -58,7 +61,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>entityName</parameter></term> + <term><parameter>entityname</parameter></term> <listitem> <simpara> Le nom de l'entit&eacute; qui va &ecirc;tre d&eacute;finie @@ -76,7 +79,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>systemId</parameter></term> + <term><parameter>systemid</parameter></term> <listitem> <simpara> Identifiant syst&egrave;me pour cet entit&eacute; externe. @@ -84,7 +87,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>publicId</parameter></term> + <term><parameter>publicid</parameter></term> <listitem> <simpara> Identifiant public pour cet entit&eacute; externe. @@ -92,7 +95,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>notationName</parameter></term> + <term><parameter>notationname</parameter></term> <listitem> <simpara> Nom de la notation de cette entit&eacute;. (Voir @@ -103,7 +106,7 @@ </variablelist> </para> <para> - Si un gestionnaire re&ccedil;oit une cha&icirc;ne vide ou <literal>FALSE</literal>, + Si un gestionnaire re&ccedil;oit une cha&icirc;ne vide ou &false;, c'est qu'il est en train d'&ecirc;tre d&eacute;sactiv&eacute;. </para> <para> @@ -112,11 +115,7 @@ &false;sinon, ou si <parameter>parser</parameter> n'est pas un analyseur. </para> - <para> - Il n'est pas pour l'instant possible d'utiliser des objets pour servir de - gestionnaire. Reportez-vous &agrave; <function>xml_set_object</function> pour - utiliser l'analyseur XML depuis un objet. - </para> + &note.func-callback; </refsect1> </refentry> Index: phpdoc-fr/reference/xml/functions/xml-parser-create-ns.xml +++ phpdoc-fr/reference/xml/functions/xml-parser-create-ns.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/xml.xml, last change in rev 1.24 --> <refentry id="function.xml-parser-create-ns"> <refnamediv> <refname>xml_parser_create_ns</refname> <refpurpose>Cr&eacute;e un analyseur XML</refpurpose> </refnamediv> <refsect1> <title>Description</title> <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> cr&eacute;e un nouvel analyseur XML avec le support des espaces de noms, et retourne une ressource, qui pourra &ecirc;tre utilis&eacute;e avec les autres fonctions XML. </para> <para> Avec un analyseur qui supporte les espaces de noms, les balises qui sont pass&eacute;es aux diff&eacute;rentes fonctions de gestion seront constitu&eacute;es du nom de l'espace et du nom de balise, s&eacute;par&eacute; par la cha&icirc;ne <parameter>seperator</parameter> ou par <literal>':'</literal>, par d&eacute;faut. </para> <para> Le param&egrave;tre optionnel <parameter>encoding</parameter> sp&eacute;cifie le jeu de caract&egrave;res que le XML doit traiter. Les jeux de caract&egrave;res support&eacute;s sont <literal>"ISO-8859-1"</literal>, qui est aussi la valeur par d&eacute;faut si <parameter>encoding</parameter> est omis, <literal>"UTF-8"</literal> et <literal>"US-ASCII"</literal>. </para> <para> Voir aussi <function>xml_parser_create</function> et <function>xml_parser_free</function>. </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 --> Index: phpdoc-fr/reference/xml/functions/xml-set-end-namespace-decl-handler.xml +++ phpdoc-fr/reference/xml/functions/xml-set-end-namespace-decl-handler.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/xml.xml, last change in rev 1.24 --> <refentry id="function.xml-set-end-namespace-decl-handler"> <refnamediv> <refname>xml_set_end_namespace_decl_handler</refname> <refpurpose>Configure le gestionnaire XML de donn&eacute;es</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>xml_set_end_namespace_decl_handler</methodname> <methodparam><type>resource</type><parameter>pind</parameter></methodparam> <methodparam><type>callback</type><parameter>handler</parameter></methodparam> </methodsynopsis> <para> &warn.undocumented.func; </para> &note.func-callback; </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 --> Index: phpdoc-fr/reference/xml/functions/xml-set-start-namespace-decl-handler.xml +++ phpdoc-fr/reference/xml/functions/xml-set-start-namespace-decl-handler.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/xml.xml, last change in rev 1.24 --> <refentry id="function.xml-set-start-namespace-decl-handler"> <refnamediv> <refname>xml_set_start_namespace_decl_handler</refname> <refpurpose>Configure le gestionnaire de caract&egrave;res</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>xml_set_start_namespace_decl_handler</methodname> <methodparam><type>resource</type><parameter>pind</parameter></methodparam> <methodparam><type>callback</type><parameter>hdl</parameter></methodparam> </methodsynopsis> <para> &warn.undocumented.func; </para> &note.func-callback; </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 -->
« previous php.doc.fr (#310) next »