cvs: phpdoc /fr/functions funchand.xml
| From: | Damien Seguy | 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ées à + Ces fonctions effectuent les manipulations liées à 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è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ée une fonction anonyme, à partir des - paramètres passés, et retourne un nom unique. - Généralement, les arguments - <parameter>args</parameter> sont présentés sous - la forme d'une chaîne à guillemets simples, et la - mê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ée une fonction anonyme, à partir des + paramètres passés, et retourne un nom unique. + Généralement, les arguments + <parameter>args</parameter> sont présentés sous + la forme d'une chaîne à guillemets simples, et la + mê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'échapper les noms de variables (i.e. <literal>\$avar</literal>). </para> <para> - Vous pouvez utiliser cette fonction pour (par exemple) créer - une fonction à partir d'informations récoltés + Vous pouvez utiliser cette fonction pour (par exemple) créer + une fonction à partir d'informations récoltés durant l'éxé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énérique + Ou, pour pouvoir appliquer une fonction générique à une liste d'arguments. <example> <title> - Traitement générique par fonction avec + Traitement générique par fonction avec <function>create_function</function> </title> <programlisting role="php"> @@ -106,7 +104,6 @@ for ($f=0; $f < count($farr); $f++) echo $farr[$f]($var1,$var2)."\n"; } - // creation d'une série de fonction mathématiques $f1 = 'if ($a >=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ère liste de fonctions anonymes\n"; echo "paramétres: 2.3445, M_PI\n"; process(2.3445, M_PI, $farr); - // Maintenant une liste de fonction sur chaîne de caractè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 être + Et lorsque vous utilisez le code ci dessus, l'affichage va être <informalexample> <programlisting> Utilisation de la premiè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înes de ressemblent!! (regarde les trois premiers caractè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] => cette maison // [3] => une certaine maison // ) - // un tableau de chaîne classé par taille $sv = array("petite","moyenne","tres longue","vraiment tres longue"); print_r($sv); @@ -181,7 +174,6 @@ // [2] => tres longue // [3] => vraiment tres longue // ) - // Tri par ordre de taille dé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 à la position <parameter>arg_num</parameter> dans + Retourne l'argument à la position <parameter>arg_num</parameter> dans la liste d'argument d'une fonction utilisateur. Les arguments sont - comptés en commencant à zéro. + comptés en commencant à zéro. <function>func_get_arg</function> générera une alerte si elle est appelée hors d'une fonction. </simpara> <simpara> Si <parameter>arg_num</parameter> est plus grand que le nombre - d'arguments passés, une alerte est générée + d'arguments passés, une alerte est générée et la fonction retourne FALSE. </simpara> <para> @@ -236,15 +227,14 @@ if ($numargs >= 2) { echo "Le second argument est: " . func_get_arg (1) . "<br>\n"; } -} - +} foo (1, 2, 3); ?> </programlisting> </informalexample> </para> <simpara> - <function>Func_get_arg</function> peut être utilisé + <function>func_get_arg</function> peut être utilisé conjointement à <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 éléments correspondent - aux éléments de la liste d'arguments de la fonction. - <function>Func_get_args</function> générera une + Retourne un tableau dont les éléments correspondent + aux éléments de la liste d'arguments de la fonction. + <function>func_get_args</function> générera une alerte si elle est appelée hors d'une fonction. </simpara> <para> @@ -292,15 +281,14 @@ for ($i = 0; $i < $numargs; $i++) { echo "L'argument $i est: " . $arg_list[$i] . "<br>\n"; } -} - +} foo (1, 2, 3); ?> </programlisting> </informalexample> </para> <simpara> - <function>Func_get_arg</function> peut être utilisé + <function>func_get_arg</function> peut être utilisé conjointement à <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é à la fonction - utilisateur courante. <function>Func_num_args</function> - générera une alerte si elle est appelée + Retourne le nombre d'arguments passé à la fonction + utilisateur courante. <function>func_num_args</function> + générera une alerte si elle est appelé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' ?> </programlisting> </informalexample> </para> <simpara> - <function>Func_get_arg</function> peut être utilisé + <function>func_get_arg</function> peut être utilisé conjointement à <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éjà été + Retourne TRUE si la fonction a déjà été définie. </refpurpose> </refnamediv> @@ -378,14 +363,25 @@ <paramdef>string <parameter>function_name</parameter></paramdef> </funcprototype> </funcsynopsis> - <simpara> - Vérifie la liste des fonctions définies par - l'utilisateur, et retourne TRUE si <parameter>function_name</parameter> + <para> + Vérifie la liste des fonctions définies par + l'utilisateur, et retourne TRUE si <parameter>function_name</parameter> y est trouvé, FALSE sinon. - </simpara> + <informalexample> + <programlisting role="php"> +if (function_exists('imap_open')) { + echo "Les fonctions IMAP sont disponibles.<br>\n"; +} else { + echo "Les fonctions IMAP ne sont pas disponibles.<br>\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écution à l'extinction du script. </simpara> <para> - Erreur courante : + Erreur courante : </para> <simpara> Etant donné qu'aucuna affichage n'est possible depuis cette fonction, - vous ne pouvez pas mettre d'informations de débuggage par print + vous ne pouvez pas mettre d'informations de débuggage par print ou echo ici! </simpara> </refsect1> </refentry> - </reference> - <!-- Keep this comment at the end of the file Local variables: mode: sgml
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ées à + Ces fonctions effectuent les manipulations liées à 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è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ée une fonction anonyme, à partir des - paramètres passés, et retourne un nom unique. - Généralement, les arguments - <parameter>args</parameter> sont présentés sous - la forme d'une chaîne à guillemets simples, et la - mê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ée une fonction anonyme, à partir des + paramètres passés, et retourne un nom unique. + Généralement, les arguments + <parameter>args</parameter> sont présentés sous + la forme d'une chaîne à guillemets simples, et la + mê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'échapper les noms de variables (i.e. <literal>\$avar</literal>). </para> <para> - Vous pouvez utiliser cette fonction pour (par exemple) créer - une fonction à partir d'informations récoltés + Vous pouvez utiliser cette fonction pour (par exemple) créer + une fonction à partir d'informations récoltés durant l'éxé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énérique + Ou, pour pouvoir appliquer une fonction générique à une liste d'arguments. <example> <title> - Traitement générique par fonction avec + Traitement générique par fonction avec <function>create_function</function> </title> <programlisting role="php"> @@ -106,7 +104,6 @@ for ($f=0; $f < count($farr); $f++) echo $farr[$f]($var1,$var2)."\n"; } - // creation d'une série de fonction mathématiques $f1 = 'if ($a >=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ère liste de fonctions anonymes\n"; echo "paramétres: 2.3445, M_PI\n"; process(2.3445, M_PI, $farr); - // Maintenant une liste de fonction sur chaîne de caractè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 être + Et lorsque vous utilisez le code ci dessus, l'affichage va être <informalexample> <programlisting> Utilisation de la premiè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înes de ressemblent!! (regarde les trois premiers caractè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] => cette maison // [3] => une certaine maison // ) - // un tableau de chaîne classé par taille $sv = array("petite","moyenne","tres longue","vraiment tres longue"); print_r($sv); @@ -181,7 +174,6 @@ // [2] => tres longue // [3] => vraiment tres longue // ) - // Tri par ordre de taille dé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 à la position <parameter>arg_num</parameter> dans + Retourne l'argument à la position <parameter>arg_num</parameter> dans la liste d'argument d'une fonction utilisateur. Les arguments sont - comptés en commencant à zéro. + comptés en commencant à zéro. <function>func_get_arg</function> générera une alerte si elle est appelée hors d'une fonction. </simpara> <simpara> Si <parameter>arg_num</parameter> est plus grand que le nombre - d'arguments passés, une alerte est générée + d'arguments passés, une alerte est générée et la fonction retourne FALSE. </simpara> <para> @@ -236,15 +227,14 @@ if ($numargs >= 2) { echo "Le second argument est: " . func_get_arg (1) . "<br>\n"; } -} - +} foo (1, 2, 3); ?> </programlisting> </informalexample> </para> <simpara> - <function>Func_get_arg</function> peut être utilisé + <function>func_get_arg</function> peut être utilisé conjointement à <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 éléments correspondent - aux éléments de la liste d'arguments de la fonction. - <function>Func_get_args</function> générera une + Retourne un tableau dont les éléments correspondent + aux éléments de la liste d'arguments de la fonction. + <function>func_get_args</function> générera une alerte si elle est appelée hors d'une fonction. </simpara> <para> @@ -292,15 +281,14 @@ for ($i = 0; $i < $numargs; $i++) { echo "L'argument $i est: " . $arg_list[$i] . "<br>\n"; } -} - +} foo (1, 2, 3); ?> </programlisting> </informalexample> </para> <simpara> - <function>Func_get_arg</function> peut être utilisé + <function>func_get_arg</function> peut être utilisé conjointement à <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é à la fonction - utilisateur courante. <function>Func_num_args</function> - générera une alerte si elle est appelée + Retourne le nombre d'arguments passé à la fonction + utilisateur courante. <function>func_num_args</function> + générera une alerte si elle est appelé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' ?> </programlisting> </informalexample> </para> <simpara> - <function>Func_get_arg</function> peut être utilisé + <function>func_get_arg</function> peut être utilisé conjointement à <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éjà été + Retourne TRUE si la fonction a déjà été définie. </refpurpose> </refnamediv> @@ -378,14 +363,25 @@ <paramdef>string <parameter>function_name</parameter></paramdef> </funcprototype> </funcsynopsis> - <simpara> - Vérifie la liste des fonctions définies par - l'utilisateur, et retourne TRUE si <parameter>function_name</parameter> + <para> + Vérifie la liste des fonctions définies par + l'utilisateur, et retourne TRUE si <parameter>function_name</parameter> y est trouvé, FALSE sinon. - </simpara> + <informalexample> + <programlisting role="php"> +if (function_exists('imap_open')) { + echo "Les fonctions IMAP sont disponibles.<br>\n"; +} else { + echo "Les fonctions IMAP ne sont pas disponibles.<br>\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écution à l'extinction du script. </simpara> <para> - Erreur courante : + Erreur courante : </para> <simpara> Etant donné qu'aucuna affichage n'est possible depuis cette fonction, - vous ne pouvez pas mettre d'informations de débuggage par print + vous ne pouvez pas mettre d'informations de débuggage par print ou echo ici! </simpara> </refsect1> </refentry> - </reference> - <!-- Keep this comment at the end of the file Local variables: mode: sgml