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: | Damien Seguy | 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 à Balises Etendu)) est un format structuré de données pour les @@ -15,48 +13,6 @@ du XML et des technologies affé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 à <ulink url="&url.expat;">&url.expat;</ulink>. - Le fichier Makefile livré avec <productname>expat</productname> - ne construit pas par dé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 à - <ulink url="&url.expat.rpm;">&url.expat.rpm;</ulink>. - </para> - <para> - Notez que si vous utilisez Apache-1.3.7 ou plus récent, - vous disposez déjà 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é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> étant installée - là où votre compilateur peut la trouver. - Si vous compilez PHP comme module de PHP 1.3.9 ou plus récent, - PHP utilisera automatiquement le module <productname>expat</productname> - livré avec Apache. Il vous faudra peut ê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étrages</link>. </para> + </section> + <section id="xml.requirements"> + &reftitle.required; + <para> + Cette extension de PHP utilise <productname>expat</productname>, + disponible à <ulink url="&url.expat;">&url.expat;</ulink>. + Le fichier Makefile livré avec <productname>expat</productname> + ne construit pas par dé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 à + <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ée par + <function>xml_parser_create</function> et + <function>xml_parser_create_ns</function>, et représente + un analysueur XML à utiliser avec les autres fonctions de l'extension. + </para> + </section> + </section> + + &reference.xml.constants; + + + <section id="xml.eventhandlers"> + <title>gestionnaires d'évènements</title> <para> Les gestionnaires d'évènements XML sont: <table> @@ -186,28 +188,28 @@ Les constantes suivantes sont définies comme des codes d'erreurs XML : (retourné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é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"> -<?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 < $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 à la ligne %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> </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 éléments inconnus seront ignorés. Bien entendu, cet exemple sera appliqué à un type précis de fichiers XML. <programlisting role="php"> -<?php +<![CDATA[ +<?php $file = "data.xml"; $map_array = array( - "BOLD" => "B", - "EMPHASIS" => "I", - "LITERAL" => "TT" + "BOLD" => "B", + "EMPHASIS" => "I", + "LITERAL" => "TT" ); + function startElement($parser, $name, $attrs) { global $map_array; if ($htmltag = $map_array[$name]) { - print "<$htmltag>"; + print "<$htmltag>"; } } + function endElement($parser, $name) { global $map_array; if ($htmltag = $map_array[$name]) { - print "</$htmltag>"; + 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ère à ê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 à la ligne %d", xml_error_string(xml_get_error_code($xml_parser)), xml_get_current_line_number($xml_parser))); } } xml_parser_free($xml_parser); -?> +?> +]]> </programlisting> </para> </example> </para> </section> <section id="example.xml-external-entity"> - <title>XML Entité externe</title> + <title>Entité externe</title> <para> Cet exemple exploite les références externes de XML : il est possible d'utiliser un gestionnaire d'entité externe @@ -380,32 +394,38 @@ <example> <title>Entité externe</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $file = "xmltest.xml"; + function trustedFile($file) { // only trust local files owned by ourselves - if (!eregi("^([a-z]+)://", $file) - && 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 "&lt;<font color=\"#0000cc\">$name</font>"; + print "<<font color=\"#0000cc\">$name</font>"; if (sizeof($attribs)) { while (list($k, $v) = each($attribs)) { - print " <font color=\"#009900\">$k</font>=\"<font - color=\"#990000\">$v</font>\""; + print " <font color=\"#009900\">$k</font>=\"<font + color=\"#990000\">$v</font>\""; } } - print "&gt;"; + print ">"; } + function endElement($parser, $name) { - print "&lt;/<font color=\"#0000cc\">$name</font>&gt;"; + print "</<font color=\"#0000cc\">$name</font>>"; } + function characterData($parser, $data) { - print "<B>$data</B>"; + 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ûr : <B>%s</B>", + printf("Untrusted PHP code: <i>%s</i>", htmlspecialchars($data)); } break; } } + function defaultHandler($parser, $data) { - if (substr($data, 0, 1) == "&" && substr($data, -1, 1) == ";") { - printf('<font color="#aa00aa">%s</font>', + if (substr($data, 0, 1) == "&" && substr($data, -1, 1) == ";") { + printf('<font color="#aa00aa">%s</font>', htmlspecialchars($data)); } else { - printf('<font size="-1">%s</font>', + 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 à la ligne %d lors de l'analyse de l'entité %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 "<pre>"; + +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 à la ligne %d\n", xml_error_string(xml_get_error_code($xml_parser)), xml_get_current_line_number($xml_parser))); } } -print "</pre>"; +print "</pre>"; print "parse complete\n"; xml_parser_free($xml_parser); -?> + +?> +]]> </programlisting> </example> </para> @@ -493,33 +522,35 @@ <example> <title>xmltest.xml</title> <programlisting role="xml"> -<?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; - <sect1 id="about"> - <title>About this Document</title> - <para> - <!-- this is a comment --> - <?php print 'Hi! This is PHP version '.phpversion(); ?> - </para> - </sect1> -</chapter> +<![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"> -<?xml version="1.0" ?> -<!DOCTYPE foo [ -<!ENTITY testEnt "test entity"> -?> -<foo> - <element attrib="value"?> - &testEnt; - <?php print "This is some more PHP code being executed."; ?> -</foo> +<![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écuté."; ?> +</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îne UTF-8 en ISO-8859.</refpurpose> + <refpurpose>Convertit une chaî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étails sur le codage <literal>UTF-8</literal>. + Voir aussi + <function>utf8_encode</function> + pour plus de dé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îne ISO-8859-1 en UTF-8.</refpurpose> + <refpurpose>Convertit une chaî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ée. <literal>UTF-8</literal> est un mécanisme standardisé utilisé par Unicode pour coder les caractère de grande - taille dans des flots d'octets. <literal>UTF-8</literal> est transparent + taille dans des flôts d'octets. <literal>UTF-8</literal> est transparent pour les caractères <abbrev>ASCII</abbrev>, il est auto-synchronisé (c'est à - dire qu'un programme peut toujours savoir dans un flot d'octet où + dire qu'un programme peut toujours savoir dans un flôt d'octet où un caractère commence), et peut être utilisé pour faire des comparaisons de chaînes standard, comme pour le tri. PHP utilise l'<literal>UTF-8</literal> pour coder les caractè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éro de colonne courante de la ligne courante de l'analyseur, qui correspond à 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>&values</parameter></methodparam> - <methodparam><type>array</type><parameter>&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>&values</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>&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énérée : <informalexample> <programlisting role="php"> -<?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); -?> +<![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'éxécution du code, l'affichage sera : <informalexample> <literallayout> <computeroutput> -Tableau d'index +<![CDATA[ +Tableau d'index Array ( - [PARA] => Array + [PARA] => Array ( - [0] => 0 - [1] => 2 + [0] => 0 + [1] => 2 ) - [NOTE] => Array + + [NOTE] => Array ( - [0] => 1 + [0] => 1 ) + ) -Tableau de valeurs + +Tableau de valeurs Array ( - [0] => Array + [0] => Array ( - [tag] => PARA - [type] => open - [level] => 1 + [tag] => PARA + [type] => open + [level] => 1 ) - [1] => Array + + [1] => Array ( - [tag] => NOTE - [type] => complete - [level] => 2 - [value] => simple note + [tag] => NOTE + [type] => complete + [level] => 2 + [value] => Simple Note ) - [2] => Array + + [2] => Array ( - [tag] => PARA - [type] => close - [level] => 1 + [tag] => PARA + [type] => close + [level] => 1 ) + ) - </computeroutput> +]]> </computeroutput> </literallayout> </informalexample> </para> @@ -98,21 +107,26 @@ <example> <title>moldb.xml - Petite base de données moléculaire</title> <programlisting role="xml"> -<?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> +<![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énère les @@ -123,32 +137,37 @@ d'objet moléculaires </title> <programlisting role="php"> -<?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é 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->$v) - $this->$k = $aa[$k]; + foreach ($aa as $k=>$v) + $this->$k = $aa[$k]; } } + function readDatabase($filename) { // read the xml database of aminoacids - $data = implode("",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,&$values,&$tags); + xml_parse_into_struct($parser,$data,$values,$tags); xml_parser_free($parser); - // parcourt les structures - foreach ($tags as $key->$val) { - if ($key == "molecule") { + + // loop through the structures + foreach ($tags as $key=>$val) { + if ($key == "molecule") { $molranges = $val; - // chaque paire contigue sont les définitions supérieures - // et inférieures de la molécule - for ($i=0; $i < 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 < count($mvalues); $i++) - $mol[$mvalues[$i]["tag"]] = $mvalues[$i]["value"]; + for ($i=0; $i < count($mvalues); $i++) + $mol[$mvalues[$i]["tag"]] = $mvalues[$i]["value"]; return new AminoAcid($mol); } -$db = readDatabase("moldb.xml"); + +$db = readDatabase("moldb.xml"); echo "** Database of AminoAcid objects:\n"; print_r($db); -?> + +?> +]]> </programlisting> </example> Après exé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] => aminoacid Object + [0] => aminoacid Object ( - [name] => Alanine - [symbol] => ala - [code] => A - [type] => hydrophobic - ) - [1] => aminoacid Object - ( - [name] => Lysine - [symbol] => lys - [code] => K - [type] => 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ées à analyser. Un document peut être analysé morceau par morceau, en appelant <function>xml_parse</function> plusieurs fois, tant que le - paramètre <parameter>isFinal</parameter> est mis à + paramètre <parameter>isfinal</parameter> est mis à &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ère partie @@ -50,7 +50,7 @@ <para> Lorsqu'un document XML est analysé, les gestionnaires d'événements sont appelés aussi souvent que - nécessaire, et retournent &true; ou <literal>FALSE</literal>. + nécessaire, et retournent &true; ou &false;. </para> <para> &true; est retourné lorsque l'analyse a été 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éation d'un analyseur XML.</refpurpose> + <refpurpose>Cré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ée un analyseur XML et + retourne une référence sur cet analyseur pour qu'il puisse + être utilisé ulté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ère de l'analyseur : les codages suivants + Le codage de caractère de l'analyseur. Les codages suivants sont supportés : <simplelist> <member><literal>ISO-8859-1</literal> (par défaut)</member> @@ -29,11 +34,11 @@ </listitem> </varlistentry> </variablelist> - <function>xml_parser_create</function> crée un analyseur XML et - retourne une référence sur cet analyseur pour qu'il puisse - être utilisé ulté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étruit un analyseur XML.</refpurpose> + <refpurpose> Dé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éférence valide, ou sinon, dé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éférence valide sur un analyseur XML, ou si l'option n'a pas pu être modifiée. Sinon, l'option est effectivement modifié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ô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 à 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ère bruts.</refpurpose> + <refpurpose>Affecte les gestionnaires de texte litté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ébut et de fin de l'analyseur XML + <function>xml_set_character_data_handler</function> + affecte les gestionnaires de début et de fin de l'analyseur XML <parameter>parser</parameter>. <parameter>handler</parameter> est une chaîne qui contient le nom d'une fonction qui existe lorsque <function>xml_parse</function> est appelé pour créer <parameter>parser</parameter>. </para> <para> - La fonction <parameter>handler</parameter> doit accepter deux paramè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è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çoit une chaîne vide ou <literal>FALSE</literal>, c'est + Si un gestionnaire reçoit une chaîne vide ou &false;, c'est qu'il est en train d'être désactivé. </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 à <function>xml_set_object</function> pour - utiliser l'analyseur XML depuis un objet. - </para> + ¬e.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éfaut.</refpurpose> + <refpurpose>Affecte le gestionnaire XML par dé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éfaut de l'analyseur XML + <function>xml_set_default_handler</function> + affecte le gestionnaire par défaut de l'analyseur XML <parameter>parser</parameter>. <parameter>handler</parameter> est une chaîne qui contient le nom d'une fonction qui existe lorsque <function>xml_parse</function> est appelé pour créer @@ -22,11 +23,11 @@ </para> <para> La fonction <parameter>handler</parameter> doit accepter deux paramè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çoit une chaîne vide ou <literal>FALSE</literal>, c'est + Si un gestionnaire reçoit une chaîne vide ou &false;, c'est qu'il est en train d'être désactivé. </para> <para> @@ -69,6 +70,7 @@ gestionnaire. Reportez-vous à <function>xml_set_object</function> pour utiliser l'analyseur XML depuis un objet. </para> + ¬e.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ébut et de fin.</refpurpose> + <refpurpose>Affecte les gestionnaires de dé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ébut et de fin de l'analyseur XML - <parameter>parser</parameter>. <parameter>startElementHandler</parameter> - et <parameter>endElementHandler</parameter> sont des chaînes qui + <parameter>parser</parameter>. <parameter>startelementhandler</parameter> + et <parameter>endelementhandler</parameter> sont des chaînes qui contiennent les noms de fonctions qui existent lorsque <function>xml_parse</function> est appelé pour créer <parameter>parser</parameter>. </para> <para> - La fonction <parameter>startElementHandler</parameter> doit + La fonction <parameter>startelementhandler</parameter> doit accepter trois paramè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è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çoit une chaîne vide, ou <literal>FALSE</literal>, + Si un gestionnaire reçoit une chaîne vide, ou &false;, c'est qu'il est en train d'être désactivé. </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 à <function>xml_set_object</function> pour - utiliser l'analyseur XML depuis un objet. - </para> + ¬e.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éférence externes.</refpurpose> + <refpurpose>Configure le gestionnaire XML de réfé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é externe de l'analyseur XML + <function>xml_set_external_entity_ref_handler</function> affecte + le gestionnaire d'entité externe de l'analyseur XML <parameter>parser</parameter>. <parameter>handler</parameter> et - <parameter>endElementHandler</parameter> sont des chaînes qui + <parameter>endelementhandler</parameter> sont des chaînes qui contiennent les noms de fonction qui existent lorsque <function>xml_parse</function> est appelé pour créer le <parameter>parser</parameter>. @@ -24,17 +25,17 @@ <para> La fonction <parameter>handler</parameter> doit accepter 5 paramètres, et retourner un entier. Si la valeur retourné 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ée), l'analyseur XML s'arrê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ème paramètre, <parameter>openEntityNames</parameter>, + Le deuxième paramètre, <parameter>openentitynames</parameter>, est la liste de noms d'entité, séparés par des espaces. Ces entités sont accessibles à l'analyse par cet entité (y compris le nom de l'entité reférencé). @@ -68,7 +69,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>systemId</parameter></term> + <term><parameter>systemid</parameter></term> <listitem> <simpara> Identifiant système pour cet entité externe. @@ -76,10 +77,10 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>publicId</parameter></term> + <term><parameter>publicid</parameter></term> <listitem> <simpara> - Le cinquième paramètre, <parameter>publicId</parameter>, + Le cinquième paramètre, <parameter>publicid</parameter>, est l'identifiant public, comme spécifié dans la déclaration d'entité, ou un chaîne vide, si aucune déclaration n'a été spécifiée. @@ -91,7 +92,7 @@ </variablelist> </para> <para> - Si un gestionnaire reçoit une chaîne vide, ou <literal>FALSE</literal>, + Si un gestionnaire reçoit une chaîne vide, ou &false;, c'est qu'il est en train d'être désactivé. </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 à <function>xml_set_object</function> pour - utiliser l'analyseur XML depuis un objet. - </para> + ¬e.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ébut et de fin de l'analyseur XML + <function>xml_set_notation_decl_handler</function> + affecte les gestionnaires de début et de fin de l'analyseur XML <parameter>parser</parameter>. <parameter>handler</parameter> est une chaîne qui contient le nom d'une fonction qui existe lorsque <function>xml_parse</function> est appelé pour créer @@ -23,8 +24,10 @@ <para> Une notation est une partie du DTD du document, qui a le format suivant : <programlisting role="xml"> -<!NOTATION <parameter>name</parameter> -{ <parameter>systemId</parameter> | <parameter>publicId</parameter>?> +<![CDATA[ +<!NOTATION <parameter>name</parameter> +{ <parameter>systemid</parameter> | <parameter>publicid</parameter>?> +]]> </programlisting> Reportez-vous à la section <ulink url="&url.rec-xml;#sec-external-ent">des spécifications XML 1.0</ulink> @@ -32,15 +35,15 @@ </para> <para> La fonction <parameter>handler</parameter> doit accepter cinq - paramè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è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ème pour cet entité 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çoit une chaîne vide ou <literal>FALSE</literal>, + Si un gestionnaire reçoit une chaîne vide ou &false;, c'est qu'il est en train d'être désactivé. </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 à <function>xml_set_object</function> pour - utiliser l'analyseur XML depuis un objet. - </para> + ¬e.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>&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éthodes de cet objet. </para> <programlisting role="php"> -<?php +<![CDATA[ +<?php class 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); -} -} // 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->parse("<A ID=\"bonjour\">PHP</?>"); -?> +$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écutables de l'analyseur + <function>xml_set_processing_instruction_handler</function> + affecte le gestionnaire d'instructions exécutables de l'analyseur XML <parameter>parser</parameter>. <parameter>handler</parameter> est une chaîne qui contient le nom d'une fonction qui existe lorsque <function>xml_parse</function> est appelé pour créer @@ -43,12 +44,12 @@ </para> <para> La fonction <parameter>handler</parameter> doit accepter trois paramè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çoit une chaîne vide, ou <literal>FALSE</literal>, + Si un gestionnaire reçoit une chaîne vide, ou &false;, c'est qu'il est en train d'être désactivé. </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 à <function>xml_set_object</function> pour - utiliser l'analyseur XML depuis un objet. - </para> + ¬e.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é non déclaré. + Affecte les gestionnaires d'entités non déclaré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é non déclaré de + <function>xml_set_unparsed_entity_decl_handler</function> + affecte les gestionnaires d'entité non déclaré de l'analyseur XML <parameter>parser</parameter>. <parameter>handler</parameter> est une chaîne qui contient le nom d'une fonction qui existe lorsque <function>xml_parse</function> est appelé pour créer @@ -27,8 +28,10 @@ déclaration d'entité externe avec une déclaration de NDATA, comme suit : <programlisting role="xml"> -<!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è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é qui va être définie @@ -76,7 +79,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>systemId</parameter></term> + <term><parameter>systemid</parameter></term> <listitem> <simpara> Identifiant système pour cet entité 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é 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é. (Voir @@ -103,7 +106,7 @@ </variablelist> </para> <para> - Si un gestionnaire reçoit une chaîne vide ou <literal>FALSE</literal>, + Si un gestionnaire reçoit une chaîne vide ou &false;, c'est qu'il est en train d'être désactivé. </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 à <function>xml_set_object</function> pour - utiliser l'analyseur XML depuis un objet. - </para> + ¬e.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é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ée un nouvel analyseur XML avec le support des espaces de noms, et retourne une ressource, qui pourra être utilisée avec les autres fonctions XML. </para> <para> Avec un analyseur qui supporte les espaces de noms, les balises qui sont passées aux différentes fonctions de gestion seront constituées du nom de l'espace et du nom de balise, séparé par la chaîne <parameter>seperator</parameter> ou par <literal>':'</literal>, par défaut. </para> <para> Le paramètre optionnel <parameter>encoding</parameter> spécifie le jeu de caractères que le XML doit traiter. Les jeux de caractères supportés sont <literal>"ISO-8859-1"</literal>, qui est aussi la valeur par dé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é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> ¬e.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è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> ¬e.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/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 à Balises Etendu)) est un format structuré de données pour les @@ -15,48 +13,6 @@ du XML et des technologies affé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 à <ulink url="&url.expat;">&url.expat;</ulink>. - Le fichier Makefile livré avec <productname>expat</productname> - ne construit pas par dé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 à - <ulink url="&url.expat.rpm;">&url.expat.rpm;</ulink>. - </para> - <para> - Notez que si vous utilisez Apache-1.3.7 ou plus récent, - vous disposez déjà 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é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> étant installée - là où votre compilateur peut la trouver. - Si vous compilez PHP comme module de PHP 1.3.9 ou plus récent, - PHP utilisera automatiquement le module <productname>expat</productname> - livré avec Apache. Il vous faudra peut ê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étrages</link>. </para> + </section> + <section id="xml.requirements"> + &reftitle.required; + <para> + Cette extension de PHP utilise <productname>expat</productname>, + disponible à <ulink url="&url.expat;">&url.expat;</ulink>. + Le fichier Makefile livré avec <productname>expat</productname> + ne construit pas par dé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 à + <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ée par + <function>xml_parser_create</function> et + <function>xml_parser_create_ns</function>, et représente + un analysueur XML à utiliser avec les autres fonctions de l'extension. + </para> + </section> + </section> + + &reference.xml.constants; + + + <section id="xml.eventhandlers"> + <title>gestionnaires d'évènements</title> <para> Les gestionnaires d'évènements XML sont: <table> @@ -186,28 +188,28 @@ Les constantes suivantes sont définies comme des codes d'erreurs XML : (retourné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é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"> -<?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 < $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 à la ligne %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> </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 éléments inconnus seront ignorés. Bien entendu, cet exemple sera appliqué à un type précis de fichiers XML. <programlisting role="php"> -<?php +<![CDATA[ +<?php $file = "data.xml"; $map_array = array( - "BOLD" => "B", - "EMPHASIS" => "I", - "LITERAL" => "TT" + "BOLD" => "B", + "EMPHASIS" => "I", + "LITERAL" => "TT" ); + function startElement($parser, $name, $attrs) { global $map_array; if ($htmltag = $map_array[$name]) { - print "<$htmltag>"; + print "<$htmltag>"; } } + function endElement($parser, $name) { global $map_array; if ($htmltag = $map_array[$name]) { - print "</$htmltag>"; + 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ère à ê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 à la ligne %d", xml_error_string(xml_get_error_code($xml_parser)), xml_get_current_line_number($xml_parser))); } } xml_parser_free($xml_parser); -?> +?> +]]> </programlisting> </para> </example> </para> </section> <section id="example.xml-external-entity"> - <title>XML Entité externe</title> + <title>Entité externe</title> <para> Cet exemple exploite les références externes de XML : il est possible d'utiliser un gestionnaire d'entité externe @@ -380,32 +394,38 @@ <example> <title>Entité externe</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $file = "xmltest.xml"; + function trustedFile($file) { // only trust local files owned by ourselves - if (!eregi("^([a-z]+)://", $file) - && 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 "&lt;<font color=\"#0000cc\">$name</font>"; + print "<<font color=\"#0000cc\">$name</font>"; if (sizeof($attribs)) { while (list($k, $v) = each($attribs)) { - print " <font color=\"#009900\">$k</font>=\"<font - color=\"#990000\">$v</font>\""; + print " <font color=\"#009900\">$k</font>=\"<font + color=\"#990000\">$v</font>\""; } } - print "&gt;"; + print ">"; } + function endElement($parser, $name) { - print "&lt;/<font color=\"#0000cc\">$name</font>&gt;"; + print "</<font color=\"#0000cc\">$name</font>>"; } + function characterData($parser, $data) { - print "<B>$data</B>"; + 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ûr : <B>%s</B>", + printf("Untrusted PHP code: <i>%s</i>", htmlspecialchars($data)); } break; } } + function defaultHandler($parser, $data) { - if (substr($data, 0, 1) == "&" && substr($data, -1, 1) == ";") { - printf('<font color="#aa00aa">%s</font>', + if (substr($data, 0, 1) == "&" && substr($data, -1, 1) == ";") { + printf('<font color="#aa00aa">%s</font>', htmlspecialchars($data)); } else { - printf('<font size="-1">%s</font>', + 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 à la ligne %d lors de l'analyse de l'entité %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 "<pre>"; + +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 à la ligne %d\n", xml_error_string(xml_get_error_code($xml_parser)), xml_get_current_line_number($xml_parser))); } } -print "</pre>"; +print "</pre>"; print "parse complete\n"; xml_parser_free($xml_parser); -?> + +?> +]]> </programlisting> </example> </para> @@ -493,33 +522,35 @@ <example> <title>xmltest.xml</title> <programlisting role="xml"> -<?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; - <sect1 id="about"> - <title>About this Document</title> - <para> - <!-- this is a comment --> - <?php print 'Hi! This is PHP version '.phpversion(); ?> - </para> - </sect1> -</chapter> +<![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"> -<?xml version="1.0" ?> -<!DOCTYPE foo [ -<!ENTITY testEnt "test entity"> -?> -<foo> - <element attrib="value"?> - &testEnt; - <?php print "This is some more PHP code being executed."; ?> -</foo> +<![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écuté."; ?> +</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îne UTF-8 en ISO-8859.</refpurpose> + <refpurpose>Convertit une chaî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étails sur le codage <literal>UTF-8</literal>. + Voir aussi + <function>utf8_encode</function> + pour plus de dé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îne ISO-8859-1 en UTF-8.</refpurpose> + <refpurpose>Convertit une chaî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ée. <literal>UTF-8</literal> est un mécanisme standardisé utilisé par Unicode pour coder les caractère de grande - taille dans des flots d'octets. <literal>UTF-8</literal> est transparent + taille dans des flôts d'octets. <literal>UTF-8</literal> est transparent pour les caractères <abbrev>ASCII</abbrev>, il est auto-synchronisé (c'est à - dire qu'un programme peut toujours savoir dans un flot d'octet où + dire qu'un programme peut toujours savoir dans un flôt d'octet où un caractère commence), et peut être utilisé pour faire des comparaisons de chaînes standard, comme pour le tri. PHP utilise l'<literal>UTF-8</literal> pour coder les caractè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éro de colonne courante de la ligne courante de l'analyseur, qui correspond à 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>&values</parameter></methodparam> - <methodparam><type>array</type><parameter>&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>&values</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>&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énérée : <informalexample> <programlisting role="php"> -<?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); -?> +<![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'éxécution du code, l'affichage sera : <informalexample> <literallayout> <computeroutput> -Tableau d'index +<![CDATA[ +Tableau d'index Array ( - [PARA] => Array + [PARA] => Array ( - [0] => 0 - [1] => 2 + [0] => 0 + [1] => 2 ) - [NOTE] => Array + + [NOTE] => Array ( - [0] => 1 + [0] => 1 ) + ) -Tableau de valeurs + +Tableau de valeurs Array ( - [0] => Array + [0] => Array ( - [tag] => PARA - [type] => open - [level] => 1 + [tag] => PARA + [type] => open + [level] => 1 ) - [1] => Array + + [1] => Array ( - [tag] => NOTE - [type] => complete - [level] => 2 - [value] => simple note + [tag] => NOTE + [type] => complete + [level] => 2 + [value] => Simple Note ) - [2] => Array + + [2] => Array ( - [tag] => PARA - [type] => close - [level] => 1 + [tag] => PARA + [type] => close + [level] => 1 ) + ) - </computeroutput> +]]> </computeroutput> </literallayout> </informalexample> </para> @@ -98,21 +107,26 @@ <example> <title>moldb.xml - Petite base de données moléculaire</title> <programlisting role="xml"> -<?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> +<![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énère les @@ -123,32 +137,37 @@ d'objet moléculaires </title> <programlisting role="php"> -<?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é 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->$v) - $this->$k = $aa[$k]; + foreach ($aa as $k=>$v) + $this->$k = $aa[$k]; } } + function readDatabase($filename) { // read the xml database of aminoacids - $data = implode("",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,&$values,&$tags); + xml_parse_into_struct($parser,$data,$values,$tags); xml_parser_free($parser); - // parcourt les structures - foreach ($tags as $key->$val) { - if ($key == "molecule") { + + // loop through the structures + foreach ($tags as $key=>$val) { + if ($key == "molecule") { $molranges = $val; - // chaque paire contigue sont les définitions supérieures - // et inférieures de la molécule - for ($i=0; $i < 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 < count($mvalues); $i++) - $mol[$mvalues[$i]["tag"]] = $mvalues[$i]["value"]; + for ($i=0; $i < count($mvalues); $i++) + $mol[$mvalues[$i]["tag"]] = $mvalues[$i]["value"]; return new AminoAcid($mol); } -$db = readDatabase("moldb.xml"); + +$db = readDatabase("moldb.xml"); echo "** Database of AminoAcid objects:\n"; print_r($db); -?> + +?> +]]> </programlisting> </example> Après exé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] => aminoacid Object + [0] => aminoacid Object ( - [name] => Alanine - [symbol] => ala - [code] => A - [type] => hydrophobic - ) - [1] => aminoacid Object - ( - [name] => Lysine - [symbol] => lys - [code] => K - [type] => 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ées à analyser. Un document peut être analysé morceau par morceau, en appelant <function>xml_parse</function> plusieurs fois, tant que le - paramètre <parameter>isFinal</parameter> est mis à + paramètre <parameter>isfinal</parameter> est mis à &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ère partie @@ -50,7 +50,7 @@ <para> Lorsqu'un document XML est analysé, les gestionnaires d'événements sont appelés aussi souvent que - nécessaire, et retournent &true; ou <literal>FALSE</literal>. + nécessaire, et retournent &true; ou &false;. </para> <para> &true; est retourné lorsque l'analyse a été 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éation d'un analyseur XML.</refpurpose> + <refpurpose>Cré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ée un analyseur XML et + retourne une référence sur cet analyseur pour qu'il puisse + être utilisé ulté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ère de l'analyseur : les codages suivants + Le codage de caractère de l'analyseur. Les codages suivants sont supportés : <simplelist> <member><literal>ISO-8859-1</literal> (par défaut)</member> @@ -29,11 +34,11 @@ </listitem> </varlistentry> </variablelist> - <function>xml_parser_create</function> crée un analyseur XML et - retourne une référence sur cet analyseur pour qu'il puisse - être utilisé ulté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étruit un analyseur XML.</refpurpose> + <refpurpose> Dé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éférence valide, ou sinon, dé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éférence valide sur un analyseur XML, ou si l'option n'a pas pu être modifiée. Sinon, l'option est effectivement modifié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ô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 à 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ère bruts.</refpurpose> + <refpurpose>Affecte les gestionnaires de texte litté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ébut et de fin de l'analyseur XML + <function>xml_set_character_data_handler</function> + affecte les gestionnaires de début et de fin de l'analyseur XML <parameter>parser</parameter>. <parameter>handler</parameter> est une chaîne qui contient le nom d'une fonction qui existe lorsque <function>xml_parse</function> est appelé pour créer <parameter>parser</parameter>. </para> <para> - La fonction <parameter>handler</parameter> doit accepter deux paramè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è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çoit une chaîne vide ou <literal>FALSE</literal>, c'est + Si un gestionnaire reçoit une chaîne vide ou &false;, c'est qu'il est en train d'être désactivé. </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 à <function>xml_set_object</function> pour - utiliser l'analyseur XML depuis un objet. - </para> + ¬e.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éfaut.</refpurpose> + <refpurpose>Affecte le gestionnaire XML par dé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éfaut de l'analyseur XML + <function>xml_set_default_handler</function> + affecte le gestionnaire par défaut de l'analyseur XML <parameter>parser</parameter>. <parameter>handler</parameter> est une chaîne qui contient le nom d'une fonction qui existe lorsque <function>xml_parse</function> est appelé pour créer @@ -22,11 +23,11 @@ </para> <para> La fonction <parameter>handler</parameter> doit accepter deux paramè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çoit une chaîne vide ou <literal>FALSE</literal>, c'est + Si un gestionnaire reçoit une chaîne vide ou &false;, c'est qu'il est en train d'être désactivé. </para> <para> @@ -69,6 +70,7 @@ gestionnaire. Reportez-vous à <function>xml_set_object</function> pour utiliser l'analyseur XML depuis un objet. </para> + ¬e.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ébut et de fin.</refpurpose> + <refpurpose>Affecte les gestionnaires de dé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ébut et de fin de l'analyseur XML - <parameter>parser</parameter>. <parameter>startElementHandler</parameter> - et <parameter>endElementHandler</parameter> sont des chaînes qui + <parameter>parser</parameter>. <parameter>startelementhandler</parameter> + et <parameter>endelementhandler</parameter> sont des chaînes qui contiennent les noms de fonctions qui existent lorsque <function>xml_parse</function> est appelé pour créer <parameter>parser</parameter>. </para> <para> - La fonction <parameter>startElementHandler</parameter> doit + La fonction <parameter>startelementhandler</parameter> doit accepter trois paramè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è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çoit une chaîne vide, ou <literal>FALSE</literal>, + Si un gestionnaire reçoit une chaîne vide, ou &false;, c'est qu'il est en train d'être désactivé. </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 à <function>xml_set_object</function> pour - utiliser l'analyseur XML depuis un objet. - </para> + ¬e.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éférence externes.</refpurpose> + <refpurpose>Configure le gestionnaire XML de réfé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é externe de l'analyseur XML + <function>xml_set_external_entity_ref_handler</function> affecte + le gestionnaire d'entité externe de l'analyseur XML <parameter>parser</parameter>. <parameter>handler</parameter> et - <parameter>endElementHandler</parameter> sont des chaînes qui + <parameter>endelementhandler</parameter> sont des chaînes qui contiennent les noms de fonction qui existent lorsque <function>xml_parse</function> est appelé pour créer le <parameter>parser</parameter>. @@ -24,17 +25,17 @@ <para> La fonction <parameter>handler</parameter> doit accepter 5 paramètres, et retourner un entier. Si la valeur retourné 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ée), l'analyseur XML s'arrê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ème paramètre, <parameter>openEntityNames</parameter>, + Le deuxième paramètre, <parameter>openentitynames</parameter>, est la liste de noms d'entité, séparés par des espaces. Ces entités sont accessibles à l'analyse par cet entité (y compris le nom de l'entité reférencé). @@ -68,7 +69,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>systemId</parameter></term> + <term><parameter>systemid</parameter></term> <listitem> <simpara> Identifiant système pour cet entité externe. @@ -76,10 +77,10 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>publicId</parameter></term> + <term><parameter>publicid</parameter></term> <listitem> <simpara> - Le cinquième paramètre, <parameter>publicId</parameter>, + Le cinquième paramètre, <parameter>publicid</parameter>, est l'identifiant public, comme spécifié dans la déclaration d'entité, ou un chaîne vide, si aucune déclaration n'a été spécifiée. @@ -91,7 +92,7 @@ </variablelist> </para> <para> - Si un gestionnaire reçoit une chaîne vide, ou <literal>FALSE</literal>, + Si un gestionnaire reçoit une chaîne vide, ou &false;, c'est qu'il est en train d'être désactivé. </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 à <function>xml_set_object</function> pour - utiliser l'analyseur XML depuis un objet. - </para> + ¬e.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ébut et de fin de l'analyseur XML + <function>xml_set_notation_decl_handler</function> + affecte les gestionnaires de début et de fin de l'analyseur XML <parameter>parser</parameter>. <parameter>handler</parameter> est une chaîne qui contient le nom d'une fonction qui existe lorsque <function>xml_parse</function> est appelé pour créer @@ -23,8 +24,10 @@ <para> Une notation est une partie du DTD du document, qui a le format suivant : <programlisting role="xml"> -<!NOTATION <parameter>name</parameter> -{ <parameter>systemId</parameter> | <parameter>publicId</parameter>?> +<![CDATA[ +<!NOTATION <parameter>name</parameter> +{ <parameter>systemid</parameter> | <parameter>publicid</parameter>?> +]]> </programlisting> Reportez-vous à la section <ulink url="&url.rec-xml;#sec-external-ent">des spécifications XML 1.0</ulink> @@ -32,15 +35,15 @@ </para> <para> La fonction <parameter>handler</parameter> doit accepter cinq - paramè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è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ème pour cet entité 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çoit une chaîne vide ou <literal>FALSE</literal>, + Si un gestionnaire reçoit une chaîne vide ou &false;, c'est qu'il est en train d'être désactivé. </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 à <function>xml_set_object</function> pour - utiliser l'analyseur XML depuis un objet. - </para> + ¬e.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>&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éthodes de cet objet. </para> <programlisting role="php"> -<?php +<![CDATA[ +<?php class 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); -} -} // 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->parse("<A ID=\"bonjour\">PHP</?>"); -?> +$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écutables de l'analyseur + <function>xml_set_processing_instruction_handler</function> + affecte le gestionnaire d'instructions exécutables de l'analyseur XML <parameter>parser</parameter>. <parameter>handler</parameter> est une chaîne qui contient le nom d'une fonction qui existe lorsque <function>xml_parse</function> est appelé pour créer @@ -43,12 +44,12 @@ </para> <para> La fonction <parameter>handler</parameter> doit accepter trois paramè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çoit une chaîne vide, ou <literal>FALSE</literal>, + Si un gestionnaire reçoit une chaîne vide, ou &false;, c'est qu'il est en train d'être désactivé. </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 à <function>xml_set_object</function> pour - utiliser l'analyseur XML depuis un objet. - </para> + ¬e.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é non déclaré. + Affecte les gestionnaires d'entités non déclaré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é non déclaré de + <function>xml_set_unparsed_entity_decl_handler</function> + affecte les gestionnaires d'entité non déclaré de l'analyseur XML <parameter>parser</parameter>. <parameter>handler</parameter> est une chaîne qui contient le nom d'une fonction qui existe lorsque <function>xml_parse</function> est appelé pour créer @@ -27,8 +28,10 @@ déclaration d'entité externe avec une déclaration de NDATA, comme suit : <programlisting role="xml"> -<!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è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é qui va être définie @@ -76,7 +79,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>systemId</parameter></term> + <term><parameter>systemid</parameter></term> <listitem> <simpara> Identifiant système pour cet entité 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é 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é. (Voir @@ -103,7 +106,7 @@ </variablelist> </para> <para> - Si un gestionnaire reçoit une chaîne vide ou <literal>FALSE</literal>, + Si un gestionnaire reçoit une chaîne vide ou &false;, c'est qu'il est en train d'être désactivé. </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 à <function>xml_set_object</function> pour - utiliser l'analyseur XML depuis un objet. - </para> + ¬e.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é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ée un nouvel analyseur XML avec le support des espaces de noms, et retourne une ressource, qui pourra être utilisée avec les autres fonctions XML. </para> <para> Avec un analyseur qui supporte les espaces de noms, les balises qui sont passées aux différentes fonctions de gestion seront constituées du nom de l'espace et du nom de balise, séparé par la chaîne <parameter>seperator</parameter> ou par <literal>':'</literal>, par défaut. </para> <para> Le paramètre optionnel <parameter>encoding</parameter> spécifie le jeu de caractères que le XML doit traiter. Les jeux de caractères supportés sont <literal>"ISO-8859-1"</literal>, qui est aussi la valeur par dé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é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> ¬e.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è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> ¬e.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 -->