cvs: phpdoc /fr/functions xml.xml
| From: | Damien Seguy | Date: | Thu, 12 Jul 2001 12:14:07 +0000 |
| Subject: | cvs: phpdoc /fr/functions xml.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336201@lists.php.net to get a copy of this message | ||
dams Thu Jul 12 08:14:07 2001 EDT
Modified files:
/phpdoc/fr/functions xml.xml
Log:
Correcting all Jade/Docbook errors.Next build should go
Index: phpdoc/fr/functions/xml.xml diff -u phpdoc/fr/functions/xml.xml:1.7 phpdoc/fr/functions/xml.xml:1.8 --- phpdoc/fr/functions/xml.xml:1.7 Sat Jul 7 18:22:28 2001 +++ phpdoc/fr/functions/xml.xml Thu Jul 12 08:14:06 2001 @@ -34,23 +34,24 @@ <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 <option role="configure">--with-xml</option> + 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 - <option role="configure">--with-xml</option>, 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. + 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 ! + Compilez PHP. <emphasis>Tada!</emphasis> C'est fait ! </para> </sect2> <sect2 id="xml.about"> @@ -100,7 +101,7 @@ "Character data" correspond grosso modo à tout ce qui n'est pas une balise XML, y compris les espaces entre les balises. Notez bien que l'analyseur XML n'ajoute ou n'efface aucun espace, et que - c'est à l'application (c'est à dire vous) de + c'est à l'application (c'est-à-dire vous) de décider de la signification de ces espaces. </entry> </row> @@ -111,7 +112,7 @@ <entry> Les programmeurs PHP sont habitués aux instructions exécutables (processing instructions ou PIs). - <literal><?php ?></literal> est une instruction exécutable oú + <literal><?php ?></literal> est une instruction exécutable où php est appelé programme cible. Ces instructions sont gérées de manière spécifiques, (sauf le programme cible, qui est réservé à XML). @@ -149,7 +150,7 @@ <entry> Ce gestionnaire est appelé lorsque l'analyseur XML trouve une référence à un fichier externe. Cela peut - être un fichier, ou une URL. Reportez vous à + être un fichier, ou une URL. Reportez-vous à <link linkend="example.xml-external-entity">entité externe</link> pour un exemple. </entry> @@ -179,10 +180,10 @@ </para> </sect2> <sect2 id="xml.error-codes"> - <title>Error Codes</title> + <title>Codes d'erreurs</title> <para> - Les constantes suivantes sont définies comme des codes - d'erreurs XML : (retournée par <function>xml_parse</function>) + 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> @@ -212,56 +213,56 @@ <sect2 id="xml.encoding"> <title>Codage des caractères</title> <para> - L'extension XML de PHP supporte les caractères - <ulink url="&url.unicode;">Unicode</ulink> grâce à - différents codages. Il y a deux types de codages de - caractères : le codage à la source et le codage à - la cible. PHP utilise le <literal>UTF-8</literal> comme - représentation interne. + L'extension XML de PHP supporte les caractères + <ulink url="&url.unicode;">Unicode</ulink> grâce à + différents codages. Il y a deux types de codages de + caractères : le codage à la source et le codage à + la cible. PHP utilise le <literal>UTF-8</literal> comme + représentation interne. </para> <para> - L'encodage à la source est effectué lors de - <link linkend="function.xml-parse">l'analyse</link> du fichier par XML. - Lors de la <link linkend="function.xml-parser-create"> création - d'un analyseur XML</link>), un type de codage à la - source doit être spécifié (et il ne pourra plus - être modifié jusqu'à la destruction de - l'analyseur). Les codages supportés sont : - <literal>ISO-8859-1</literal>, <literal>US-ASCII</literal> et - <literal>UTF-8</literal>. Les deux derniers sont des codages - à un seul octet, c'est à dire que les caractères - sont représentés sur un seul octet. <literal>UTF-8</literal> - peut représenter des caractères composés par un - nombre variable de bits (jusqu'à 21), allant de 1 à - quatre octets. Le codage par défaut utilisé par PHP - <literal>ISO-8859-1</literal>. + L'encodage à la source est effectué lors de + <link linkend="function.xml-parse">l'analyse</link> du fichier par XML. + Lors de la <link linkend="function.xml-parser-create"> création + d'un analyseur XML</link>), un type de codage à la + source doit être spécifié (et il ne pourra plus + être modifié jusqu'à la destruction de + l'analyseur). Les codages supportés sont : + <literal>ISO-8859-1</literal>, <literal>US-ASCII</literal> et + <literal>UTF-8</literal>. Les deux derniers sont des codages + à un seul octet, c'est-à-dire que les caractères + sont représentés sur un seul octet. <literal>UTF-8</literal> + peut représenter des caractères composés par un + nombre variable de bits (jusqu'à 21), allant de 1 à + quatre octets. Le codage par défaut utilisé par PHP + <literal>ISO-8859-1</literal>. </para> <para> - Le codage à la cible est effectué lorsque PHP transfert - les données aux gestionnaires XML. Lorsqu'un analyseur est - créé, le codage à la cible est spécifié - de la même façon que le codage à la source, mais - il peut être modifié à tout moment. Le codage - à la cible affectera les balises, tout comme les - données brutes, et les noms des instructions exécutables. + Le codage à la cible est effectué lorsque PHP transfert + les données aux gestionnaires XML. Lorsqu'un analyseur est + créé, le codage à la cible est spécifié + de la même façon que le codage à la source, mais + il peut être modifié à tout moment. Le codage + à la cible affectera les balises, tout comme les + données brutes, et les noms des instructions exécutables. </para> <para> - Si l'analyseur XML rencontre un caractère qu'il ne - connaît pas (hors limite, par exemple), il retournera une erreur. + Si l'analyseur XML rencontre un caractère qu'il ne + connaît pas (hors limite, par exemple), il retournera une erreur. </para> <para> - Si PHP rencontre un caractère dans le document XML analysé, - qu'il ne peut pas représenter dans le codage à la cible - choisi, le caractère sera remplacé par un point - d'interrogation (cette attitude est suceptible de changer - ultérieurement). + Si PHP rencontre un caractère dans le document XML analysé, + qu'il ne peut pas représenter dans le codage à la cible + choisi, le caractère sera remplacé par un point + d'interrogation (cette attitude est susceptible de changer + ultérieurement). </para> </sect2> </sect1> <sect1 id="xml.examples"> <title>Quelques exemples</title> <para> - Voici une liste d'exemple de code PHP qui analyse un document XML. + Voici une liste d'exemple de code PHP qui analyse un document XML. </para> <sect2 id="example.xml-structure"> <title>Exemple de structure XML</title> @@ -339,7 +340,7 @@ } $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, <literal>TRUE</literal>); +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"))) { @@ -360,23 +361,23 @@ </para> </sect2> <sect2 id="example.xml-external-entity"> - <title>XML Entitée externe</title> + <title>XML Entité externe</title> <para> - Cet exemple exploite les références externes de XML : - il est possible d'utiliser un gestionnaire d'entité externe - pour inclure et analyser les documents, tous comme les instructions - exécutables peuvent servir à inclure et analyser - d'autres documents, et aussi fournir une indication de confiance - (voir plus bas). + Cet exemple exploite les références externes de XML : + il est possible d'utiliser un gestionnaire d'entité externe + pour inclure et analyser les documents, tous comme les instructions + exécutables peuvent servir à inclure et analyser + d'autres documents, et aussi fournir une indication de confiance + (voir plus bas). </para> <para> - Le document XML qui est utilisé dans cet exemple est fourni plus - loin dans l'exemple (<filename>xmltest.xml</filename> et - <filename>xmltest2.xml</filename>). + Le document XML qui est utilisé dans cet exemple est fourni plus + loin dans l'exemple (<filename>xmltest.xml</filename> et + <filename>xmltest2.xml</filename>). </para> <para> <example> - <title>Entitée externe</title> + <title>Entité externe</title> <programlisting role="php"> <?php $file = "xmltest.xml"; @@ -384,9 +385,9 @@ // only trust local files owned by ourselves if (!eregi("^([a-z]+)://", $file) && fileowner($file) == getmyuid()) { - return <literal>TRUE</literal>; + return TRUE; } - return <literal>FALSE</literal>; + return FALSE; } function startElement($parser, $name, $attribs) { print "&lt;<font color=\"#0000cc\">$name</font>"; @@ -435,7 +436,7 @@ if (!list($parser, $fp) = new_xml_parser($systemId)) { printf("Could not open entity %s at %s\n", $openEntityNames, $systemId); - return <literal>FALSE</literal>; + return FALSE; } while ($data = fread($fp, 4096)) { if (!xml_parse($parser, $data, feof($fp))) { @@ -443,13 +444,13 @@ xml_error_string(xml_get_error_code($parser)), xml_get_current_line_number($parser), $openEntityNames); xml_parser_free($parser); - return <literal>FALSE</literal>; + return FALSE; } } xml_parser_free($parser); - return <literal>TRUE</literal>; + return TRUE; } - return <literal>FALSE</literal>; + return FALSE; } function new_xml_parser($file) { global $parser_file; @@ -461,7 +462,7 @@ xml_set_default_handler($xml_parser, "defaultHandler"); xml_set_external_entity_ref_handler($xml_parser, "externalEntityRefHandler"); if (!($fp = @fopen($file, "r"))) { - return <literal>FALSE</literal>; + return FALSE; } if (!is_array($parser_file)) { settype($parser_file, "array"); @@ -487,7 +488,7 @@ </programlisting> </example> </para> - <para id="example.xml-xmltest.xml"> + <para> <example> <title>xmltest.xml</title> <programlisting role="xml"> @@ -521,8 +522,8 @@ </programlisting> </example> </para> - <para id="example.xml-xmltest2.xml"> - This file is included from <filename>xmltest.xml</filename>: + <para> + Ce fichier est inclus depuis <filename>xmltest.xml</filename>: <example> <title>xmltest2.xml</title> <programlisting role="xml"> @@ -573,10 +574,11 @@ </listitem> </varlistentry> </variablelist> - Cette fonction crée un analyseur XML et retourne une - référence sur cet analyseur pour qu'il puisse + <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. Retourne &false; en cas d'erreur. + fonctions XML. <function>xml_parser_create</function> retourne + <literal>FALSE</literal> en cas d'erreur. </para> </refsect1> </refentry> @@ -597,10 +599,10 @@ </funcprototype> </funcsynopsis> <para> - Cette fonction rend l'analyseur <parameter>parser</parameter> utilisable - depuis un objet. Toutes les méthodes de callback, affectées - par <function>xml_set_element_handler</function>, seront les méthodes - de cet objet. + <function>xml_set_object</function> rend l'analyseur <parameter>parser</parameter> + utilisable depuis un objet. Toutes les méthodes de callback, + affectées par <function>xml_set_element_handler</function>, + seront les méthodes de cet objet. </para> <programlisting role="php"> <?php @@ -662,8 +664,8 @@ <parameter>parser</parameter>. </para> <para> - La fonction <parameter>startElementHandler</parameter> doit - accepter trois paramètres: + La fonction <parameter>startElementHandler</parameter> doit + accepter trois paramètres: <funcsynopsis> <funcprototype> <funcdef><replaceable>startElementHandler</replaceable></funcdef> @@ -700,7 +702,7 @@ <simpara> Le troisième paramètre, <parameter>attribs</parameter>, contient un tableau associatif avec les attributs de - l'éléments (si il en existe). Les clés de ce tableau + l'éléments (s'il en existe). Les clés de ce tableau seront les noms des attributs, et les valeurs seront les valeurs correspondantes des attributs. Les noms des attributs seront mis en majuscule si l'analyseur gère la @@ -752,17 +754,17 @@ </variablelist> </para> <para> - Si un gestionnaire recoit une chaîne vide, ou &false;, + Si un gestionnaire reçoit une chaîne vide, ou <literal>FALSE</literal>, c'est qu'il est en train d'être désactivé. </para> <para> - <function>xml_set_element_handler</function> retourne &true; - si le gestionnaire est actif, et &false; sinon, ou si + <function>xml_set_element_handler</function> retourne <literal>TRUE</literal> + si le gestionnaire est actif, et <literal>FALSE</literal> 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 + gestionnaire. Reportez-vous à <function>xml_set_object</function> pour utiliser l'analyseur XML depuis un objet. </para> </refsect1> @@ -821,17 +823,19 @@ </variablelist> </para> <para> - Si un gestionnaire reçoit une chaîne vide ou &false;, c'est + Si un gestionnaire reçoit une chaîne vide ou <literal>FALSE</literal>, c'est qu'il est en train d'être désactivé. </para> <para> - Retourne &true; si le gestionnaire est actif, et &false; sinon, ou si - <parameter>parser</parameter> n'est pas un analyseur. + <function>xml_set_character_data_handler</function> retourne + <literal>TRUE</literal> si le gestionnaire est actif, et + <literal>FALSE</literal> 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. + 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> </refsect1> </refentry> @@ -869,15 +873,15 @@ <replaceable>data</replaceable> </programlisting> </informalexample> - Vous pouvez mettre du code PHP entre ces balises, mais soyez conscient d'une - des limitations des instructions exécutables de XML : la balise - de fin d'instruction éxécutable (<literal>?></literal>) - ne peut être échappée, ce qui fait que cette - séquence NE DOIT JAMAIS apparaître dans le code PHP - placé dans le document PHP. Si un tel texte apparaît, - la balise de fin d'instruction exécutable sera reconnue, et - le reste du code sera considéré comme des données - brutes (et donc, pas exécutées). + Vous pouvez mettre du code PHP entre ces balises, mais soyez conscient d'une + des limitations des instructions exécutables de XML : la balise + de fin d'instruction exécutable (<literal>?></literal>) + ne peut être échappée, ce qui fait que cette + séquence NE DOIT JAMAIS apparaître dans le code PHP + placé dans le document PHP. Si un tel texte apparaît, + la balise de fin d'instruction exécutable sera reconnue, et + le reste du code sera considéré comme des données + brutes (et donc, pas exécutées). </para> <para> La fonction <parameter>handler</parameter> doit accepter trois paramètres: @@ -918,17 +922,19 @@ </variablelist> </para> <para> - Si un gestionnaire reçoit une chaîne vide, ou &false;, - c'est qu'il est en train d'être désactivé. + Si un gestionnaire reçoit une chaîne vide, ou <literal>FALSE</literal>, + c'est qu'il est en train d'être désactivé. </para> <para> - Retourne &true; si le gestionnaire est actif, et &false; sinon, ou si - <parameter>parser</parameter> n'est pas un analyseur. + <function>xml_set_processing_instruction_handler</function> retourne + <literal>TRUE</literal> si le gestionnaire est actif, et + <literal>FALSE</literal> 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. + 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> </refsect1> </refentry> @@ -992,17 +998,19 @@ </variablelist> </para> <para> - Si un gestionnaire reçoit une chaîne vide ou &false;, c'est + Si un gestionnaire reçoit une chaîne vide ou <literal>FALSE</literal>, c'est qu'il est en train d'être désactivé. </para> <para> - Retourne &true; si le gestionnaire est actif, et &false; sinon, ou si - <parameter>parser</parameter> n'est pas un analyseur. + <function>xml_set_default_handler</function> retourne + <literal>TRUE</literal> si le gestionnaire est actif, et + <literal>FALSE</literal> 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. + 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> </refsect1> </refentry> @@ -1041,7 +1049,7 @@ </programlisting> </para> <para> - Reportez vous à la section + Reportez-vous à la section <ulink url="&url.rec-xml;#sec-external-ent">des spécifications XML 1.0</ulink> pour connaître les notations des entités externes. </para> @@ -1072,7 +1080,7 @@ <term><parameter>entityName</parameter></term> <listitem> <simpara> - Le nom de l'entitée qui va être définie + Le nom de l'entité qui va être définie </simpara> </listitem> </varlistentry> @@ -1114,17 +1122,19 @@ </variablelist> </para> <para> - Si un gestionnaire reçoit une chaîne vide ou &false;, - c'est qu'il est en train d'être désactivé. + Si un gestionnaire reçoit une chaîne vide ou <literal>FALSE</literal>, + c'est qu'il est en train d'être désactivé. </para> <para> - Retourne &true; si le gestionnaire est actif, et &false; sinon, ou si - <parameter>parser</parameter> n'est pas un analyseur. + <function>xml_set_unparsed_entity_decl_handler</function> retourne + <literal>TRUE</literal> si le gestionnaire est actif, et + <literal>FALSE</literal> 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. + 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> </refsect1> </refentry> @@ -1157,7 +1167,7 @@ <!NOTATION <parameter>name</parameter> { <parameter>systemId</parameter> | <parameter>publicId</parameter>?> </programlisting> - Reportez vous à la section + Reportez-vous à la section <ulink url="&url.rec-xml;#sec-external-ent">des spécifications XML 1.0</ulink> pour connaître les notations des entités externes. </para> @@ -1191,7 +1201,7 @@ <listitem> <simpara> Le nom de la notation,<parameter>name</parameter>, comme - précisé dans le format de notation ci dessus. + précisé dans le format de notation ci-dessus. </simpara> </listitem> </varlistentry> @@ -1211,7 +1221,7 @@ <term><parameter>systemId</parameter></term> <listitem> <simpara> - Identifiant système pour cette entitée externe. + Identifiant système pour cet entité externe. </simpara> </listitem> </varlistentry> @@ -1228,25 +1238,26 @@ </variablelist> </para> <para> - Si un gestionnaire reçoit une chaîne vide ou &false;, + Si un gestionnaire reçoit une chaîne vide ou <literal>FALSE</literal>, c'est qu'il est en train d'être désactivé. </para> <para> - Retourne &true; si le gestionnaire est actif, et - &false; sinon ou si - <parameter>parser</parameter> n'est pas un analyseur. + <function>xml_set_notation_decl_handler</function> retourne + <literal>TRUE</literal> si le gestionnaire est actif, et + <literal>FALSE</literal> 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. + 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> </refsect1> </refentry> <refentry id="function.xml-set-external-entity-ref-handler"> <refnamediv> <refname>xml_set_external_entity_ref_handler</refname> - <refpurpose>Fixe le gestionnaire de référence externes.</refpurpose> + <refpurpose>Modifie le gestionnaire de référence externes.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1270,7 +1281,7 @@ <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 <literal>FALSE</literal> (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>. @@ -1301,7 +1312,7 @@ <listitem> <simpara> Le deuxième paramètre, <parameter>openEntityNames</parameter>, - est i.e. liste de noms d'entité, séparés par des + 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é). </simpara> @@ -1341,18 +1352,19 @@ </variablelist> </para> <para> - Si un gestionnaire reçoit une chaîne vide, ou &false;, + Si un gestionnaire reçoit une chaîne vide, ou <literal>FALSE</literal>, c'est qu'il est en train d'être désactivé. </para> <para> - Retourne &true; si le gestionnaire est actif, et - &false; sinon ou si <parameter>parser</parameter> - n'est pas un analyseur. + <function>xml_set_external_entity_ref_handler</function> retourne + <literal>TRUE</literal> si le gestionnaire est actif, et + <literal>FALSE</literal> 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. + 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> </refsect1> </refentry> @@ -1391,7 +1403,7 @@ être analysé morceau par morceau, en appelant <function>xml_parse</function> plusieurs fois, tant que le paramètre <parameter>isFinal</parameter> est mis à - &true; pour le dernier morceau. + <literal>TRUE</literal> pour le dernier morceau. </simpara> </listitem> </varlistentry> @@ -1399,7 +1411,7 @@ <term><parameter>isFinal</parameter> (optional)</term> <listitem> <simpara> - Si il vaut &true;, <parameter>data</parameter> est la dernière partie + S'il vaut <literal>TRUE</literal>, <parameter>data</parameter> est la dernière partie à analyser. </simpara> </listitem> @@ -1409,11 +1421,11 @@ <para> Lorsqu'un document XML est analysé, les gestionnaires d'événements sont appelés aussi souvent que - nécessaire, et retournent &true; ou &false;. + nécessaire, et retournent <literal>TRUE</literal> ou <literal>FALSE</literal>. </para> <para> - &true; est retourné lorsque l'analyse a été concluante, - et &false; en cas d'échec, ou si <parameter>parser</parameter> n'est pas + <literal>TRUE</literal> est retourné lorsque l'analyse a été concluante, + et <literal>FALSE</literal> en cas d'échec, ou si <parameter>parser</parameter> n'est pas un analyseur valide. Lors d'un échec d'analyse, la cause de l'erreur peut être obtenue grâce aux fonctions <function>xml_get_error_code</function>, <function>xml_error_string</function>, @@ -1437,25 +1449,10 @@ </funcprototype> </funcsynopsis> <para> - <variablelist> - <varlistentry> - <term><parameter>parser</parameter></term> - <listitem> - <simpara> - Cette fonction 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. - </simpara> - </listitem> - </varlistentry> - </variablelist> - </para> - <para> - Cette fonction 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. + <function>xml_get_error_code</function> retourne <literal>FALSE</literal> + 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. </para> </refsect1> </refentry> @@ -1485,9 +1482,10 @@ </variablelist> </para> <para> - Retourne la chaîne avec un message textuel, décrivant l'erreur - <parameter>code</parameter>, ou &false; si aucune description n'a - été trouvée. + <function>xml_error_string</function> retourne la chaîne avec + un message textuel, décrivant l'erreur <parameter>code</parameter>, + ou <literal>FALSE</literal> si aucune description n'a été + trouvée. </para> </refsect1> </refentry> @@ -1495,16 +1493,14 @@ <refnamediv> <refname>xml_get_current_line_number</refname> <refpurpose> - Retourne le numéro de ligne courant d'un analyseur XML. + Retourne le numéro de ligne courant d'un analyseur XML. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int - <function>xml_get_current_line_number</function> - </funcdef> + <funcdef>int <function>xml_get_current_line_number</function></funcdef> <paramdef>resource <parameter>parser</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -1521,9 +1517,10 @@ </variablelist> </para> <para> - Cette fonction retourne &false; si <parameter>parser</parameter> n'est - pas valide, ou sinon, retourne le numéro de la ligne en cours - d'analyse. + <function>xml_get_current_line_number</function> retourne + <literal>FALSE</literal> si <parameter>parser</parameter> n'est + pas valide, ou sinon, retourne le numéro de la ligne en cours + d'analyse. </para> </refsect1> </refentry> @@ -1532,15 +1529,13 @@ <refname>xml_get_current_column_number</refname> <refpurpose> Retourne le nombre courant de colonne d'un analyseur XML. - .</refpurpose> + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int - <function>xml_get_current_column_number</function> - </funcdef> + <funcdef>int <function>xml_get_current_column_number</function></funcdef> <paramdef>resource <parameter>parser</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -1550,17 +1545,18 @@ <term><parameter>parser</parameter></term> <listitem> <simpara> - Une référence sur un analyseur XML valide. + Une référence sur un analyseur XML valide. </simpara> </listitem> </varlistentry> </variablelist> </para> <para> - Cette fonction 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. + <function>xml_get_current_column_number</function> retourne + <literal>FALSE</literal> 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. </para> </refsect1> </refentry> @@ -1573,9 +1569,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int - <function>xml_get_current_byte_index</function> - </funcdef> + <funcdef>int <function>xml_get_current_byte_index</function></funcdef> <paramdef>resource <parameter>parser</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -1585,16 +1579,17 @@ <term><parameter>parser</parameter></term> <listitem> <simpara> - Une référence sur un analyseur XML valide. + Une référence sur un analyseur XML valide. </simpara> </listitem> </varlistentry> </variablelist> </para> <para> - Cette fonction retourne &false; si <parameter>parser</parameter> n'est pas - valide, ou sinon, retourne l'index de l'octet d'analyse courante de - l'analyseur XML. + <function>xml_get_current_byte_index</function> retourne + <literal>FALSE</literal> si <parameter>parser</parameter> n'est pas + valide, ou sinon, retourne l'index de l'octet d'analyse courante de + l'analyseur XML. </para> </refsect1> </refentry> @@ -1623,7 +1618,7 @@ passés par références. </para> <para> - Ci dessous, vous trouverez un exemple qui illustre la structure + Ci-dessous, vous trouverez un exemple qui illustre la structure des deux tableaux générés par la fonction. On utilise une balise simple <literal>note</literal>, placée dans une autre balise <literal>para</literal>. On analyse le tout, et on @@ -1687,9 +1682,10 @@ </informalexample> </para> <para> - L'analyse événementielle (comme celle de expat), peut se révéler - complexe lorsque le document XML est complexe. Cette fonction ne - génère pas d'objet de type DOM, mais il génère plutôt des + L'analyse événementielle (comme celle de expat), peut se + révéler complexe lorsque le document XML est complexe. + <function>xml_parse_into_struct</function> ne génère pas + d'objet de type DOM, mais il génère plutôt des structures qui peuvent être parcourues à la façon d'un arbre. Considérons le fichier suivant, qui représente une petite base de données XML : @@ -1807,7 +1803,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>string <function>xml_parser_free</function></funcdef> + <funcdef>boolean <function>xml_parser_free</function></funcdef> <paramdef>resource <parameter>parser</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -1824,9 +1820,9 @@ </variablelist> </para> <para> - Cette fonction retourne &false; si <parameter>parser</parameter> - n'est pas une référence valide, ou sinon, détruit - l'analyseur et retourne &true;. + <function>xml_parser_free</function> retourne <literal>FALSE</literal> + si <parameter>parser</parameter> n'est pas une référence + valide, ou sinon, détruit l'analyseur et retourne <literal>TRUE</literal>. </para> </refsect1> </refentry> @@ -1859,7 +1855,7 @@ <term><parameter>option</parameter></term> <listitem> <simpara> - L'option à modifier. Voir ci dessous : + L'option à modifier. Voir ci-dessous : </simpara> </listitem> </varlistentry> @@ -1874,10 +1870,11 @@ </variablelist> </para> <para> - Cette fonction 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 &true;. + <function>xml_parser_set_option</function> retourne <literal>FALSE</literal> + 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 + <literal>TRUE</literal>. </para> <para> Les options suivantes sont disponibles : @@ -1948,7 +1945,7 @@ <term><parameter>option</parameter></term> <listitem> <simpara> - L'option demandée. Reportez vous à + L'option demandée. Reportez-vous à <function>xml_parser_set_option</function> pour avoir la liste des options disponibles. </simpara> @@ -1957,12 +1954,12 @@ </variablelist> </para> <para> - <function>xml_parser_get_option</function> retourne &false; si + <function>xml_parser_get_option</function> retourne <literal>FALSE</literal> si <parameter>parser</parameter> n'est pas valide, ou sinon, retourne la valeur de l'option demandée. </para> <para> - Reportez vous à <function>xml_parser_set_option</function> pour avoir la + Reportez-vous à <function>xml_parser_set_option</function> pour avoir la liste des options disponibles. </para> </refsect1> @@ -1970,7 +1967,7 @@ <refentry id="function.utf8-decode"> <refnamediv> <refname>utf8_decode</refname> - <refpurpose>Convertit un 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> @@ -1995,7 +1992,7 @@ <refentry id="function.utf8-encode"> <refnamediv> <refname>utf8_encode</refname> - <refpurpose>Convertit un 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> @@ -2013,7 +2010,7 @@ taille dans des flots 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 flot 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/functions/xml.xml diff -u phpdoc/fr/functions/xml.xml:1.7 phpdoc/fr/functions/xml.xml:1.8 --- phpdoc/fr/functions/xml.xml:1.7 Sat Jul 7 18:22:28 2001 +++ phpdoc/fr/functions/xml.xml Thu Jul 12 08:14:06 2001 @@ -34,23 +34,24 @@ <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 <option role="configure">--with-xml</option> + 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 - <option role="configure">--with-xml</option>, 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. + 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 ! + Compilez PHP. <emphasis>Tada!</emphasis> C'est fait ! </para> </sect2> <sect2 id="xml.about"> @@ -100,7 +101,7 @@ "Character data" correspond grosso modo à tout ce qui n'est pas une balise XML, y compris les espaces entre les balises. Notez bien que l'analyseur XML n'ajoute ou n'efface aucun espace, et que - c'est à l'application (c'est à dire vous) de + c'est à l'application (c'est-à-dire vous) de décider de la signification de ces espaces. </entry> </row> @@ -111,7 +112,7 @@ <entry> Les programmeurs PHP sont habitués aux instructions exécutables (processing instructions ou PIs). - <literal><?php ?></literal> est une instruction exécutable oú + <literal><?php ?></literal> est une instruction exécutable où php est appelé programme cible. Ces instructions sont gérées de manière spécifiques, (sauf le programme cible, qui est réservé à XML). @@ -149,7 +150,7 @@ <entry> Ce gestionnaire est appelé lorsque l'analyseur XML trouve une référence à un fichier externe. Cela peut - être un fichier, ou une URL. Reportez vous à + être un fichier, ou une URL. Reportez-vous à <link linkend="example.xml-external-entity">entité externe</link> pour un exemple. </entry> @@ -179,10 +180,10 @@ </para> </sect2> <sect2 id="xml.error-codes"> - <title>Error Codes</title> + <title>Codes d'erreurs</title> <para> - Les constantes suivantes sont définies comme des codes - d'erreurs XML : (retournée par <function>xml_parse</function>) + 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> @@ -212,56 +213,56 @@ <sect2 id="xml.encoding"> <title>Codage des caractères</title> <para> - L'extension XML de PHP supporte les caractères - <ulink url="&url.unicode;">Unicode</ulink> grâce à - différents codages. Il y a deux types de codages de - caractères : le codage à la source et le codage à - la cible. PHP utilise le <literal>UTF-8</literal> comme - représentation interne. + L'extension XML de PHP supporte les caractères + <ulink url="&url.unicode;">Unicode</ulink> grâce à + différents codages. Il y a deux types de codages de + caractères : le codage à la source et le codage à + la cible. PHP utilise le <literal>UTF-8</literal> comme + représentation interne. </para> <para> - L'encodage à la source est effectué lors de - <link linkend="function.xml-parse">l'analyse</link> du fichier par XML. - Lors de la <link linkend="function.xml-parser-create"> création - d'un analyseur XML</link>), un type de codage à la - source doit être spécifié (et il ne pourra plus - être modifié jusqu'à la destruction de - l'analyseur). Les codages supportés sont : - <literal>ISO-8859-1</literal>, <literal>US-ASCII</literal> et - <literal>UTF-8</literal>. Les deux derniers sont des codages - à un seul octet, c'est à dire que les caractères - sont représentés sur un seul octet. <literal>UTF-8</literal> - peut représenter des caractères composés par un - nombre variable de bits (jusqu'à 21), allant de 1 à - quatre octets. Le codage par défaut utilisé par PHP - <literal>ISO-8859-1</literal>. + L'encodage à la source est effectué lors de + <link linkend="function.xml-parse">l'analyse</link> du fichier par XML. + Lors de la <link linkend="function.xml-parser-create"> création + d'un analyseur XML</link>), un type de codage à la + source doit être spécifié (et il ne pourra plus + être modifié jusqu'à la destruction de + l'analyseur). Les codages supportés sont : + <literal>ISO-8859-1</literal>, <literal>US-ASCII</literal> et + <literal>UTF-8</literal>. Les deux derniers sont des codages + à un seul octet, c'est-à-dire que les caractères + sont représentés sur un seul octet. <literal>UTF-8</literal> + peut représenter des caractères composés par un + nombre variable de bits (jusqu'à 21), allant de 1 à + quatre octets. Le codage par défaut utilisé par PHP + <literal>ISO-8859-1</literal>. </para> <para> - Le codage à la cible est effectué lorsque PHP transfert - les données aux gestionnaires XML. Lorsqu'un analyseur est - créé, le codage à la cible est spécifié - de la même façon que le codage à la source, mais - il peut être modifié à tout moment. Le codage - à la cible affectera les balises, tout comme les - données brutes, et les noms des instructions exécutables. + Le codage à la cible est effectué lorsque PHP transfert + les données aux gestionnaires XML. Lorsqu'un analyseur est + créé, le codage à la cible est spécifié + de la même façon que le codage à la source, mais + il peut être modifié à tout moment. Le codage + à la cible affectera les balises, tout comme les + données brutes, et les noms des instructions exécutables. </para> <para> - Si l'analyseur XML rencontre un caractère qu'il ne - connaît pas (hors limite, par exemple), il retournera une erreur. + Si l'analyseur XML rencontre un caractère qu'il ne + connaît pas (hors limite, par exemple), il retournera une erreur. </para> <para> - Si PHP rencontre un caractère dans le document XML analysé, - qu'il ne peut pas représenter dans le codage à la cible - choisi, le caractère sera remplacé par un point - d'interrogation (cette attitude est suceptible de changer - ultérieurement). + Si PHP rencontre un caractère dans le document XML analysé, + qu'il ne peut pas représenter dans le codage à la cible + choisi, le caractère sera remplacé par un point + d'interrogation (cette attitude est susceptible de changer + ultérieurement). </para> </sect2> </sect1> <sect1 id="xml.examples"> <title>Quelques exemples</title> <para> - Voici une liste d'exemple de code PHP qui analyse un document XML. + Voici une liste d'exemple de code PHP qui analyse un document XML. </para> <sect2 id="example.xml-structure"> <title>Exemple de structure XML</title> @@ -339,7 +340,7 @@ } $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, <literal>TRUE</literal>); +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"))) { @@ -360,23 +361,23 @@ </para> </sect2> <sect2 id="example.xml-external-entity"> - <title>XML Entitée externe</title> + <title>XML Entité externe</title> <para> - Cet exemple exploite les références externes de XML : - il est possible d'utiliser un gestionnaire d'entité externe - pour inclure et analyser les documents, tous comme les instructions - exécutables peuvent servir à inclure et analyser - d'autres documents, et aussi fournir une indication de confiance - (voir plus bas). + Cet exemple exploite les références externes de XML : + il est possible d'utiliser un gestionnaire d'entité externe + pour inclure et analyser les documents, tous comme les instructions + exécutables peuvent servir à inclure et analyser + d'autres documents, et aussi fournir une indication de confiance + (voir plus bas). </para> <para> - Le document XML qui est utilisé dans cet exemple est fourni plus - loin dans l'exemple (<filename>xmltest.xml</filename> et - <filename>xmltest2.xml</filename>). + Le document XML qui est utilisé dans cet exemple est fourni plus + loin dans l'exemple (<filename>xmltest.xml</filename> et + <filename>xmltest2.xml</filename>). </para> <para> <example> - <title>Entitée externe</title> + <title>Entité externe</title> <programlisting role="php"> <?php $file = "xmltest.xml"; @@ -384,9 +385,9 @@ // only trust local files owned by ourselves if (!eregi("^([a-z]+)://", $file) && fileowner($file) == getmyuid()) { - return <literal>TRUE</literal>; + return TRUE; } - return <literal>FALSE</literal>; + return FALSE; } function startElement($parser, $name, $attribs) { print "&lt;<font color=\"#0000cc\">$name</font>"; @@ -435,7 +436,7 @@ if (!list($parser, $fp) = new_xml_parser($systemId)) { printf("Could not open entity %s at %s\n", $openEntityNames, $systemId); - return <literal>FALSE</literal>; + return FALSE; } while ($data = fread($fp, 4096)) { if (!xml_parse($parser, $data, feof($fp))) { @@ -443,13 +444,13 @@ xml_error_string(xml_get_error_code($parser)), xml_get_current_line_number($parser), $openEntityNames); xml_parser_free($parser); - return <literal>FALSE</literal>; + return FALSE; } } xml_parser_free($parser); - return <literal>TRUE</literal>; + return TRUE; } - return <literal>FALSE</literal>; + return FALSE; } function new_xml_parser($file) { global $parser_file; @@ -461,7 +462,7 @@ xml_set_default_handler($xml_parser, "defaultHandler"); xml_set_external_entity_ref_handler($xml_parser, "externalEntityRefHandler"); if (!($fp = @fopen($file, "r"))) { - return <literal>FALSE</literal>; + return FALSE; } if (!is_array($parser_file)) { settype($parser_file, "array"); @@ -487,7 +488,7 @@ </programlisting> </example> </para> - <para id="example.xml-xmltest.xml"> + <para> <example> <title>xmltest.xml</title> <programlisting role="xml"> @@ -521,8 +522,8 @@ </programlisting> </example> </para> - <para id="example.xml-xmltest2.xml"> - This file is included from <filename>xmltest.xml</filename>: + <para> + Ce fichier est inclus depuis <filename>xmltest.xml</filename>: <example> <title>xmltest2.xml</title> <programlisting role="xml"> @@ -573,10 +574,11 @@ </listitem> </varlistentry> </variablelist> - Cette fonction crée un analyseur XML et retourne une - référence sur cet analyseur pour qu'il puisse + <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. Retourne &false; en cas d'erreur. + fonctions XML. <function>xml_parser_create</function> retourne + <literal>FALSE</literal> en cas d'erreur. </para> </refsect1> </refentry> @@ -597,10 +599,10 @@ </funcprototype> </funcsynopsis> <para> - Cette fonction rend l'analyseur <parameter>parser</parameter> utilisable - depuis un objet. Toutes les méthodes de callback, affectées - par <function>xml_set_element_handler</function>, seront les méthodes - de cet objet. + <function>xml_set_object</function> rend l'analyseur <parameter>parser</parameter> + utilisable depuis un objet. Toutes les méthodes de callback, + affectées par <function>xml_set_element_handler</function>, + seront les méthodes de cet objet. </para> <programlisting role="php"> <?php @@ -662,8 +664,8 @@ <parameter>parser</parameter>. </para> <para> - La fonction <parameter>startElementHandler</parameter> doit - accepter trois paramètres: + La fonction <parameter>startElementHandler</parameter> doit + accepter trois paramètres: <funcsynopsis> <funcprototype> <funcdef><replaceable>startElementHandler</replaceable></funcdef> @@ -700,7 +702,7 @@ <simpara> Le troisième paramètre, <parameter>attribs</parameter>, contient un tableau associatif avec les attributs de - l'éléments (si il en existe). Les clés de ce tableau + l'éléments (s'il en existe). Les clés de ce tableau seront les noms des attributs, et les valeurs seront les valeurs correspondantes des attributs. Les noms des attributs seront mis en majuscule si l'analyseur gère la @@ -752,17 +754,17 @@ </variablelist> </para> <para> - Si un gestionnaire recoit une chaîne vide, ou &false;, + Si un gestionnaire reçoit une chaîne vide, ou <literal>FALSE</literal>, c'est qu'il est en train d'être désactivé. </para> <para> - <function>xml_set_element_handler</function> retourne &true; - si le gestionnaire est actif, et &false; sinon, ou si + <function>xml_set_element_handler</function> retourne <literal>TRUE</literal> + si le gestionnaire est actif, et <literal>FALSE</literal> 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 + gestionnaire. Reportez-vous à <function>xml_set_object</function> pour utiliser l'analyseur XML depuis un objet. </para> </refsect1> @@ -821,17 +823,19 @@ </variablelist> </para> <para> - Si un gestionnaire reçoit une chaîne vide ou &false;, c'est + Si un gestionnaire reçoit une chaîne vide ou <literal>FALSE</literal>, c'est qu'il est en train d'être désactivé. </para> <para> - Retourne &true; si le gestionnaire est actif, et &false; sinon, ou si - <parameter>parser</parameter> n'est pas un analyseur. + <function>xml_set_character_data_handler</function> retourne + <literal>TRUE</literal> si le gestionnaire est actif, et + <literal>FALSE</literal> 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. + 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> </refsect1> </refentry> @@ -869,15 +873,15 @@ <replaceable>data</replaceable> </programlisting> </informalexample> - Vous pouvez mettre du code PHP entre ces balises, mais soyez conscient d'une - des limitations des instructions exécutables de XML : la balise - de fin d'instruction éxécutable (<literal>?></literal>) - ne peut être échappée, ce qui fait que cette - séquence NE DOIT JAMAIS apparaître dans le code PHP - placé dans le document PHP. Si un tel texte apparaît, - la balise de fin d'instruction exécutable sera reconnue, et - le reste du code sera considéré comme des données - brutes (et donc, pas exécutées). + Vous pouvez mettre du code PHP entre ces balises, mais soyez conscient d'une + des limitations des instructions exécutables de XML : la balise + de fin d'instruction exécutable (<literal>?></literal>) + ne peut être échappée, ce qui fait que cette + séquence NE DOIT JAMAIS apparaître dans le code PHP + placé dans le document PHP. Si un tel texte apparaît, + la balise de fin d'instruction exécutable sera reconnue, et + le reste du code sera considéré comme des données + brutes (et donc, pas exécutées). </para> <para> La fonction <parameter>handler</parameter> doit accepter trois paramètres: @@ -918,17 +922,19 @@ </variablelist> </para> <para> - Si un gestionnaire reçoit une chaîne vide, ou &false;, - c'est qu'il est en train d'être désactivé. + Si un gestionnaire reçoit une chaîne vide, ou <literal>FALSE</literal>, + c'est qu'il est en train d'être désactivé. </para> <para> - Retourne &true; si le gestionnaire est actif, et &false; sinon, ou si - <parameter>parser</parameter> n'est pas un analyseur. + <function>xml_set_processing_instruction_handler</function> retourne + <literal>TRUE</literal> si le gestionnaire est actif, et + <literal>FALSE</literal> 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. + 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> </refsect1> </refentry> @@ -992,17 +998,19 @@ </variablelist> </para> <para> - Si un gestionnaire reçoit une chaîne vide ou &false;, c'est + Si un gestionnaire reçoit une chaîne vide ou <literal>FALSE</literal>, c'est qu'il est en train d'être désactivé. </para> <para> - Retourne &true; si le gestionnaire est actif, et &false; sinon, ou si - <parameter>parser</parameter> n'est pas un analyseur. + <function>xml_set_default_handler</function> retourne + <literal>TRUE</literal> si le gestionnaire est actif, et + <literal>FALSE</literal> 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. + 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> </refsect1> </refentry> @@ -1041,7 +1049,7 @@ </programlisting> </para> <para> - Reportez vous à la section + Reportez-vous à la section <ulink url="&url.rec-xml;#sec-external-ent">des spécifications XML 1.0</ulink> pour connaître les notations des entités externes. </para> @@ -1072,7 +1080,7 @@ <term><parameter>entityName</parameter></term> <listitem> <simpara> - Le nom de l'entitée qui va être définie + Le nom de l'entité qui va être définie </simpara> </listitem> </varlistentry> @@ -1114,17 +1122,19 @@ </variablelist> </para> <para> - Si un gestionnaire reçoit une chaîne vide ou &false;, - c'est qu'il est en train d'être désactivé. + Si un gestionnaire reçoit une chaîne vide ou <literal>FALSE</literal>, + c'est qu'il est en train d'être désactivé. </para> <para> - Retourne &true; si le gestionnaire est actif, et &false; sinon, ou si - <parameter>parser</parameter> n'est pas un analyseur. + <function>xml_set_unparsed_entity_decl_handler</function> retourne + <literal>TRUE</literal> si le gestionnaire est actif, et + <literal>FALSE</literal> 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. + 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> </refsect1> </refentry> @@ -1157,7 +1167,7 @@ <!NOTATION <parameter>name</parameter> { <parameter>systemId</parameter> | <parameter>publicId</parameter>?> </programlisting> - Reportez vous à la section + Reportez-vous à la section <ulink url="&url.rec-xml;#sec-external-ent">des spécifications XML 1.0</ulink> pour connaître les notations des entités externes. </para> @@ -1191,7 +1201,7 @@ <listitem> <simpara> Le nom de la notation,<parameter>name</parameter>, comme - précisé dans le format de notation ci dessus. + précisé dans le format de notation ci-dessus. </simpara> </listitem> </varlistentry> @@ -1211,7 +1221,7 @@ <term><parameter>systemId</parameter></term> <listitem> <simpara> - Identifiant système pour cette entitée externe. + Identifiant système pour cet entité externe. </simpara> </listitem> </varlistentry> @@ -1228,25 +1238,26 @@ </variablelist> </para> <para> - Si un gestionnaire reçoit une chaîne vide ou &false;, + Si un gestionnaire reçoit une chaîne vide ou <literal>FALSE</literal>, c'est qu'il est en train d'être désactivé. </para> <para> - Retourne &true; si le gestionnaire est actif, et - &false; sinon ou si - <parameter>parser</parameter> n'est pas un analyseur. + <function>xml_set_notation_decl_handler</function> retourne + <literal>TRUE</literal> si le gestionnaire est actif, et + <literal>FALSE</literal> 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. + 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> </refsect1> </refentry> <refentry id="function.xml-set-external-entity-ref-handler"> <refnamediv> <refname>xml_set_external_entity_ref_handler</refname> - <refpurpose>Fixe le gestionnaire de référence externes.</refpurpose> + <refpurpose>Modifie le gestionnaire de référence externes.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1270,7 +1281,7 @@ <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 <literal>FALSE</literal> (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>. @@ -1301,7 +1312,7 @@ <listitem> <simpara> Le deuxième paramètre, <parameter>openEntityNames</parameter>, - est i.e. liste de noms d'entité, séparés par des + 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é). </simpara> @@ -1341,18 +1352,19 @@ </variablelist> </para> <para> - Si un gestionnaire reçoit une chaîne vide, ou &false;, + Si un gestionnaire reçoit une chaîne vide, ou <literal>FALSE</literal>, c'est qu'il est en train d'être désactivé. </para> <para> - Retourne &true; si le gestionnaire est actif, et - &false; sinon ou si <parameter>parser</parameter> - n'est pas un analyseur. + <function>xml_set_external_entity_ref_handler</function> retourne + <literal>TRUE</literal> si le gestionnaire est actif, et + <literal>FALSE</literal> 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. + 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> </refsect1> </refentry> @@ -1391,7 +1403,7 @@ être analysé morceau par morceau, en appelant <function>xml_parse</function> plusieurs fois, tant que le paramètre <parameter>isFinal</parameter> est mis à - &true; pour le dernier morceau. + <literal>TRUE</literal> pour le dernier morceau. </simpara> </listitem> </varlistentry> @@ -1399,7 +1411,7 @@ <term><parameter>isFinal</parameter> (optional)</term> <listitem> <simpara> - Si il vaut &true;, <parameter>data</parameter> est la dernière partie + S'il vaut <literal>TRUE</literal>, <parameter>data</parameter> est la dernière partie à analyser. </simpara> </listitem> @@ -1409,11 +1421,11 @@ <para> Lorsqu'un document XML est analysé, les gestionnaires d'événements sont appelés aussi souvent que - nécessaire, et retournent &true; ou &false;. + nécessaire, et retournent <literal>TRUE</literal> ou <literal>FALSE</literal>. </para> <para> - &true; est retourné lorsque l'analyse a été concluante, - et &false; en cas d'échec, ou si <parameter>parser</parameter> n'est pas + <literal>TRUE</literal> est retourné lorsque l'analyse a été concluante, + et <literal>FALSE</literal> en cas d'échec, ou si <parameter>parser</parameter> n'est pas un analyseur valide. Lors d'un échec d'analyse, la cause de l'erreur peut être obtenue grâce aux fonctions <function>xml_get_error_code</function>, <function>xml_error_string</function>, @@ -1437,25 +1449,10 @@ </funcprototype> </funcsynopsis> <para> - <variablelist> - <varlistentry> - <term><parameter>parser</parameter></term> - <listitem> - <simpara> - Cette fonction 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. - </simpara> - </listitem> - </varlistentry> - </variablelist> - </para> - <para> - Cette fonction 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. + <function>xml_get_error_code</function> retourne <literal>FALSE</literal> + 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. </para> </refsect1> </refentry> @@ -1485,9 +1482,10 @@ </variablelist> </para> <para> - Retourne la chaîne avec un message textuel, décrivant l'erreur - <parameter>code</parameter>, ou &false; si aucune description n'a - été trouvée. + <function>xml_error_string</function> retourne la chaîne avec + un message textuel, décrivant l'erreur <parameter>code</parameter>, + ou <literal>FALSE</literal> si aucune description n'a été + trouvée. </para> </refsect1> </refentry> @@ -1495,16 +1493,14 @@ <refnamediv> <refname>xml_get_current_line_number</refname> <refpurpose> - Retourne le numéro de ligne courant d'un analyseur XML. + Retourne le numéro de ligne courant d'un analyseur XML. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int - <function>xml_get_current_line_number</function> - </funcdef> + <funcdef>int <function>xml_get_current_line_number</function></funcdef> <paramdef>resource <parameter>parser</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -1521,9 +1517,10 @@ </variablelist> </para> <para> - Cette fonction retourne &false; si <parameter>parser</parameter> n'est - pas valide, ou sinon, retourne le numéro de la ligne en cours - d'analyse. + <function>xml_get_current_line_number</function> retourne + <literal>FALSE</literal> si <parameter>parser</parameter> n'est + pas valide, ou sinon, retourne le numéro de la ligne en cours + d'analyse. </para> </refsect1> </refentry> @@ -1532,15 +1529,13 @@ <refname>xml_get_current_column_number</refname> <refpurpose> Retourne le nombre courant de colonne d'un analyseur XML. - .</refpurpose> + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int - <function>xml_get_current_column_number</function> - </funcdef> + <funcdef>int <function>xml_get_current_column_number</function></funcdef> <paramdef>resource <parameter>parser</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -1550,17 +1545,18 @@ <term><parameter>parser</parameter></term> <listitem> <simpara> - Une référence sur un analyseur XML valide. + Une référence sur un analyseur XML valide. </simpara> </listitem> </varlistentry> </variablelist> </para> <para> - Cette fonction 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. + <function>xml_get_current_column_number</function> retourne + <literal>FALSE</literal> 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. </para> </refsect1> </refentry> @@ -1573,9 +1569,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int - <function>xml_get_current_byte_index</function> - </funcdef> + <funcdef>int <function>xml_get_current_byte_index</function></funcdef> <paramdef>resource <parameter>parser</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -1585,16 +1579,17 @@ <term><parameter>parser</parameter></term> <listitem> <simpara> - Une référence sur un analyseur XML valide. + Une référence sur un analyseur XML valide. </simpara> </listitem> </varlistentry> </variablelist> </para> <para> - Cette fonction retourne &false; si <parameter>parser</parameter> n'est pas - valide, ou sinon, retourne l'index de l'octet d'analyse courante de - l'analyseur XML. + <function>xml_get_current_byte_index</function> retourne + <literal>FALSE</literal> si <parameter>parser</parameter> n'est pas + valide, ou sinon, retourne l'index de l'octet d'analyse courante de + l'analyseur XML. </para> </refsect1> </refentry> @@ -1623,7 +1618,7 @@ passés par références. </para> <para> - Ci dessous, vous trouverez un exemple qui illustre la structure + Ci-dessous, vous trouverez un exemple qui illustre la structure des deux tableaux générés par la fonction. On utilise une balise simple <literal>note</literal>, placée dans une autre balise <literal>para</literal>. On analyse le tout, et on @@ -1687,9 +1682,10 @@ </informalexample> </para> <para> - L'analyse événementielle (comme celle de expat), peut se révéler - complexe lorsque le document XML est complexe. Cette fonction ne - génère pas d'objet de type DOM, mais il génère plutôt des + L'analyse événementielle (comme celle de expat), peut se + révéler complexe lorsque le document XML est complexe. + <function>xml_parse_into_struct</function> ne génère pas + d'objet de type DOM, mais il génère plutôt des structures qui peuvent être parcourues à la façon d'un arbre. Considérons le fichier suivant, qui représente une petite base de données XML : @@ -1807,7 +1803,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>string <function>xml_parser_free</function></funcdef> + <funcdef>boolean <function>xml_parser_free</function></funcdef> <paramdef>resource <parameter>parser</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -1824,9 +1820,9 @@ </variablelist> </para> <para> - Cette fonction retourne &false; si <parameter>parser</parameter> - n'est pas une référence valide, ou sinon, détruit - l'analyseur et retourne &true;. + <function>xml_parser_free</function> retourne <literal>FALSE</literal> + si <parameter>parser</parameter> n'est pas une référence + valide, ou sinon, détruit l'analyseur et retourne <literal>TRUE</literal>. </para> </refsect1> </refentry> @@ -1859,7 +1855,7 @@ <term><parameter>option</parameter></term> <listitem> <simpara> - L'option à modifier. Voir ci dessous : + L'option à modifier. Voir ci-dessous : </simpara> </listitem> </varlistentry> @@ -1874,10 +1870,11 @@ </variablelist> </para> <para> - Cette fonction 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 &true;. + <function>xml_parser_set_option</function> retourne <literal>FALSE</literal> + 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 + <literal>TRUE</literal>. </para> <para> Les options suivantes sont disponibles : @@ -1948,7 +1945,7 @@ <term><parameter>option</parameter></term> <listitem> <simpara> - L'option demandée. Reportez vous à + L'option demandée. Reportez-vous à <function>xml_parser_set_option</function> pour avoir la liste des options disponibles. </simpara> @@ -1957,12 +1954,12 @@ </variablelist> </para> <para> - <function>xml_parser_get_option</function> retourne &false; si + <function>xml_parser_get_option</function> retourne <literal>FALSE</literal> si <parameter>parser</parameter> n'est pas valide, ou sinon, retourne la valeur de l'option demandée. </para> <para> - Reportez vous à <function>xml_parser_set_option</function> pour avoir la + Reportez-vous à <function>xml_parser_set_option</function> pour avoir la liste des options disponibles. </para> </refsect1> @@ -1970,7 +1967,7 @@ <refentry id="function.utf8-decode"> <refnamediv> <refname>utf8_decode</refname> - <refpurpose>Convertit un 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> @@ -1995,7 +1992,7 @@ <refentry id="function.utf8-encode"> <refnamediv> <refname>utf8_encode</refname> - <refpurpose>Convertit un 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> @@ -2013,7 +2010,7 @@ taille dans des flots 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 flot 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