cvs: phpdoc /fr/functions domxml.xml

From: Date: Wed, 18 Jul 2001 12:54:47 +0000
Subject: cvs: phpdoc /fr/functions domxml.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969336297@lists.php.net to get a copy of this message
dams Wed Jul 18 08:54:47 2001 EDT Modified files: /phpdoc/fr/functions domxml.xml Log: Added last updates.

Index: phpdoc/fr/functions/domxml.xml diff -u phpdoc/fr/functions/domxml.xml:1.5 phpdoc/fr/functions/domxml.xml:1.6 --- phpdoc/fr/functions/domxml.xml:1.5 Sun Jul 8 09:01:23 2001 +++ phpdoc/fr/functions/domxml.xml Wed Jul 18 08:54:47 2001 @@ -1,144 +1,143 @@ - <reference id="ref.domxml"> - <title>DOM XML</title> - <titleabbrev>DOM XML</titleabbrev> - <partintro> - &warn.experimental; - <simpara> - Note importante : cette documentation est en cours de r&eacute;daction, - et n'est pas encore finie. Elle souffre naturellement d'un - manque de d&eacute;tails et de relecture. Soyez en pr&eacute;venu. (Damien Seguy). - </simpara> - <simpara> - Ces fonctions ne sont disponibles que si PHP a &eacute;t&eacute; - configur&eacute; avec l'option - <option role="configure">--with-dom=[DIR]</option>, et utilise la librairie - GNOME xml library. Vous aurez aussi besoin de la librairie libxml-2.2.7 - (la version beta ne fonctionne pas). Ces fonctions ont &eacute;t&eacute; - ajout&eacute;es dans PHP 4. - </simpara> - <simpara> - Cette extensions vous permettent de g&eacute;n&eacute;rer des documents XML avec - les API DOM. Elle fournit aussi une fonction <function>xmltree</function> - qui transforme un fichier XML en tableau PHP. Actuellement, ce - tableau est accessible uniquement en lecture. Cela ne siginifie pas - que vous ne pouvez pas le modifier, mais cela n'aurait aucun sens - car <function>dumpmem</function> ne pourra pas prendre ces modifications - en consid&eacute;ration. Par cons&eacute;quent, si vous voulez lire un fichier XML - et &eacute;crire sa version modifi&eacute;e, utilisez les fonctions - <function>add_node</function>, <function>set_attribute</function>, etc... - et finalement, <function>dumpmem</function>. - </simpara> - <simpara> - Ce module d&eacute;finit les constantes suivantes : - </simpara> - <table> - <title>Constantes XML</title> - <tgroup cols="3"> - <thead> - <row> - <entry>Constante</entry> - <entry>Valeur</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>XML_ELEMENT_NODE</entry> - <entry>1</entry> - <entry>Le noeud est un &eacute;l&eacute;ment</entry> - </row> - <row> - <entry>XML_ATTRIBUTE_NODE</entry> - <entry>2</entry> - <entry>Le noeud est un attribut</entry> - </row> - <row> - <entry>XML_TEXT_NODE</entry> - <entry>3</entry> - <entry>Le noeud est un texte</entry> - </row> - <row> - <entry>XML_CDATA_SECTION_NODE</entry> - <entry>4</entry> - <entry></entry> - </row> - <row> - <entry>XML_ENTITY_REF_NODE</entry> - <entry>5</entry> - <entry></entry> - </row> - <row> - <entry>XML_ENTITY_NODE</entry> - <entry>6</entry> - <entry>Le noeud est une entit&eacute;e telle que &amp;nbsp;</entry> - </row> - <row> - <entry>XML_PI_NODE</entry> - <entry>7</entry> - <entry>Le noeud est une instruction</entry> - </row> - <row> - <entry>XML_COMMENT_NODE</entry> - <entry>8</entry> - <entry>Le noeud est un commentaire</entry> - </row> - <row> - <entry>XML_DOCUMENT_NODE</entry> - <entry>9</entry> - <entry>Le noeud est un document</entry> - </row> - <row> - <entry>XML_DOCUMENT_TYPE_NODE</entry> - <entry>10</entry> - <entry></entry> - </row> - <row> - <entry>XML_DOCUMENT_FRAG_NODE</entry> - <entry>11</entry> - <entry></entry> - </row> - <row> - <entry>XML_NOTATION_NODE</entry> - <entry>12</entry> - <entry></entry> - </row> - <row> - <entry>XML_GLOBAL_NAMESPACE</entry> - <entry>1</entry> - <entry></entry> - </row> - <row> - <entry>XML_LOCAL_NAMESPACE</entry> - <entry>2</entry> - <entry></entry> - </row> - </tbody> - </tgroup> - </table> - <simpara> - Chaque fonction de cette extension peut &ecirc;tre utilis&eacute;e de deux mani&egrave;res - diff&eacute;rentes. Dans un contexte proc&eacute;dural, il faut passer l'objet en - premier argument; dans un contexte objet, vous pouvez appeler la - fonction comme une m&eacute;thode de cet objet. Cette documentation pr&eacute;sente - les fonctions dans leur contexte proc&eacute;dural. Vous pouvez conna&icirc;tre la - m&eacute;thode objet en supprimant le pr&eacute;fixe "<literal>domxml_</literal>". - Les tables suivantes listes toutes les classes, leurs attributs et - leurs m&eacute;thodes. - </simpara> - <simpara> - Ce module d&eacute;finit un ensemble de classes, qui sont list&eacute;es - ci-dessous (y compris leur attributs et leur m&eacute;thodes). - </simpara> - <para> +<reference id="ref.domxml"> + <title>DOM XML</title> + <titleabbrev>DOM XML</titleabbrev> + <partintro> + <simpara> + Note importante : cette documentation est en cours de r&eacute;daction, + et n'est pas encore finie. Elle souffre naturellement d'un + manque de d&eacute;tails et de relecture. Soyez en pr&eacute;venu. (Damien Seguy). + </simpara> + <simpara> + Ces fonctions ne sont disponibles que si PHP a &eacute;t&eacute; + configur&eacute; avec l'option + <link linkend="install.configure.with-dom"><option role="configure">--with-dom=[DIR]</option></link>, + et utilise la librairie GNOME xml library. Vous aurez aussi besoin + de la librairie libxml-2.2.7 (la version beta ne fonctionne pas). + Ces fonctions ont &eacute;t&eacute; ajout&eacute;es en PHP 4. + </simpara> + <simpara> + Cette extension vous permet de g&eacute;n&eacute;rer des documents XML avec + les API DOM. Elle fournit aussi une fonction <function>xmltree</function> + qui transforme un fichier XML en tableau PHP. Actuellement, ce + tableau est accessible uniquement en lecture. Cela ne siginifie pas + que vous ne pouvez pas le modifier, mais cela n'aurait aucun sens + car <function>domxml_dumpmem</function> ne pourra pas prendre ces modifications + en consid&eacute;ration. Par cons&eacute;quent, si vous voulez lire un fichier XML + et &eacute;crire sa version modifi&eacute;e, utilisez les fonctions + <function>domxml_add_node</function>, <function>domxml_set_attribute</function>, etc... + et finalement, <function>domxml_dumpmem</function>. + </simpara> + <simpara> + Ce module d&eacute;finit les constantes suivantes : + </simpara> + <table> + <title>Constantes XML</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Constante</entry> + <entry>Valeur</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>XML_ELEMENT_NODE</entry> + <entry>1</entry> + <entry>Le noeud est un &eacute;l&eacute;ment</entry> + </row> + <row> + <entry>XML_ATTRIBUTE_NODE</entry> + <entry>2</entry> + <entry>Le noeud est un attribut</entry> + </row> + <row> + <entry>XML_TEXT_NODE</entry> + <entry>3</entry> + <entry>Le noeud est un texte</entry> + </row> + <row> + <entry>XML_CDATA_SECTION_NODE</entry> + <entry>4</entry> + <entry></entry> + </row> + <row> + <entry>XML_ENTITY_REF_NODE</entry> + <entry>5</entry> + <entry></entry> + </row> + <row> + <entry>XML_ENTITY_NODE</entry> + <entry>6</entry> + <entry>Le noeud est une entit&eacute; telle que &amp;nbsp;</entry> + </row> + <row> + <entry>XML_PI_NODE</entry> + <entry>7</entry> + <entry>Le noeud est une instruction</entry> + </row> + <row> + <entry>XML_COMMENT_NODE</entry> + <entry>8</entry> + <entry>Le noeud est un commentaire</entry> + </row> + <row> + <entry>XML_DOCUMENT_NODE</entry> + <entry>9</entry> + <entry>Le noeud est un document</entry> + </row> + <row> + <entry>XML_DOCUMENT_TYPE_NODE</entry> + <entry>10</entry> + <entry></entry> + </row> + <row> + <entry>XML_DOCUMENT_FRAG_NODE</entry> + <entry>11</entry> + <entry></entry> + </row> + <row> + <entry>XML_NOTATION_NODE</entry> + <entry>12</entry> + <entry></entry> + </row> + <row> + <entry>XML_GLOBAL_NAMESPACE</entry> + <entry>1</entry> + <entry></entry> + </row> + <row> + <entry>XML_LOCAL_NAMESPACE</entry> + <entry>2</entry> + <entry></entry> + </row> + </tbody> + </tgroup> + </table> + <simpara> + Chaque fonction de cette extension peut &ecirc;tre utilis&eacute;e de deux mani&egrave;res + diff&eacute;rentes. Dans un contexte proc&eacute;dural, il faut passer l'objet en + premier argument; dans un contexte objet, vous pouvez appeler la + fonction comme une m&eacute;thode de cet objet. Cette documentation pr&eacute;sente + les fonctions dans leur contexte proc&eacute;dural. Vous pouvez conna&icirc;tre la + m&eacute;thode objet en supprimant le pr&eacute;fixe "<literal>domxml_</literal>". + Les tables suivantes listes toutes les classes, leurs attributs et + leurs m&eacute;thodes. + </simpara> + <simpara> + Ce module d&eacute;finit un ensemble de classes, qui sont list&eacute;es + ci-dessous (y compris leur attributs et leur m&eacute;thodes). + </simpara> + <para> <table> <title>classe DomDocument (m&eacute;thodes)</title> <tgroup cols="3"> <thead> - <row> - <entry>Nom de la m&eacute;thode</entry> - <entry>Nom de la fonction</entry> - <entry>Description</entry> - </row> + <row> + <entry>Nom de la m&eacute;thode</entry> + <entry>Nom de la fonction</entry> + <entry>Description</entry> + </row> </thead> <tbody> <row> @@ -163,7 +162,7 @@ </row> <row> <entry>dumpmem</entry> - <entry><function>domxml</function></entry> + <entry><function>domxml_dumpmem</function></entry> <entry></entry> </row> <row> @@ -184,17 +183,17 @@ </tbody> </tgroup> </table> - </para> - <para> + </para> + <para> <table> <title>Classe DomDocument (attributs)</title> <tgroup cols="3"> <thead> - <row> - <entry>Nom</entry> - <entry>Type</entry> - <entry>Description</entry> - </row> + <row> + <entry>Nom</entry> + <entry>Type</entry> + <entry>Description</entry> + </row> </thead> <tbody> <row> @@ -245,17 +244,17 @@ </tbody> </tgroup> </table> - </para> - <para> + </para> + <para> <table> <title>classe DomNode (m&eacute;thodes)</title> <tgroup cols="3"> <thead> - <row> - <entry>Nom</entry> - <entry>Nom en PHP</entry> - <entry>Description</entry> - </row> + <row> + <entry>Nom</entry> + <entry>Nom en PHP</entry> + <entry>Description</entry> + </row> </thead> <tbody> <row> @@ -306,17 +305,17 @@ </tbody> </tgroup> </table> - </para> - <para> + </para> + <para> <table> <title>classe DomNode (attributs)</title> <tgroup cols="3"> <thead> - <row> - <entry>Nom</entry> - <entry>Type</entry> - <entry>Description</entry> - </row> + <row> + <entry>Nom</entry> + <entry>Type</entry> + <entry>Description</entry> + </row> </thead> <tbody> <row> @@ -342,471 +341,475 @@ </tbody> </tgroup> </table> + </para> + </partintro> + <!-- class Dom document --> + <!-- has member functions + array root([int doc_handle]) + returns array of root nodes of this document. Array + elements are objects of class "Dom node" having properties of + "node" (resource), "type" (long), "name" (string) + and optionally "content" (string). + array children([ int node ]) + returns an array of child nodes of this element. Array + elements are objects of class "Dom node" having properties + of "node" (resource), "type" (long), "name" (string) + and optionally "content" (string). + object add_root([int doc_handle,] string name) + Add a root node to document. + returns an object of class "Dom node" having properties + of "node" (resource), "type" (long), "name" (string) + and optionally "content" (string). + object intdtd([int doc_handle]) + returns the DTD of document. + returns an object of class "Dtd" having properties + of "dtd" (resource), "sysid" (string), "name" (string) + and optionally "extid" (string). + string dumpmem([int doc_handle]) + dumps document into string. + --> + <!-- class Dom node + object lastchild([int node]) + returns Dom node object + array children([int node]) + as above + object parent([ int node]) + returns Dom node object + (parent of this node) + new_child + string getattr([int node,] string attrname) + get value of attribute named attrname + bool setattr([int node,] string attrname, string value) + set value of given attribute. + array attributes([int node]) + returns associative array of (string name, string value) + pairs. + object node(string name) + creates a named Dom node object. + --> + <!-- class Dom Attribute + name + --> + <!-- class Dom Namespace + --> + <!-- class Dtd + --> + <refentry id="function.xmldoc"> + <refnamediv> + <refname>xmldoc</refname> + <refpurpose>Cr&eacute;e un objet DOM pour un document XML.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>object <function>xmldoc</function></funcdef> + <paramdef>string <parameter>str</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>xmldoc</function> analyse le document XML <parameter>str</parameter> + et retourne un objet de classe "Dom document", avec les + propri&eacute;t&eacute;s de "doc" (ressources), "version" (string) + et "type" (long). + </para> + </refsect1> + </refentry> + <refentry id="function.xmldocfile"> + <refnamediv> + <refname>xmldocfile</refname> + <refpurpose>Cr&eacute;e un objet DOM &agrave; partir d'un fichier XML</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>object <function>xmldocfile</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>xmldocfile</function> analyse le fichier XML + <parameter>filename</parameter> et retourne un objet "Dom document", + avec les propri&eacute;t&eacute;es de "doc" (ressources) et + "version" (string). + <!-- conspiciously the file attribute is missing? --> </para> - </partintro> - <!-- class Dom document --> - <!-- has member functions - array root([int doc_handle]) - returns array of root nodes of this document. Array - elements are objects of class "Dom node" having properties of - "node" (resource), "type" (long), "name" (string) - and optionally "content" (string). - array children([ int node ]) - returns an array of child nodes of this element. Array - elements are objects of class "Dom node" having properties - of "node" (resource), "type" (long), "name" (string) - and optionally "content" (string). - object add_root([int doc_handle,] string name) - Add a root node to document. - returns an object of class "Dom node" having properties - of "node" (resource), "type" (long), "name" (string) - and optionally "content" (string). - object intdtd([int doc_handle]) - returns the DTD of document. - returns an object of class "Dtd" having properties - of "dtd" (resource), "sysid" (string), "name" (string) - and optionally "extid" (string). - string dumpmem([int doc_handle]) - dumps document into string. - --> - <!-- class Dom node - object lastchild([int node]) - returns Dom node object - array children([int node]) - as above - object parent([ int node]) - returns Dom node object - (parent of this node) - new_child - string getattr([int node,] string attrname) - get value of attribute named attrname - bool setattr([int node,] string attrname, string value) - set value of given attribute. - array attributes([int node]) - returns associative array of (string name, string value) - pairs. - object node(string name) - creates a named Dom node object. - --> - <!-- class Dom Attribute - name - --> - <!-- class Dom Namespace - --> - <!-- class Dtd - --> - <refentry id="function.xmldoc"> - <refnamediv> - <refname>xmldoc</refname> - <refpurpose>Cr&eacute;e un objet DOM pour un document XML.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>object <function>xmldoc</function></funcdef> - <paramdef>string <parameter>str</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>xmldoc</function> analyse le document XML <parameter>str</parameter> - et retourne un objet de classe "Dom document", avec les - propri&eacute;t&eacute;s de "doc" (ressources), "version" (string) - et "type" (long). - </para> - </refsect1> - </refentry> - <refentry id="function.xmldocfile"> - <refnamediv> - <refname>xmldocfile</refname> - <refpurpose>Cr&eacute;e un objet DOM &agrave; partir d'un fichier XML</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>object <function>xmldocfile</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>xmldocfile</function> analyse le fichier XML - <parameter>filename</parameter> et retourne un objet "Dom document", - avec les propri&eacute;t&eacute;es de "doc" (ressources) et - "version" (string). - <!-- conspiciously the file attribute is missing? --> - </para> - </refsect1> - </refentry> - <refentry id="function.xmltree"> - <refnamediv> - <refname>xmltree</refname> - <refpurpose> - Cr&eacute;e un arbre d'objet PHP, &agrave; partir d'un document XML. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>object <function>xmltree</function></funcdef> - <paramdef>string <parameter>str</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>xmltree</function> analyse le document XML <parameter>str</parameter> - et retourne un arbre d'objets PHP qui repr&eacute;sente le document - analys&eacute;. <function>xmltree</function> est diff&eacute;rentes des autres - fonctions, car vous ne pouvez acc&eacute;der &agrave; cet arbre avec aucune des - autres fonctions. Modifier cet arbre n'a pas de sens, car il n'y - a pas moyen de sauver ces modifications. Cette fonction a tout de - m&ecirc;me des applications en lecture seule. - </para> - </refsect1> - </refentry> - <refentry id="function.domxml_root"> - <refnamediv> - <refname>domxml_root</refname> - <refpurpose> - Retourne l'&eacute;l&eacute;ment racine - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>object <function>domxml_root</function></funcdef> - <paramdef>array <parameter>doc</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>domxml_root</function> retourne l'&eacute;l&eacute;ment qui est - plac&eacute; tout en haut du document XML. En fait, il existe aussi - des commentaires qui peuvent &ecirc;tre plac&eacute;s l&agrave;, mais ils - sont actuellement ignor&eacute;s. - </para> - <para> - L'exemple suivant retourne simplement l'&eacute;l&eacute;ment CHAPTER et - l'affiche. Les autres racines (des commentaires) ne sont - pas retourn&eacute;s. - <example> - <title>Lecture de l'&eacute;l&eacute;ment principal</title> - <programlisting> + </refsect1> + </refentry> + <refentry id="function.xmltree"> + <refnamediv> + <refname>xmltree</refname> + <refpurpose> + Cr&eacute;e un arbre d'objet PHP, &agrave; partir d'un document XML. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>object <function>xmltree</function></funcdef> + <paramdef>string <parameter>str</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>xmltree</function> analyse le document XML <parameter>str</parameter> + et retourne un arbre d'objets PHP qui repr&eacute;sente le document + analys&eacute;. <function>xmltree</function> est diff&eacute;rentes des autres + fonctions, car vous ne pouvez acc&eacute;der &agrave; cet arbre avec aucune des + autres fonctions. Modifier cet arbre n'a pas de sens, car il n'y + a pas moyen de sauver ces modifications. Cette fonction a tout de + m&ecirc;me des applications en lecture seule. + </para> + </refsect1> + </refentry> + <refentry id="function.domxml_root"> + <refnamediv> + <refname>domxml_root</refname> + <refpurpose> + Retourne l'&eacute;l&eacute;ment racine + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>object <function>domxml_root</function></funcdef> + <paramdef>object <parameter>doc</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>domxml_root</function> prend en argument <parameter>doc</parameter>, + un objet de la classe "Dom document", et retourn l'ŽlŽment racine de + ce document. Les autres noeuds qui peuvent tre considŽrŽs comme + racine (tels que les commentaires) sont ignorŽs. + </para> + <para> + L'exemple suivant retourne simplement l'&eacute;l&eacute;ment CHAPTER et + l'affiche. Les autres racines (des commentaires) ne sont + pas retourn&eacute;s. + <example> + <title>Lecture de l'&eacute;l&eacute;ment principal</title> + <programlisting role="php"> &lt;?php -$xmlstr = "&lt;?xml version='1.0' standalone='yes'??&gt; -&lt;!DOCTYPE chapter SYSTEM '/share/sgml/Norman_Walsh/db3xml10/db3xml10.dtd' -[ &lt;!ENTITY sp \"spanish\"?&gt; -]?&gt; -&lt;!-- lsfj --?&gt; -&lt;chapter language='en'?&gt;&lt;title language='en'?&gt;Title&lt;/title?&gt; - &lt;para language='ge'?&gt; - &amp;sp; - &lt;!-- comment --?&gt; - &lt;informaltable language='&amp;sp;'?&gt; - &lt;tgroup cols='3'?&gt; - &lt;tbody?&gt; - &lt;row?&gt;&lt;entry?&gt;a1&lt;/entry?&gt;&lt;entry -morerows='1'?&gt;b1&lt;/entry?&gt;&lt;entry?&gt;c1&lt;/entry?&gt;&lt;/row?&gt; -&lt;row?&gt;&lt;entry?&gt;a2&lt;/entry?&gt;&lt;entry?&gt;c2&lt;/entry?&gt;&lt;/row?&gt; - &lt;row?&gt;&lt;entry?&gt;a3&lt;/entry?&gt;&lt;entry?&gt;b3&lt;/entry?&gt;&lt;entry?&gt;c3&lt;/entry?&gt;&lt;/row?&gt; - &lt;/tbody?&gt; - &lt;/tgroup?&gt; - &lt;/informaltable?&gt; - &lt;/para?&gt; -&lt;/chapter?&gt;"; -if(!$dom = xmldoc($xmlstr)) { - echo "Error while parsing the document\n"; - exit; -} -$root = $dom-?&gt;root(); -print_r($root); -??&gt; - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.domxml_add_root"> - <refnamediv> - <refname>domxml_add_root</refname> - <refpurpose> - Ajoute une autre racine - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>resource <function>domxml_add_root</function></funcdef> - <paramdef>resource <parameter>doc</parameter></paramdef> - <paramdef>string <parameter>name</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>domxml_add_root</function> ajoute la racine <parameter>name</parameter> - au document <parameter>doc</parameter>. - </para> - <para> - <example> - <title>Cr&eacute;ation d'un ent&ecirc;te HTML simple</title> - <programlisting> + $xmlstr = "&lt;?xml version='1.0' standalone='yes'&gt; + &lt;!DOCTYPE chapter SYSTEM '/share/sgml/Norman_Walsh/db3xml10/db3xml10.dtd' + [ &lt;!ENTITY sp \"spanish\"&gt; + ]&gt; + &lt;!-- lsfj --&gt; + &lt;chapter language='en'&gt;&lt;title language='en'&gt;Title&lt;/title&gt; + &lt;para language='ge'&gt; + &amp;sp; + &lt;!-- comment --&gt; + &lt;informaltable language='&amp;sp;'&gt; + &lt;tgroup cols='3'&gt; + &lt;tbody&gt; + &lt;row&gt;&lt;entry&gt;a1&lt;/entry&gt;&lt;entry + morerows='1'&gt;b1&lt;/entry&gt;&lt;entry&gt;c1&lt;/entry&gt;&lt;/row&gt; + &lt;row&gt;&lt;entry&gt;a2&lt;/entry&gt;&lt;entry&gt;c2&lt;/entry&gt;&lt;/row&gt; + &lt;row&gt;&lt;entry&gt;a3&lt;/entry&gt;&lt;entry&gt;b3&lt;/entry&gt;&lt;entry&gt;c3&lt;/entry&gt;&lt;/row&gt; + &lt;/tbody&gt; + &lt;/tgroup&gt; + &lt;/informaltable&gt; + &lt;/para&gt; + &lt;/chapter&gt;"; + if(!$dom = xmldoc($xmlstr)) { + echo "Erreur lors de l'analyse du document\n"; + exit; + } + $root = $dom-&gt;root(); + /* ou $root = domxml_root($dom); */ + print_r($root); +?&gt; + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.domxml_add_root"> + <refnamediv> + <refname>domxml_add_root</refname> + <refpurpose> + Ajoute une autre racine + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>resource <function>domxml_add_root</function></funcdef> + <paramdef>resource <parameter>doc</parameter></paramdef> + <paramdef>string <parameter>name</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>domxml_add_root</function> ajoute la racine <parameter>name</parameter> + au document <parameter>doc</parameter>. + </para> + <para> + <example> + <title>Cr&eacute;ation d'une en-t&ecirc;te HTML simple</title> + <programlisting role="php"> &lt;?php -$doc = new_xmldoc("1.0"); -$root = $doc-?&gt;add_root("HTML"); -$head = $root-?&gt;new_child("HEAD", ""); -$head-?&gt;new_child("TITLE", "Hier der Titel"); -echo $doc-?&gt;dumpmem(); -??&gt; - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.domxml_dumpmem"> - <refnamediv> - <refname>domxml_dumpmem</refname> - <refpurpose> - Ecrit le document XML interne dans une cha&icirc;ne - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>domxml_dumpmem</function></funcdef> - <paramdef>resource <parameter>doc</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>domxml_dumpmem</function> cr&eacute;e un document XML &agrave; partir - de la repr&eacute;sentation interne. <function>domxml_dumpmem</function> - est g&eacute;n&eacute;ralement appel&eacute;e avec avoir construit un nouveau document - XML, comme dans l'exemple <function>domxml_add_root</function>. - </para> - <para> - Voir aussi<function>domxml_add_root</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.domxml_attributes"> - <refnamediv> - <refname>domxml_attributes</refname> - <refpurpose> - Retourne les attributs d'un noeud - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>domxml_attributes</function></funcdef> - <paramdef>resource <parameter>node</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>domxml_attributes</function> retourne tous les - attributs du noeud <parameter>node</parameter> sous forme - d'un tableau d'objets "dom attribute". - </para> - </refsect1> - </refentry> - <refentry id="function.domxml_get_attribute"> - <refnamediv> - <refname>domxml_get_attribute</refname> - <refpurpose> - Retourne un attribut d'un noeud - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>object <function>domxml_get_attribute</function></funcdef> - <paramdef>resource <parameter>node</parameter></paramdef> - <paramdef>string <parameter>name</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>domxml_get_attribute</function> retourn l'attribut - <parameter>name</parameter> du noeud <parameter>node</parameter>. - </para> - <simpara> - Voir aussi <function>domxml_set_attribute</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.domxml_set_attribute"> - <refnamediv> - <refname>domxml_set_attribute</refname> - <refpurpose> - Modifie un attribut - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>object <function>domxml_set_attribute</function></funcdef> - <paramdef>resource <parameter>node</parameter></paramdef> - <paramdef>string <parameter>name</parameter></paramdef> - <paramdef>string <parameter>value</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>domxml_set_attribute</function> modifie l'attribut - <parameter>name</parameter> du noeud <parameter>node</parameter> - en lui attribuant la valeur <parameter>value</parameter>. - </para> - <para> - En partant de l'exemple propos&eacute; &agrave; la fonction <function>domxml_add_root</function>, - il est simple d'ajouter un attribut &agrave; l'&eacute;l&eacute;ment HEAD en - appelant simplement <function>set_attribute</function>. - <example> - <title>Adding an attribute to an element</title> - <programlisting> + $root = $doc-&gt;add_root("HTML"); + $head = $root-&gt;new_child("HEAD", ""); + $head-&gt;new_child("TITLE", "Ici, le titre"); + echo $doc-&gt;dumpmem(); +?&gt; + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.domxml_dumpmem"> + <refnamediv> + <refname>domxml_dumpmem</refname> + <refpurpose> + Ecrit le document XML interne dans une cha&icirc;ne + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>domxml_dumpmem</function></funcdef> + <paramdef>resource <parameter>doc</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>domxml_dumpmem</function> cr&eacute;e un document XML &agrave; partir + de la repr&eacute;sentation interne. <function>domxml_dumpmem</function> + est g&eacute;n&eacute;ralement appel&eacute;e avec avoir construit un nouveau document + XML, comme dans l'exemple <function>domxml_add_root</function>. + </para> + <para> + Voir aussi + <function>domxml_add_root</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.domxml_attributes"> + <refnamediv> + <refname>domxml_attributes</refname> + <refpurpose> + Retourne les attributs d'un noeud + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>domxml_attributes</function></funcdef> + <paramdef>resource <parameter>node</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>domxml_attributes</function> retourne tous les + attributs du noeud <parameter>node</parameter> sous forme + d'un tableau d'objets "dom attribute". + </para> + </refsect1> + </refentry> + <refentry id="function.domxml_get_attribute"> + <refnamediv> + <refname>domxml_get_attribute</refname> + <refpurpose> + Retourne un attribut d'un noeud + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>object <function>domxml_get_attribute</function></funcdef> + <paramdef>resource <parameter>node</parameter></paramdef> + <paramdef>string <parameter>name</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>domxml_get_attribute</function> retourn l'attribut + <parameter>name</parameter> du noeud <parameter>node</parameter>. + </para> + <simpara> + Voir aussi + <function>domxml_set_attribute</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.domxml_set_attribute"> + <refnamediv> + <refname>domxml_set_attribute</refname> + <refpurpose> + Modifie un attribut + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>object <function>domxml_set_attribute</function></funcdef> + <paramdef>resource <parameter>node</parameter></paramdef> + <paramdef>string <parameter>name</parameter></paramdef> + <paramdef>string <parameter>value</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>domxml_set_attribute</function> modifie l'attribut + <parameter>name</parameter> du noeud <parameter>node</parameter> + en lui attribuant la valeur <parameter>value</parameter>. + </para> + <para> + En partant de l'exemple propos&eacute; &agrave; la fonction + <function>domxml_add_root</function>, il est simple d'ajouter + un attribut &agrave; l'&eacute;l&eacute;ment HEAD en + appelant simplement <function>set_attribute</function>. + <example> + <title>Ajouter un attribut &agrave; un &eacute;l&eacute;ment</title> + <programlisting role="php"> &lt;?php -$doc = new_xmldoc("1.0"); -$root = $doc-&gt;add_root("HTML"); -$head = $root-&gt;new_child("HEAD", ""); -$head-&gt;new_child("TITLE", "Ici, le titre"); -$head-&gt;set_attribute("Language", "fr"); -$head-&gt;new_child("TITLE", "Hier der Titel"); -$head-&gt;set_attribute("Language", "ge"); -echo $doc-&gt;dumpmem(); + $doc = new_xmldoc("1.0"); + $root = $doc-&gt;add_root("HTML"); + $head = $root-&gt;new_child("HEAD", ""); + $head-&gt;new_child("TITLE", "Ici, le titre"); + $head-&gt;set_attribute("Language", "fr"); + $head-&gt;new_child("TITLE", "Hier der Titel"); + $head-&gt;set_attribute("Language", "ge"); + echo $doc-&gt;dumpmem(); ?&gt; - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.domxml_children"> - <refnamediv> - <refname>domxml_children</refname> - <refpurpose> - Retourne les fils d'un noeud - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>domxml_children</function></funcdef> - <paramdef>object <parameter>doc|node</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>domxml_children</function> retourne tous les fils - du noeud <parameter>doc|node</parameter>, sous forme d'un tableau - de noeuds. - </para> - <para> - Dans l'exemple ci-dessous, la variable <varname>children</varname> - contiendra un tableau avec les noeuds de type XML_ELEMENT. Ce noeud est - l'&eacute;l&eacute;ment TITLE. - <example> - <title>Lire les fils d'un noeud</title> - <programlisting> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.domxml_children"> + <refnamediv> + <refname>domxml_children</refname> + <refpurpose> + Retourne les fils d'un noeud + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>domxml_children</function></funcdef> + <paramdef>object <parameter>doc|node</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>domxml_children</function> retourne tous les fils + du noeud <parameter>doc|node</parameter>, sous forme d'un tableau + de noeuds. + </para> + <para> + Dans l'exemple ci-dessous, la variable <varname>children</varname> + contiendra un tableau avec les noeuds de type XML_ELEMENT. Ce noeud est + l'&eacute;l&eacute;ment TITLE. + <example> + <title>Lire les fils d'un noeud</title> + <programlisting role="php"> &lt;?php -$doc = new_xmldoc("1.0"); -$root = $doc-&gt;add_root("HTML"); -$head = $root-&gt;new_child("HEAD", ""); -$head-&gt;new_child("TITLE", "Hier der Titel"); -$head-&gt;set_attribute("Language", "ge"); -$children = $head-&gt;children() + $doc = new_xmldoc("1.0"); + $root = $doc-&gt;add_root("HTML"); + $head = $root-&gt;new_child("HEAD", ""); + $head-&gt;new_child("TITLE", "Hier der Titel"); + $head-&gt;set_attribute("Language", "ge"); + $children = $head-&gt;children() ?&gt; - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.domxml_new_child"> - <refnamediv> - <refname>domxml_new_child</refname> - <refpurpose> - Ajoute un nouveau fils - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>resource <function>domxml_new_child</function></funcdef> - <paramdef>string <parameter>name</parameter></paramdef> - <paramdef>string <parameter>content</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>domxml_new_child</function> ajoute un nouveau fils. - (NDtraducteur : cette doc n'est pas encore finie...) - </para> - </refsect1> - </refentry> - <refentry id="function.domxml_new_xmldoc"> - <refnamediv> - <refname>domxml_new_xmldoc</refname> - <refpurpose> - Cr&eacute;e un document XML vide - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>object <function>domxml_new_xmldoc</function></funcdef> - <paramdef>string <parameter>version</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>domxml_new_xmldoc</function> cr&eacute;e un nouveau - document XML vide, et le retourne. - </para> - <para> - Voir aussi <function>domxml_add_root</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.xpath_new_context"> - <refnamediv> - <refname>xpath_new_context</refname> - <refpurpose> - Cr&eacute;e un nouveau contexte xpath - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>object <function>xpath_new_context</function></funcdef> - <paramdef>object <parameter>dom document</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - </para> - <para> - Pas de doc encore (22/2/2201). - </para> - </refsect1> - </refentry> - <refentry id="function.xpath_eval"> - <refnamediv> - <refname>xpath_eval</refname> - <refpurpose> - Evalue une expression xpath - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>xpath_eval</function></funcdef> - <paramdef>object <parameter>xpath context</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - </para> - <para> - Pas de doc encore (22/2/2201). - </para> - </refsect1> - </refentry> - </reference> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.domxml_new_child"> + <refnamediv> + <refname>domxml_new_child</refname> + <refpurpose> + Ajoute un nouveau fils + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>resource <function>domxml_new_child</function></funcdef> + <paramdef>string <parameter>name</parameter></paramdef> + <paramdef>string <parameter>content</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>domxml_new_child</function> ajoute un nouveau fils. + (NDtraducteur : cette documentation n'est pas encore finie...) + </para> + </refsect1> + </refentry> + <refentry id="function.domxml_new_xmldoc"> + <refnamediv> + <refname>domxml_new_xmldoc</refname> + <refpurpose> + Cr&eacute;e un document XML vide + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>object <function>domxml_new_xmldoc</function></funcdef> + <paramdef>string <parameter>version</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>domxml_new_xmldoc</function> cr&eacute;e un nouveau + document XML vide, et le retourne. + </para> + <para> + Voir aussi + <function>domxml_add_root</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.xpath_new_context"> + <refnamediv> + <refname>xpath_new_context</refname> + <refpurpose> + Cr&eacute;e un nouveau contexte xpath + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>object <function>xpath_new_context</function></funcdef> + <paramdef>object <parameter>dom_document</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + </para> + <para> + Pas de documentation encore (22/2/2201). + </para> + </refsect1> + </refentry> + <refentry id="function.xpath_eval"> + <refnamediv> + <refname>xpath_eval</refname> + <refpurpose> + Evalue une expression xpath + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>xpath_eval</function></funcdef> + <paramdef>object <parameter>xpath_context</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + </para> + <para> + Pas de documentation encore (22/2/2201). + </para> + </refsect1> + </refentry> +</reference> \ No newline at end of file
« previous php.doc (#969336297) next »