cvs: phpdoc /fr/appendices phpdevel.xml
| From: | Damien Seguy | 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ême si votre fonction ne prend aucun argument, c'est comme cela qu'elle doit être - appelée. + Même si votre fonction ne prend aucun argument, c'est comme cela + qu'elle doit être appelée. </para> </sect2> @@ -55,7 +55,7 @@ <simpara> Par ailleurs, si vous modifiez un paramètre en IS_STRING, assurez vous - que vous avez bien assigné un nouvelle chaîne avec <function>estrdup</function> + que vous avez bien assigné un nouvelle chaîne avec estrdup() et une nouvelle longueur de chaîne. Seulement après, vous pouvez modifier le type en IS_STRING. Si vous modifiez une chaîne en IS_STRING ou IS_ARRAY vous devez d'abord appeler le destructeur pval_destructor. @@ -242,7 +242,9 @@ <para> <example> - <title>Vérification de l'existance de $foo dans la table des sympboles</title> + <title> + Vé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"),&arr,sizeof(pval),NULL); </programlisting> </example> - - Ce code déclare un nouveau tableau, appelé $foo, dans la table de symbole Ce tableau est vide. + Ce code déclare un nouveau tableau, appelé $foo, dans la table + de symbole. Ce tableau est vide. </para> - <simpara> Voici comment ajouter deux nouvelles entrées dans ce tableau : </simpara> - <para> <example> <title>Ajout d'entrées dans un tableau.</title> @@ -349,8 +349,8 @@ </programlisting> <para> - Bien sur, si l'ajout n'est pas fait juste après l'initialisation, vous devrez - d'abord rechercher le tableau : + Bien sur, si l'ajout n'est pas fait juste aprè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és. Cela vous - permet de libérer tranquillement les arguments après avoir appelé cette fonction, - ou bien, utiliser de la mémoire allouée statiquement. + Les macros ci dessus vont utiliser estrdup() sur les arguments passés. + Cela vous permet de libérer tranquillement les arguments après + avoir appelé cette fonction, ou bien, utiliser de la mémoire + allouée statiquement. </simpara> <simpara> - Si votre fonction retourne un booléen de succès/erreur, utilisez toujours - RETURN_TRUE et RETURN_FALSE respectivement. + Si votre fonction retourne un booléen de succè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é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 ê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éél peut être fait comme suit : + <listitem> + <simpara> + Appeler object_init(return_value). + </simpara> + </listitem> + <listitem> + <para> + Remplissez les valeurs. Les fonctions utilisables sont listé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 ê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éél + peut ê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ès aux objets sont : <itemizedlist> - <listitem><simpara>add_property_long( return_value, - property_name, l ) - Ajoute un membre nommé 'property_name', de type long, égal à - '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îne</simpara></listitem> - <listitem><simpara>add_property_stringl( return_value, - property_name, str, l ) - Idem, ajoute une chaîne de longueur 'l'.</simpara></listitem> - </itemizedlist></para> - + <listitem> + <simpara> + add_property_long( return_value, property_name, l ) + - Ajoute un membre nommé 'property_name', de type long, + égal à '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îne + </simpara> + </listitem> + <listitem> + <simpara> + add_property_stringl( return_value, property_name, str, l ) + - Idem, ajoute une chaî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é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ées + ci dessous. + </simpara> + </listitem> + </orderedlist> + </para> <para> Les fonctions utilisées pour accéder à 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ès, + call_user_function() retourne SUCCESS en cas de succès, et FAILURE en cas d'échec, ou si la fonction n'a pas été trouvée. Vous devez vérifier cette valeur. Si la réponse est SUCCESS, vous êtes responsble de la destruction de retval (ou alors, retournez la comme valeur de réponse de votre fonction). Si la ré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 à appeler. Elle doit être de type pval, IS_STRING, avec les valeurs de function_name.str.val et function_name.str.len correctes. - function_name est modifié par <function>call_user_function</function> - + function_name est modifié par call_user_function() - il est converti en minuscule. Si vous voulez pré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ée. La structure doit avoir été allouée au pré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îne de caractères. Tous les arguments suivants sont des paramètres de formats de chaîne. Les niveaux d'erreurs sont :
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ême si votre fonction ne prend aucun argument, c'est comme cela qu'elle doit être - appelée. + Même si votre fonction ne prend aucun argument, c'est comme cela + qu'elle doit être appelée. </para> </sect2> @@ -55,7 +55,7 @@ <simpara> Par ailleurs, si vous modifiez un paramètre en IS_STRING, assurez vous - que vous avez bien assigné un nouvelle chaîne avec <function>estrdup</function> + que vous avez bien assigné un nouvelle chaîne avec estrdup() et une nouvelle longueur de chaîne. Seulement après, vous pouvez modifier le type en IS_STRING. Si vous modifiez une chaîne en IS_STRING ou IS_ARRAY vous devez d'abord appeler le destructeur pval_destructor. @@ -242,7 +242,9 @@ <para> <example> - <title>Vérification de l'existance de $foo dans la table des sympboles</title> + <title> + Vé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"),&arr,sizeof(pval),NULL); </programlisting> </example> - - Ce code déclare un nouveau tableau, appelé $foo, dans la table de symbole Ce tableau est vide. + Ce code déclare un nouveau tableau, appelé $foo, dans la table + de symbole. Ce tableau est vide. </para> - <simpara> Voici comment ajouter deux nouvelles entrées dans ce tableau : </simpara> - <para> <example> <title>Ajout d'entrées dans un tableau.</title> @@ -349,8 +349,8 @@ </programlisting> <para> - Bien sur, si l'ajout n'est pas fait juste après l'initialisation, vous devrez - d'abord rechercher le tableau : + Bien sur, si l'ajout n'est pas fait juste aprè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és. Cela vous - permet de libérer tranquillement les arguments après avoir appelé cette fonction, - ou bien, utiliser de la mémoire allouée statiquement. + Les macros ci dessus vont utiliser estrdup() sur les arguments passés. + Cela vous permet de libérer tranquillement les arguments après + avoir appelé cette fonction, ou bien, utiliser de la mémoire + allouée statiquement. </simpara> <simpara> - Si votre fonction retourne un booléen de succès/erreur, utilisez toujours - RETURN_TRUE et RETURN_FALSE respectivement. + Si votre fonction retourne un booléen de succè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é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 ê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éél peut être fait comme suit : + <listitem> + <simpara> + Appeler object_init(return_value). + </simpara> + </listitem> + <listitem> + <para> + Remplissez les valeurs. Les fonctions utilisables sont listé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 ê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éél + peut ê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ès aux objets sont : <itemizedlist> - <listitem><simpara>add_property_long( return_value, - property_name, l ) - Ajoute un membre nommé 'property_name', de type long, égal à - '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îne</simpara></listitem> - <listitem><simpara>add_property_stringl( return_value, - property_name, str, l ) - Idem, ajoute une chaîne de longueur 'l'.</simpara></listitem> - </itemizedlist></para> - + <listitem> + <simpara> + add_property_long( return_value, property_name, l ) + - Ajoute un membre nommé 'property_name', de type long, + égal à '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îne + </simpara> + </listitem> + <listitem> + <simpara> + add_property_stringl( return_value, property_name, str, l ) + - Idem, ajoute une chaî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é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ées + ci dessous. + </simpara> + </listitem> + </orderedlist> + </para> <para> Les fonctions utilisées pour accéder à 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ès, + call_user_function() retourne SUCCESS en cas de succès, et FAILURE en cas d'échec, ou si la fonction n'a pas été trouvée. Vous devez vérifier cette valeur. Si la réponse est SUCCESS, vous êtes responsble de la destruction de retval (ou alors, retournez la comme valeur de réponse de votre fonction). Si la ré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 à appeler. Elle doit être de type pval, IS_STRING, avec les valeurs de function_name.str.val et function_name.str.len correctes. - function_name est modifié par <function>call_user_function</function> - + function_name est modifié par call_user_function() - il est converti en minuscule. Si vous voulez pré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ée. La structure doit avoir été allouée au pré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îne de caractères. Tous les arguments suivants sont des paramètres de formats de chaîne. Les niveaux d'erreurs sont :