cvs: phpdoc-fr /internals/zendapi calling-user-functions.xml

From: Date: Sun, 27 Nov 2005 15:23:38 +0000
Subject: cvs: phpdoc-fr /internals/zendapi calling-user-functions.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-4646@lists.php.net to get a copy of this message
yannick Sun Nov 27 10:23:38 2005 EDT Added files: /phpdoc-fr/internals/zendapi calling-user-functions.xml Log: initial translation http://cvs.php.net/co.php/phpdoc-fr/internals/zendapi/calling-user-functions.xml?r=1.1&p=1 Index: phpdoc-fr/internals/zendapi/calling-user-functions.xml +++ phpdoc-fr/internals/zendapi/calling-user-functions.xml <?xml version="1.0" encoding="ISO-8859-1" ?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <sect1 id="zend.calling-user-functions"> <title>Appel des fonctions utilisateurs</title> <para> Vous pouvez appeler des fonctions utilisateurs depuis vos propres modules, ce qui est très maniable lors de l'implémentation de callbacks ; par exemple, pour parcourir ou rechercher dans un tableau, ou simplement pour les évènements de vos programmes. </para> <para> Les fonctions utilisateurs peuvent être appelées avec la fonction <function>call_user_function_ex</function>. Elle requiet une valeur de hashage pour la table de fonction dont vous voulez accéder, un pointeur vers un objet (si vous voulez appeler une méthode), le nom de la fonction, la valeur retournée, le nombre d'arguments, un tableau d'arguments, et un flag indiquant si oui ou non vous voulez effectuer une séparation zval. </para> <programlisting> <![CDATA[ ZEND_API int call_user_function_ex(HashTable *function_table, zval *object, zval *function_name, zval **retval_ptr_ptr, int param_count, zval **params[], int no_separation); ]]> </programlisting> <para> Notez que vous n'avez pas besoin de spécifier à la fois <envar>function_table</envar> et <envar>object</envar> ; l'un ou l'autre suffit. Si vous voulez appeler une méthode, vous devez fournir l'objet qui contient cette méthode, et dans ce cas, <function>call_user_function</function> définit automatiquement la table de fonction à cette objet. Sinon, vous ne devez spécifier que <envar>function_table</envar> et vous pouvez définir <envar>object</envar> à &null;. </para> <para> Habituellement, la table de fonction par défaut est la table de fonction "root" contenant toutes les entrées de fonction. Cette table de fonction est une partie du compilateur global et peut être accéder en utilisant la macro <literal>CG</literal>. Pour introduite le compilateur globale à votre fonction, appeler d'abord la macro <literal>TSRMLS_FETCH</literal>. </para> <para> Le nom de la fonction est spécifié dans un conteneur <envar>zval</envar>. Ceci peut paraître surprenant dans un premier temps, mais c'est une étape logique, car la plupart des fois, vous accepterez des noms de fonctions en tant queparamètres pour l'appel des fonctions dans votre script, qui seront eux-même dans un conteneur <envar>zval</envar>. Vous n'avez qu'à passer vos arguments via cette fonction. Ce conteneur <envar>zval</envar> doit être du type <literal>IS_STRING</literal>. </para> <para> Le prochain argument consiste en un pointeur de la valeur retournée. Vous n'avez pas à allouer de mémoire pour ce conteneur ; la fonction le fera elle-même. Cependant, vous devez ensuite détruire ce conteneur (en utilisant la fonction <function>zval_dtor</function>) ! </para> <para> Le prochain est le paramètre de compteur (un entier) et un tableau contenant tous les paramètres nécessaires. Le dernier argument indique si la fonction doit effectuer une séparation zval - il doit toujours être défini à <literal>0</literal>. Si défini à <literal>1</literal>, la fonction consomme moins de mémoire mais échoue si un des paramètres doit être séparer. </para> <para> <xref linkend='example.call-user-func'/> montre une petite démonstration de l'appel d'une fonction utilisateur. Le code appelle une fonction qui lui est fournie en tant qu'argument et passe directement la valeur retournée par cette fonction via sa propre valeur retournée. Notez l'utilisation du constructeur et du destructeur à la fin - celà peut ne pas être nécessaire ici (car les valeurs doivent être séparées, l'assignement est sécurisé), mais c'est plus prudent. </para> <example id='example.call-user-func'> <title>Appeler des fonctions utilisateurs</title> <programlisting> <![CDATA[ zval **function_name; zval *retval; if((ZEND_NUM_ARGS() != 1) || (zend_get_parameters_ex(1, &function_name) != SUCCESS)) { WRONG_PARAM_COUNT; } if((*function_name)->type != IS_STRING) { zend_error(E_ERROR, "La fonction requiet une chaîne de caractères en tant qu'argument."); } TSRMSLS_FETCH(); if(call_user_function_ex(CG(function_table), NULL, *function_name, &retval, 0, NULL, 0) != SUCCESS) { zend_error(E_ERROR, "L'appel à la fonction a échoué"); } zend_printf("We have %i as type<br />", retval->type); *return_value = *retval; zval_copy_ctor(return_value); zval_ptr_dtor(&retval); ]]> </programlisting> </example> <para/> <programlisting> <![CDATA[ <?php dl("call_userland.so"); function test_function() { print("Nous sommes dans une fonction de test !<br />"); return("hello"); } $return_value = call_userland("test_function"); print("Valeur retournée : \"$return_value\"<br />"); ?> ]]> </programlisting> <graphic fileref="figures/zend.10-userland.png"/> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->

« previous php.doc.fr (#4646) next »