Index: phpdoc/fr/functions/funchand.xml diff -u phpdoc/fr/functions/funchand.xml:1.13 phpdoc/fr/functions/funchand.xml:1.14 --- phpdoc/fr/functions/funchand.xml:1.13 Sat Jul 7 18:22:09 2001 +++ phpdoc/fr/functions/funchand.xml Thu Jul 12 08:13:02 2001 @@ -1,41 +1,41 @@ - - Fonctions - Fonctions - - - Ces fonctions effectuent les manipulations liées à - la gestion des fonctions. - - - - - call_user_func_array - - Appelle une fonction utilisateur avec les paramètres rassemblés en tableau - - - - Description - - - mixed - call_user_func_array - - string - function_name - - array - paramarr - - - - - call_user_func_array appelle la fonction utilisateur - function_name avec les paramètres - paramarr, rassemblés dans un tableau. - Par exemple: - - + + Fonctions + Fonctions + + + Ces fonctions effectuent les manipulations liées à + la gestion des fonctions. + + + + + call_user_func_array + + Appelle une fonction utilisateur avec les paramètres rassemblés en tableau + + + + Description + + + mixed + call_user_func_array + + string + function_name + + array + paramarr + + + + + call_user_func_array appelle la fonction utilisateur + function_name avec les paramètres + paramarr, rassemblés dans un tableau. + Par exemple: + + <?php function debug($var, $val) echo "***DEBUGGING\nVARIABLE: $var\nVALUE:"; @@ -51,107 +51,107 @@ call_user_func_array ('debug', array("c", $c)); call_user_func_array ('debug', array("HTTP_POST_VARS", $HTTP_POST_VARS)); ?> - - - + + + + + Voir aussi + call_user_func, + call_user_method et + call_user_method_array. + + - Voir aussi : - call_user_func, - call_user_method et - call_user_method_array. + call_user_func_array a été ajouté + en version PHP 4.05. - - - call_user_func_array a été ajouté - en version PHP 4.05. - - - - - - - call_user_func - - Appelle une fonction utilisateur - - - - Description - - - mixed - call_user_func - - string - function_name - - mixed - parameter - - mixed - ... - - - - - call_user_func appelle la fonction utilisateur - function_name, et lui passe les paramètres - parameter. - Par exemple : - - + + + + + + call_user_func + + Appelle une fonction utilisateur + + + + Description + + + mixed + call_user_func + + string + function_name + + mixed + parameter + + mixed + ... + + + + + call_user_func appelle la fonction utilisateur + function_name, et lui passe les paramètres + parameter. + Par exemple : + + function barbier ($type) { print "Vous vouliez une coupe $type, pas de problème"; } call_user_func ('barbier', "iroquois"); call_user_func ('barbier', "militaire"); call_user_func ('barbier', "au bol"); - - - - - Voir aussi : - call_user_func_array, - call_user_method et - call_user_method_array. - - - - - - create_function - Crée une fonction anonyme (style lambda) - - - Description - - - string create_function - string args - string code - - - - Cette fonction crée une fonction anonyme, à partir des - paramètres passés, et retourne un nom unique. - Généralement, les arguments - args sont présentés sous - la forme d'une chaîne à guillemets simples, et la - même recommandation vaut pour code. - 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. \$avar). - - - Vous pouvez utiliser cette fonction pour (par exemple) créer - une fonction à partir d'informations récoltés - durant l'éxécution. - - - Creation d'une fonction anonmye avec <function>create_function</function> - - + + + + + Voir aussi + call_user_func_array, + call_user_method et + call_user_method_array. + + + + + + create_function + Crée une fonction anonyme (style lambda) + + + Description + + + string create_function + string args + string code + + + + create_function crée une fonction anonyme, + à partir des paramètres passés, et retourne + un nom de fonction unique. Généralement, les arguments + args sont présentés sous + la forme d'une chaîne à guillemets simples, et la + même recommandation vaut pour code. + 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. \$avar). + + + Vous pouvez utiliser cette fonction pour (par exemple) créer + une fonction à partir d'informations récoltés + durant l'éxécution. + + + Création d'une fonction anonyme avec <function>create_function</function> + + <?php $newfunc = create_function('$a,$b','return "ln($a) + ln($b) = ".log($a * $b);'); echo "Nouvelle fonction anonyme : $newfunc\n"; @@ -160,22 +160,22 @@ // Nouvelle fonction anonyme : lambda_1 // ln(2) + ln(2.718281828459) = 1.6931471805599 ?> - - - Ou, pour pouvoir appliquer une fonction générique - à une liste d'arguments. - - - Traitement générique par fonction avec - <function>create_function</function> - - + + + Ou, pour pouvoir appliquer une fonction générique + à une liste d'arguments. + + + Traitement générique par fonction avec + <function>create_function</function> + + <?php function process($var1, $var2, $farr) { for ($f=0; $f < count($farr); $f++) echo $farr[$f]($var1,$var2)."\n"; } -// creation d'une série de fonction mathématiques +// création 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);"; $f3 = 'if ($a> 0 && $b != 0) {return "ln(a)/b = ".log($a)/$b;} else {return FALSE;}'; @@ -199,11 +199,11 @@ echo "\nUtilisation de la secondes liste de fonctions anonymes\n"; process("Twas brilling and the slithy toves", "Twas the night", $garr); ?> - - - Et lorsque vous utilisez le code ci dessus, l'affichage va être - - + + + Et lorsque vous utilisez le code ci-dessus, l'affichage va être + + Utilisation de la première liste de fonctions anonymes paramétres: 2.3445, M_PI Un peu de trigo: -1.6291725057799 @@ -216,10 +216,10 @@ ** Ces chaînes de ressemblent!! (regarde les trois premiers caractères) CRCs: -725381282 , 1908338681 similarité(a,b) = 11(45.833333333333%) - - - Mais l'utilisation la plus courante des fonctions lambda est la - fonction de callback, par exemple lors de l'utilisation de + + + Mais l'utilisation la plus courante des fonctions lambda est la + fonction de callback, par exemple lors de l'utilisation de array_walk ou usort Utilisation de fonctions anonymes comme fonction de callback @@ -261,39 +261,40 @@ ?> - - - - - - func_get_arg - - Retourne un élément de la liste des arguments - - - - Description - - - mixed func_get_arg - int arg_num - - - - Retourne l'argument à la position arg_num dans - la liste d'argument d'une fonction utilisateur. Les arguments sont - comptés en commencant à zéro. - func_get_arg générera une - alerte si elle est appelée hors d'une fonction. - - - Si arg_num est plus grand que le nombre - d'arguments passés, une alerte est générée - et la fonction retourne &false;. - - - - + + + + + + func_get_arg + + Retourne un élément de la liste des arguments + + + + Description + + + mixed func_get_arg + int arg_num + + + + func_get_arg retourne l'argument à + la position arg_num dans + la liste d'argument d'une fonction utilisateur. Les arguments sont + comptés en commençant à zéro. + func_get_arg générera une + alerte si elle est appelée hors d'une fonction. + + + Si arg_num est plus grand que le nombre + d'arguments passés, une alerte est générée + et la fonction retourne FALSE. + + + + <?php function foo() { $numargs = func_num_args(); @@ -304,46 +305,47 @@ } foo (1, 2, 3); ?> - - - - - func_get_arg peut être utilisé - conjointement à func_num_args et - func_get_args pour permettre aux fonctions - utilisateurs d'accepter un nombre variable d'arguments. - - - - Cette fonction a été ajoutée dans PHP 4. - - - - - - - func_get_args - - Retourne les arguments d'une fonction sous forme de tableau - - - - Description - - - array func_get_args - void - - + + + + + func_get_arg peut être utilisé + conjointement à func_num_args et + func_get_args pour permettre aux fonctions + utilisateurs d'accepter un nombre variable d'arguments. + + - Retourne un tableau dont les éléments correspondent - aux éléments de la liste d'arguments de la fonction. - func_get_args générera une - alerte si elle est appelée hors d'une fonction. + func_get_arg a été ajoutée en PHP 4. - - - + + + + + + func_get_args + + Retourne les arguments d'une fonction sous forme de tableau + + + + Description + + + array func_get_args + void + + + + func_get_args retourne un tableau dont + les éléments correspondent aux éléments + de la liste d'arguments de la fonction. + func_get_args générera une + alerte si elle est appelée hors d'une fonction. + + + + <?php function foo() { $numargs = func_num_args(); @@ -358,46 +360,48 @@ } foo (1, 2, 3); ?> - - - - - func_get_arg peut être utilisé - conjointement à func_num_args et - func_get_args pour permettre aux fonctions - utilisateurs d'accepter un nombre variable d'arguments. - - - - Cette fonction a été ajoutée dans PHP 4. - - - - - - - func_num_args - - Retourne le nombre d'arguments passé à la fonction - - - - Description - - - int func_num_args - void - - + + + + + func_get_arg peut être utilisé + conjointement à func_num_args et + func_get_args pour permettre aux fonctions + utilisateurs d'accepter un nombre variable d'arguments. + + - Retourne le nombre d'arguments passé à la fonction - utilisateur courante. func_num_args - générera une alerte si elle est appelée - hors d'une fonction. + func_get_arg a été ajoutée + en PHP 4. - - - + + + + + + func_num_args + + Retourne le nombre d'arguments passé à la fonction + + + + Description + + + int func_num_args + void + + + + func_num_args retourne le nombre d'arguments + passé à la fonction utilisateur courante. + func_num_args + générera une alerte si elle est appelée + hors d'une fonction. + + + + <?php function foo() { $numargs = func_num_args(); @@ -405,97 +409,101 @@ } foo (1, 2, 3); // affiche 'Nombre d'arguments: 3' ?> - - - + + + + + func_get_arg peut être utilisé + conjointement à func_num_args et + func_get_args pour permettre aux fonctions + utilisateurs d'accepter un nombre variable d'arguments. + + - func_get_arg peut être utilisé - conjointement à func_num_args et - func_get_args pour permettre aux fonctions - utilisateurs d'accepter un nombre variable d'arguments. + func_get_arg a été ajoutée + en PHP 4. - - - Cette fonction a été ajoutée dans PHP 4. - - - - - - - function_exists - - Retourne &true; si la fonction a déjà été - définie. - - - - Description - - - bool function_exists - string function_name - - - - Vérifie la liste des fonctions définies par - l'utilisateur, et retourne &true; si function_name - y est trouvé, &false; sinon. - - -if (function_exists('imap_open')) { + + + + + + function_exists + + Indique si une fonction est définie. + + + + Description + + + boolean function_exists + string function_name + + + + function_exists vérifie la liste des + fonctions définies par l'utilisateur, et retourne + TRUE si function_name + y est trouvé, FALSE sinon. + + +<?php + if (function_exists('imap_open')) { echo "Les fonctions IMAP sont disponibles.<br>\n"; -} else { + } else { echo "Les fonctions IMAP ne sont pas disponibles.<br>\n"; -} - - - Notez qu'une fonction peut exister, même si elle est indisponible, à - cause de la configuration ou des options de compilation. - - - Voir aussi method_exists. - - - - - - get_defined_functions - - Liste toutes les fonctions définies - - - - Description - - - array get_defined_functions - void - - - - get_defined_functions retourne un tableau multi- - dimensionnel, contenant la liste de toutes les fonctions définies, - aussi bien les fonctions internes à PHP que celle déjà définie par - l'utilisateur. Les noms des fonctions internes sont accessibles via - $arr["internal"], et les fonctions utilisateurs - sont accessibles via $arr["user"]. - - + } +?> + + + Notez qu'une fonction peut exister, même si elle est indisponible, à + cause de la configuration ou des options de compilation. + + + Voir aussi + method_exists. + + + + + + get_defined_functions + + Liste toutes les fonctions définies + + + + Description + + + array get_defined_functions + void + + + + get_defined_functions retourne un tableau multi- + dimensionnel, contenant la liste de toutes les fonctions définies, + aussi bien les fonctions internes à PHP que celle déjà + définie par l'utilisateur. Les noms des fonctions internes + sont accessibles via $arr["internal"], et les fonctions + utilisateur sont accessibles via $arr["user"]. + + <?php -function maligne($id, $data) { + function maligne($id, $data) { return "<tr><th>$id</th><td>$data</td></tr>\n"; -} -$arr = get_defined_functions(); -print_r($arr); + } + $arr = get_defined_functions(); + print_r($arr); ?> - - - - Ce script va afficher : - - + + + + Ce script va afficher : + + Array ( [internal] => Array @@ -516,46 +524,98 @@ [0] => maligne ) ) - - - - - Voir aussi get_defined_vars. - - - - - - register_shutdown_function - - Enregistre une fonction pour exécution à l'extinction - - - - Description - - - int - register_shutdown_function - - string func - - - - Enregistre la fonction func pour - exécution à l'extinction du script. - - - Erreur courante : - - - Etant donné qu'aucuna affichage n'est possible depuis cette fonction, - vous ne pouvez pas mettre d'informations de débuggage par print - ou echo ici! - - - - + + + + + Voir aussi + get_defined_vars. + + + + + + register_shutdown_function + + Enregistre une fonction pour exécution à l'extinction + + + + Description + + + int + register_shutdown_function + + string func + + + + register_shutdown_function enregistre la fonction + func pour exécution à l'extinction + du script. + + + Erreur courante : + + + Etant donné qu'aucun affichage n'est possible depuis la fonction + func, vous ne pouvez pas y mettre d'informations + de débuggage par print ou echo! + + + + + + register_tick_function + + Enregistre une fonction exécutée à chaque tick + + + + Description + + + void + register_tick_function + + string func + mixed arg + + + + register_tick_function enregistre la fonction + func pour être exécutée à chaque fois qu'un + tick est appelé. + + + + + + unregister_tick_function + + Annule la fonction exécutée à chaque tick + + + + Description + + + void + unregister_tick_function + + string func + mixed arg + + + + unregister_tick_function annule l'exécution automatique + de func à chaque + tick. + + + +