cvs: phpdoc /fr/appendices phpdevel.xml

From: Date: Wed, 06 Dec 2000 13:13:02 +0000
Subject: cvs: phpdoc /fr/appendices phpdevel.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969333157@lists.php.net to get a copy of this message
dams Wed Dec 6 05:13:02 2000 EDT Modified files: /phpdoc/fr/appendices phpdevel.xml Log: Removed some misused <function> tags

Index: phpdoc/fr/appendices/phpdevel.xml diff -u phpdoc/fr/appendices/phpdevel.xml:1.7 phpdoc/fr/appendices/phpdevel.xml:1.8 --- phpdoc/fr/appendices/phpdevel.xml:1.7 Mon Nov 20 10:29:14 2000 +++ phpdoc/fr/appendices/phpdevel.xml Wed Dec 6 05:13:02 2000 @@ -12,8 +12,8 @@ } </programlisting> - M&ecirc;me si votre fonction ne prend aucun argument, c'est comme cela qu'elle doit &ecirc;tre - appel&eacute;e. + M&ecirc;me si votre fonction ne prend aucun argument, c'est comme cela + qu'elle doit &ecirc;tre appel&eacute;e. </para> </sect2> @@ -55,7 +55,7 @@ <simpara> Par ailleurs, si vous modifiez un param&egrave;tre en IS_STRING, assurez vous - que vous avez bien assign&eacute; un nouvelle cha&icirc;ne avec <function>estrdup</function> + que vous avez bien assign&eacute; un nouvelle cha&icirc;ne avec estrdup() et une nouvelle longueur de cha&icirc;ne. Seulement apr&egrave;s, vous pouvez modifier le type en IS_STRING. Si vous modifiez une cha&icirc;ne en IS_STRING ou IS_ARRAY vous devez d'abord appeler le destructeur pval_destructor. @@ -242,7 +242,9 @@ <para> <example> - <title>V&eacute;rification de l'existance de $foo dans la table des sympboles</title> + <title> + V&eacute;rification de l'existance de $foo dans la table des sympboles + </title> <programlisting> if (hash_exists(active_symbol_table,"foo",sizeof("foo"))) { existe... } else { n'existe pas } @@ -287,14 +289,12 @@ hash_update(active_symbol_table,"foo",sizeof("foo"),&amp;arr,sizeof(pval),NULL); </programlisting> </example> - - Ce code d&eacute;clare un nouveau tableau, appel&eacute; $foo, dans la table de symbole Ce tableau est vide. + Ce code d&eacute;clare un nouveau tableau, appel&eacute; $foo, dans la table + de symbole. Ce tableau est vide. </para> - <simpara> Voici comment ajouter deux nouvelles entr&eacute;es dans ce tableau : </simpara> - <para> <example> <title>Ajout d'entr&eacute;es dans un tableau.</title> @@ -349,8 +349,8 @@ </programlisting> <para> - Bien sur, si l'ajout n'est pas fait juste apr&egrave;s l'initialisation, vous devrez - d'abord rechercher le tableau : + Bien sur, si l'ajout n'est pas fait juste apr&egrave;s l'initialisation, + vous devrez d'abord rechercher le tableau : <programlisting> pval *arr; @@ -400,14 +400,15 @@ </itemizedlist></para> <simpara> - Les macros ci dessus vont utiliser estrdup() sur les arguments pass&eacute;s. Cela vous - permet de lib&eacute;rer tranquillement les arguments apr&egrave;s avoir appel&eacute; cette fonction, - ou bien, utiliser de la m&eacute;moire allou&eacute;e statiquement. + Les macros ci dessus vont utiliser estrdup() sur les arguments pass&eacute;s. + Cela vous permet de lib&eacute;rer tranquillement les arguments apr&egrave;s + avoir appel&eacute; cette fonction, ou bien, utiliser de la m&eacute;moire + allou&eacute;e statiquement. </simpara> <simpara> - Si votre fonction retourne un bool&eacute;en de succ&egrave;s/erreur, utilisez toujours - RETURN_TRUE et RETURN_FALSE respectivement. + Si votre fonction retourne un bool&eacute;en de succ&egrave;s/erreur, + utilisez toujours RETURN_TRUE et RETURN_FALSE respectivement. </simpara> </sect2> @@ -421,42 +422,78 @@ Retourner un objet: <orderedlist numeration="arabic"> - <listitem><simpara>Appeler object_init(return_value).</simpara></listitem> - <listitem><para>Remplissez les valeurs. Les fonctions utilisables sont list&eacute;es ci - dessous.</para></listitem> - <listitem><para> Eventuellement, enregistrez les fonctions pour cet objet. - Afin de lire des valeurs de cet objet, la fonction doit lire dans "this", - dans la table de symbole active active_symbol_table. Son type doit &ecirc;tre - IS_OBJECT, et c'est une table de hash basique. (i.e., vous pouvez utiliser les - fonctions habituelles de .value.ht). L'enregistrement r&eacute;&eacute;l peut &ecirc;tre fait comme suit : + <listitem> + <simpara> + Appeler object_init(return_value). + </simpara> + </listitem> + <listitem> + <para> + Remplissez les valeurs. Les fonctions utilisables sont list&eacute;es ci + dessous. + </para> + </listitem> + <listitem> + <para> + Eventuellement, enregistrez les fonctions pour cet objet. + Afin de lire des valeurs de cet objet, la fonction doit lire dans "this", + dans la table de symbole active active_symbol_table. Son type doit &ecirc;tre + IS_OBJECT, et c'est une table de hash basique. (i.e., vous pouvez utiliser + les fonctions habituelles de .value.ht). L'enregistrement r&eacute;&eacute;l + peut &ecirc;tre fait comme suit : <programlisting> add_method( return_value, function_name, function_ptr ); - </programlisting></para></listitem> - </orderedlist></para> - + </programlisting> + </para> + </listitem> + </orderedlist> + </para> <para> Les fonctions d'acc&egrave;s aux objets sont : <itemizedlist> - <listitem><simpara>add_property_long( return_value, - property_name, l ) - Ajoute un membre nomm&eacute; 'property_name', de type long, &eacute;gal &agrave; - 'l'</simpara></listitem> - <listitem><simpara>add_property_double( return_value, - property_name, d ) - Idem, ajoute un double</simpara></listitem> - <listitem><simpara>add_property_string( return_value, - property_name, str ) - Idem, ajoute une cha&icirc;ne</simpara></listitem> - <listitem><simpara>add_property_stringl( return_value, - property_name, str, l ) - Idem, ajoute une cha&icirc;ne de longueur 'l'.</simpara></listitem> - </itemizedlist></para> - + <listitem> + <simpara> + add_property_long( return_value, property_name, l ) + - Ajoute un membre nomm&eacute; 'property_name', de type long, + &eacute;gal &agrave; 'l' + </simpara> + </listitem> + <listitem> + <simpara> + add_property_double( return_value, property_name, d ) + - Idem, ajoute un double + </simpara> + </listitem> + <listitem> + <simpara> + add_property_string( return_value, property_name, str ) + - Idem, ajoute une cha&icirc;ne + </simpara> + </listitem> + <listitem> + <simpara> + add_property_stringl( return_value, property_name, str, l ) + - Idem, ajoute une cha&icirc;ne de longueur 'l'. + </simpara> + </listitem> + </itemizedlist> + </para> <para> Retournez un tableau : - - <orderedlist numeration="arabic"> - <listitem><simpara>Appelez array_init(return_value).</simpara></listitem> - <listitem><simpara>Remplisez les valeurs. Les fonctions disponibles sont list&eacute;es - ci dessous.</simpara></listitem> - </orderedlist></para> - + <orderedlist numeration="arabic"> + <listitem> + <simpara> + Appelez array_init(return_value). + </simpara> + </listitem> + <listitem> + <simpara> + Remplisez les valeurs. Les fonctions disponibles sont list&eacute;es + ci dessous. + </simpara> + </listitem> + </orderedlist> + </para> <para> Les fonctions utilis&eacute;es pour acc&eacute;der &agrave; un tableau sont : <itemizedlist> @@ -724,12 +761,12 @@ <title>Appeler des fonctions utilisateurs</title> <simpara> - Pour appelrr des fonctions utilisateurs depuis une fonction interne, vous devez utiliser - la fonction <function>call_user_function</function>. + Pour appeler des fonctions utilisateurs depuis une fonction interne, vous + devez utiliser la fonction call_user_function(). </simpara> <simpara> - <function>call_user_function</function> retourne SUCCESS en cas de succ&egrave;s, + call_user_function() retourne SUCCESS en cas de succ&egrave;s, et FAILURE en cas d'&eacute;chec, ou si la fonction n'a pas &eacute;t&eacute; trouv&eacute;e. Vous devez v&eacute;rifier cette valeur. Si la r&eacute;ponse est SUCCESS, vous &ecirc;tes responsble de la destruction de retval (ou alors, retournez la comme valeur de r&eacute;ponse de votre fonction). Si la r&eacute;ponse @@ -743,7 +780,7 @@ </simpara> <simpara> - <function>call_user_function</function> prend 6 arguments : + call_user_function() prend 6 arguments : </simpara> <sect2 id="calling-user-functions.function-table"> @@ -770,7 +807,7 @@ <simpara> Le nom de la fonction &agrave; appeler. Elle doit &ecirc;tre de type pval, IS_STRING, avec les valeurs de function_name.str.val et function_name.str.len correctes. - function_name est modifi&eacute; par <function>call_user_function</function> - + function_name est modifi&eacute; par call_user_function() - il est converti en minuscule. Si vous voulez pr&eacute;server la casse, envoyez une copie du nom de la fonction. </simpara> @@ -781,7 +818,7 @@ <simpara> Un pointeur sur une structure pval, dans laquelle la valeur de retour de la fonction sera plac&eacute;e. La structure doit avoir &eacute;t&eacute; allou&eacute;e au pr&eacute;alable, - - <function>call_user_function</function> ne l'allouera pas. + - call_user_function() ne l'allouera pas. </simpara> </sect2> @@ -809,7 +846,7 @@ <simpara> Pour signaler les erreurs d'une fonction interne, vous devez appelez la fonction - <function>php3_error</function>. Cette fonction prend deux arguments au + php3_error(). Cette fonction prend deux arguments au moins : le niveau de l'erreur, et le message d'erreur, sous forme de cha&icirc;ne de caract&egrave;res. Tous les arguments suivants sont des param&egrave;tres de formats de cha&icirc;ne. Les niveaux d'erreurs sont :
« previous php.doc (#969333157) next »