cvs: phpdoc /fr/functions funchand.xml

From: Date: Tue, 28 Nov 2000 10:50:16 +0000
Subject: cvs: phpdoc /fr/functions funchand.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969333091@lists.php.net to get a copy of this message
dams Tue Nov 28 02:50:16 2000 EDT Modified files: /phpdoc/fr/functions funchand.xml Log: Added last example.

Index: phpdoc/fr/functions/funchand.xml diff -u phpdoc/fr/functions/funchand.xml:1.2 phpdoc/fr/functions/funchand.xml:1.3 --- phpdoc/fr/functions/funchand.xml:1.2 Thu Nov 23 06:45:06 2000 +++ phpdoc/fr/functions/funchand.xml Tue Nov 28 02:50:16 2000 @@ -1,14 +1,12 @@ <reference id="ref.funchand"> <title>Fonctions de fonctions</title> <titleabbrev>Fonctions</titleabbrev> - <partintro> <para> - Ces fonctions effectuent les manipulations li&eacute;es &agrave; + Ces fonctions effectuent les manipulations li&eacute;es &agrave; la gestion des fonctions. </para> </partintro> - <refentry id="function.call-user-func"> <refnamediv> <refname>call_user_func</refname> @@ -20,16 +18,16 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>mixed + <funcdef>mixed <function>call_user_func</function> </funcdef> - <paramdef>string + <paramdef>string <parameter>function_name</parameter> </paramdef> - <paramdef>mixed + <paramdef>mixed <parameter><optional>parameter</optional></parameter> </paramdef> - <paramdef>mixed + <paramdef>mixed <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> @@ -37,7 +35,7 @@ <para> Appelle la fonction utilisateur <parameter>function_name</parameter>, et lui passe les param&egrave;tres <parameter><optional>parameter</optional></parameter>. - Par exemple : + Par exemple : <informalexample> <programlisting role="php"> function barbier ($type) { @@ -66,20 +64,20 @@ </funcprototype> </funcsynopsis> <para> - Cette fonction cr&eacute;e une fonction anonyme, &agrave; partir des - param&egrave;tres pass&eacute;s, et retourne un nom unique. - G&eacute;n&eacute;ralement, les arguments - <parameter>args</parameter> sont pr&eacute;sent&eacute;s sous - la forme d'une cha&icirc;ne &agrave; guillemets simples, et la - m&ecirc;me recommandation vaut pour <parameter>code</parameter>. - La raison de l'utilisation des guillemets simples est de proteger - les noms de variables du remplacement par leur valeur. Si vous utilisez + Cette fonction cr&eacute;e une fonction anonyme, &agrave; partir des + param&egrave;tres pass&eacute;s, et retourne un nom unique. + G&eacute;n&eacute;ralement, les arguments + <parameter>args</parameter> sont pr&eacute;sent&eacute;s sous + la forme d'une cha&icirc;ne &agrave; guillemets simples, et la + m&ecirc;me recommandation vaut pour <parameter>code</parameter>. + La raison de l'utilisation des guillemets simples est de proteger + les noms de variables du remplacement par leur valeur. Si vous utilisez les guillemets doubles, n'oubliez pas d'&eacute;chapper les noms de variables (i.e. <literal>\$avar</literal>). </para> <para> - Vous pouvez utiliser cette fonction pour (par exemple) cr&eacute;er - une fonction &agrave; partir d'informations r&eacute;colt&eacute;s + Vous pouvez utiliser cette fonction pour (par exemple) cr&eacute;er + une fonction &agrave; partir d'informations r&eacute;colt&eacute;s durant l'&eacute;x&eacute;cution. <example> <title> @@ -89,16 +87,16 @@ $newfunc = create_function('$a,$b','return "ln($a) + ln($b) = ".log($a * $b);'); echo "Nouvelle fonction anonyme : $newfunc\n"; echo $newfunc(2,M_E)."\n"; -// affichera : +// affichera : // Nouvelle fonction anonyme : lambda_1 // ln(2) + ln(2.718281828459) = 1.6931471805599 </programlisting> </example> - Ou, pour pouvoir appliquer une fonction g&eacute;n&eacute;rique + Ou, pour pouvoir appliquer une fonction g&eacute;n&eacute;rique &agrave; une liste d'arguments. <example> <title> - Traitement g&eacute;n&eacute;rique par fonction avec + Traitement g&eacute;n&eacute;rique par fonction avec <function>create_function</function> </title> <programlisting role="php"> @@ -106,7 +104,6 @@ for ($f=0; $f &lt; count($farr); $f++) echo $farr[$f]($var1,$var2)."\n"; } - // creation d'une s&eacute;rie de fonction math&eacute;matiques $f1 = 'if ($a &gt;=0) {return "b*a^2 = ".$b*sqrt($a);} else {return false;}'; $f2 = "return \"min(b^2+a, a^2,b) = \".min(\$a*\$a+\$b,\$b*\$b+\$a);"; @@ -118,11 +115,9 @@ create_function('$a,$b', $f2), create_function('$a,$b', $f3) ); - echo "\nUtilisation de la premi&egrave;re liste de fonctions anonymes\n"; echo "param&eacute;tres: 2.3445, M_PI\n"; process(2.3445, M_PI, $farr); - // Maintenant une liste de fonction sur cha&icirc;ne de caract&egrave;res $garr = array( create_function('$b,$a','if (strncmp($a,$b,3) == 0) return "** \"$a\" '. @@ -134,7 +129,7 @@ process("Twas brilling and the slithy toves", "Twas the night", $garr); </programlisting> </example> - Et lorsque vous utilisez le code ci dessus, l'affichage va &ecirc;tre + Et lorsque vous utilisez le code ci dessus, l'affichage va &ecirc;tre <informalexample> <programlisting> Utilisation de la premi&egrave;re liste de fonctions anonymes @@ -144,7 +139,6 @@ b*a^2 = 4.8103313314525 min(b^2+a, a^2,b) = 8.6382729035898 ln(a/b) = 0.27122299212594 - Utilisation de la seconde liste de fonctions anonymes ** "Twas the night" et "Twas brilling and the slithy toves" ** Ces cha&icirc;nes de ressemblent!! (regarde les trois premiers caract&egrave;res) @@ -153,7 +147,7 @@ </programlisting> </informalexample> Mais l'utilisation la plus courante des fonctions lambda est la - fonction de callback, par exemple lors de l'utilisation de + fonction de callback, par exemple lors de l'utilisation de <function>array_walk</function> ou <function>usort</function> <example> <title>Utilisation de fonctions anonymes comme fonction de callback</title> @@ -169,7 +163,6 @@ // [2] =&gt; cette maison // [3] =&gt; une certaine maison // ) - // un tableau de cha&icirc;ne class&eacute; par taille $sv = array("petite","moyenne","tres longue","vraiment tres longue"); print_r($sv); @@ -181,7 +174,6 @@ // [2] =&gt; tres longue // [3] =&gt; vraiment tres longue // ) - // Tri par ordre de taille d&eacute;croissant usort($sv, create_function('$a,$b','return strlen($b) - strlen($a);')); print_r($sv); @@ -198,7 +190,6 @@ </para> </refsect1> </refentry> - <refentry id="function.func-get-arg"> <refnamediv> <refname>func_get_arg</refname> @@ -215,15 +206,15 @@ </funcprototype> </funcsynopsis> <simpara> - Retourne l'argument &agrave; la position <parameter>arg_num</parameter> dans + Retourne l'argument &agrave; la position <parameter>arg_num</parameter> dans la liste d'argument d'une fonction utilisateur. Les arguments sont - compt&eacute;s en commencant &agrave; z&eacute;ro. + compt&eacute;s en commencant &agrave; z&eacute;ro. <function>func_get_arg</function> g&eacute;n&eacute;rera une alerte si elle est appel&eacute;e hors d'une fonction. </simpara> <simpara> Si <parameter>arg_num</parameter> est plus grand que le nombre - d'arguments pass&eacute;s, une alerte est g&eacute;n&eacute;r&eacute;e + d'arguments pass&eacute;s, une alerte est g&eacute;n&eacute;r&eacute;e et la fonction retourne FALSE. </simpara> <para> @@ -236,15 +227,14 @@ if ($numargs &gt;= 2) { echo "Le second argument est: " . func_get_arg (1) . "&lt;br&gt;\n"; } -} - +} foo (1, 2, 3); ?&gt; </programlisting> </informalexample> </para> <simpara> - <function>Func_get_arg</function> peut &ecirc;tre utilis&eacute; + <function>func_get_arg</function> peut &ecirc;tre utilis&eacute; conjointement &agrave; <function>func_num_args</function> et <function>func_get_args</function> pour permettre aux fonctions utilisateurs d'accepter un nombre variable d'arguments. @@ -256,7 +246,6 @@ </note> </refsect1> </refentry> - <refentry id="function.func-get-args"> <refnamediv> <refname>func_get_args</refname> @@ -273,9 +262,9 @@ </funcprototype> </funcsynopsis> <simpara> - Retourne un tableau dont les &eacute;l&eacute;ments correspondent - aux &eacute;l&eacute;ments de la liste d'arguments de la fonction. - <function>Func_get_args</function> g&eacute;n&eacute;rera une + Retourne un tableau dont les &eacute;l&eacute;ments correspondent + aux &eacute;l&eacute;ments de la liste d'arguments de la fonction. + <function>func_get_args</function> g&eacute;n&eacute;rera une alerte si elle est appel&eacute;e hors d'une fonction. </simpara> <para> @@ -292,15 +281,14 @@ for ($i = 0; $i &lt; $numargs; $i++) { echo "L'argument $i est: " . $arg_list[$i] . "&lt;br&gt;\n"; } -} - +} foo (1, 2, 3); ?&gt; </programlisting> </informalexample> </para> <simpara> - <function>Func_get_arg</function> peut &ecirc;tre utilis&eacute; + <function>func_get_arg</function> peut &ecirc;tre utilis&eacute; conjointement &agrave; <function>func_num_args</function> et <function>func_get_args</function> pour permettre aux fonctions utilisateurs d'accepter un nombre variable d'arguments. @@ -312,7 +300,6 @@ </note> </refsect1> </refentry> - <refentry id="function.func-num-args"> <refnamediv> <refname>func_num_args</refname> @@ -329,9 +316,9 @@ </funcprototype> </funcsynopsis> <simpara> - Retourne le nombre d'arguments pass&eacute; &agrave; la fonction - utilisateur courante. <function>Func_num_args</function> - g&eacute;n&eacute;rera une alerte si elle est appel&eacute;e + Retourne le nombre d'arguments pass&eacute; &agrave; la fonction + utilisateur courante. <function>func_num_args</function> + g&eacute;n&eacute;rera une alerte si elle est appel&eacute;e hors d'une fonction. </simpara> <para> @@ -341,15 +328,14 @@ function foo() { $numargs = func_num_args(); echo "Nombre d'arguments: $numargs\n"; -} - +} foo (1, 2, 3); // affiche 'Nombre d'arguments: 3' ?&gt; </programlisting> </informalexample> </para> <simpara> - <function>Func_get_arg</function> peut &ecirc;tre utilis&eacute; + <function>func_get_arg</function> peut &ecirc;tre utilis&eacute; conjointement &agrave; <function>func_num_args</function> et <function>func_get_args</function> pour permettre aux fonctions utilisateurs d'accepter un nombre variable d'arguments. @@ -361,12 +347,11 @@ </note> </refsect1> </refentry> - <refentry id="function.function-exists"> <refnamediv> <refname>function_exists</refname> <refpurpose> - Retourne true si la fonction a d&eacute;j&agrave; &eacute;t&eacute; + Retourne TRUE si la fonction a d&eacute;j&agrave; &eacute;t&eacute; d&eacute;finie. </refpurpose> </refnamediv> @@ -378,14 +363,25 @@ <paramdef>string <parameter>function_name</parameter></paramdef> </funcprototype> </funcsynopsis> - <simpara> - V&eacute;rifie la liste des fonctions d&eacute;finies par - l'utilisateur, et retourne TRUE si <parameter>function_name</parameter> + <para> + V&eacute;rifie la liste des fonctions d&eacute;finies par + l'utilisateur, et retourne TRUE si <parameter>function_name</parameter> y est trouv&eacute;, FALSE sinon. - </simpara> + <informalexample> + <programlisting role="php"> +if (function_exists('imap_open')) { + echo "Les fonctions IMAP sont disponibles.&lt;br&gt;\n"; +} else { + echo "Les fonctions IMAP ne sont pas disponibles.&lt;br&gt;\n"; +} + </programlisting> + </informalexample> + </para> + <para> + Voir aussi <function>method_exists</function>. + </para> </refsect1> </refentry> - <refentry id="function.register-shutdown-function"> <refnamediv> <refname>register_shutdown_function</refname> @@ -397,29 +393,27 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int + <funcdef>int <function>register_shutdown_function</function> </funcdef> <paramdef>string <parameter>func</parameter></paramdef> </funcprototype> </funcsynopsis> <simpara> - Enregistre la fonction <parameter>func</parameter> pour + Enregistre la fonction <parameter>func</parameter> pour ex&eacute;cution &agrave; l'extinction du script. </simpara> <para> - Erreur courante : + Erreur courante : </para> <simpara> Etant donn&eacute; qu'aucuna affichage n'est possible depuis cette fonction, - vous ne pouvez pas mettre d'informations de d&eacute;buggage par print + vous ne pouvez pas mettre d'informations de d&eacute;buggage par print ou echo ici! </simpara> </refsect1> </refentry> - </reference> - <!-- Keep this comment at the end of the file Local variables: mode: sgml
« previous php.doc (#969333091) next »