dams Wed Mar 7 10:08:43 2001 EDT Modified files: /phpdoc/fr/functions classobj.xml datetime.xml dbase.xml filesystem.xml funchand.xml info.xml sybase.xml var.xml zlib.xml array.xml Log: Adding all Jesus' updates (wahoo...) Correcting some Damien's typos. Minor esthetics
Index: phpdoc/fr/functions/classobj.xml diff -u phpdoc/fr/functions/classobj.xml:1.6 phpdoc/fr/functions/classobj.xml:1.7 --- phpdoc/fr/functions/classobj.xml:1.6 Tue Jan 16 14:42:26 2001 +++ phpdoc/fr/functions/classobj.xml Wed Mar 7 10:08:43 2001 @@ -222,7 +222,7 @@ </informalexample> </para> <simpara> - See also <function>call_user_func</function>. + Voir aussi <function>call_user_func</function>. </simpara> </refsect1> </refentry> Index: phpdoc/fr/functions/datetime.xml diff -u phpdoc/fr/functions/datetime.xml:1.14 phpdoc/fr/functions/datetime.xml:1.15 --- phpdoc/fr/functions/datetime.xml:1.14 Tue Mar 6 10:30:48 2001 +++ phpdoc/fr/functions/datetime.xml Wed Mar 7 10:08:43 2001 @@ -586,7 +586,7 @@ de l'époque UNIX, (1er janvier 1970 00:00:00 GMT), et msec qui est le nombre de microsecondes de cette heure. Cette fonction est seulement disponible sur les systèmes d'exploitation qui - supportent la fonction gettimeofday(). + supportent la fonction <function>gettimeofday</function>. </para> <para> Voir aussi <function>time</function>. Index: phpdoc/fr/functions/dbase.xml diff -u phpdoc/fr/functions/dbase.xml:1.2 phpdoc/fr/functions/dbase.xml:1.3 --- phpdoc/fr/functions/dbase.xml:1.2 Tue Jan 16 02:38:38 2001 +++ phpdoc/fr/functions/dbase.xml Wed Mar 7 10:08:43 2001 @@ -3,31 +3,36 @@ <titleabbrev>dBase</titleabbrev> <partintro> <simpara> - Ces fonctions vous permettront d'accéder aux enregistrements d'une base au format - dBase (.dbf). + Ces fonctions vous permettront d'accéder aux enregistrements d'une base au +format + dBase (.dbf). </simpara> <simpara> - dBase ne permet pas l'utilisation d'index, de "memo fields", ni le blocage - de la base. Deux processus de serveurs web différents modifiant la même fichier - dBase risque de rendre votre base de données incohérente. + dBase ne permet pas l'utilisation d'index, de "memo fields", ni le blocage + de la base. Deux processus de serveurs web différents modifiant + la même fichier dBase risque de rendre votre base de + données incohérente. </simpara> <simpara> - A la différence des bases de données SQL, la définition des bases de données - dBase, ne peut pas être changée. Une fois le fichier créé, la définition de - la base est définitive. Il n'y a pas d'index qui accélèrent les recherches ou - organisent vos données. Les fichiers dBase sont de simples fichiers séquentiels - avec des enregistrements de longueur fixe. Les enregistrements sont ajoutés à la - fin du fichier et les enregistrements supprimés sont conservés jusqu'à l'appel de - <function>dbase_pack</function>. + A la différence des bases de données SQL, la définition + des bases de données dBase, ne peut pas être changée. Une + fois le fichier créé, la définition de la base est + définitive. Il n'y a pas d'index qui accélèrent les +recherches + ou organisent vos données. Les fichiers dBase sont de simples fichiers + séquentiels avec des enregistrements de longueur fixe. Les + enregistrements sont ajoutés à la fin du fichier et les + enregistrements supprimés sont conservés jusqu'à + l'appel de <function>dbase_pack</function>. </simpara> <simpara> - Nous vous recommandons de ne pas utiliser les fichiers dBase comme base de données - de production. Choisissez n'importe quel serveur SQL à la place. MySQL et - Postgres sont des choix classiques avec PHP. Le support de dBase ne se justifie - ici que pour vous permettre d'importer et d'exporter des données de et vers votre - base des données web, maintenant que le format du fichier est communément géré par - les feuilles et organiseurs Windows. L'import et l'export de données est l'unique - chose pour laquelle l'utilisation de dBase est recommandée. + Nous vous recommandons de ne pas utiliser les fichiers dBase comme base + de données de production. Choisissez n'importe quel serveur SQL + à la place. MySQL et PostgresSQL sont des choix classiques avec + PHP. Le support de dBase ne se justifie ici que pour vous permettre + d'importer et d'exporter des données de et vers votre base des + données web, maintenant que le format du fichier est + communément géré par les feuilles et + organiseurs Windows. L'import et l'export de données est l'unique + chose pour laquelle l'utilisation de dBase est recommandée. </simpara> </partintro> <refentry id="function.dbase-create"> @@ -44,8 +49,9 @@ </funcsynopsis> <para> <parameter>fields</parameter> est un tableau de tableaux. Chaque tableau - décrit le format d'un fichier de la base. Chaque champs est constitué d'un nom, - d'un caractère de type de champs, d'une longueur et d'une précision. + décrit le format d'un fichier de la base. Chaque champs est + constitué d'un nom, d'un caractère de type de champs, + d'une longueur et d'une précision. </para> <para> Les types de champs disponibles sont : @@ -96,8 +102,9 @@ </variablelist> </para> <para> - Si la base de données a été créée, un identifiant de base dbase_identifier est - retourné, sinon, <literal>FALSE</literal> est retourné. + Si la base de données a été créée, + un identifiant de base dbase_identifier est retourné, sinon, + <literal>FALSE</literal> est retourné. <example> <title>Création d'une base dBase</title> <programlisting role="php"> @@ -140,8 +147,9 @@ 2 écriture/lecture). </para> <para> - Retourne un identifiant de base de données, ou <literal>FALSE</literal> si la base n'a pas pu être - selectionnée. + <function>dbase_open</function> retourne un identifiant de base de + données, ou <literal>FALSE</literal> si la base n'a pas pu être + selectionnée. </para> </refsect1> </refentry> @@ -157,7 +165,8 @@ <paramdef>int <parameter>dbase_identifier</parameter></paramdef> </funcsynopsis> <para> - Ferme la base associée à <parameter>dbase_identifier</parameter>. + <function>dbase_close</function> ferme la base associée à + <parameter>dbase_identifier</parameter>. </para> </refsect1> </refentry> @@ -173,7 +182,8 @@ <paramdef>int <parameter>dbase_identifier</parameter></paramdef> </funcsynopsis> <para> - Compacte la base de données spécifiée (effacement définitif de tous les + <function>dbase_pack</function> compacte la base de données + <parameter>dbase_identifier</parameter> (effacement définitif de tous les enregistrements marqués pour l'effacement, avec la fonction <function>dbase_delete_record</function>). </para> @@ -192,10 +202,11 @@ <paramdef>array <parameter>record</parameter></paramdef> </funcsynopsis> <para> - Ajoute les données de <parameter>record</parameter> dans la base spécifiée par - <parameter>dbase_identifier</parameter>. Si le nombre de colonnes fourni n'est pas - celui du nombre de champs dans la base, l'opération échouera, et <literal>FALSE</literal> sera - retourné. + <function>dbase_add_record</function> ajoute les données de + <parameter>record</parameter> dans la base spécifiée par + <parameter>dbase_identifier</parameter>. Si le nombre de colonnes fourni + n'est pas celui du nombre de champs dans la base, l'opération + échouera, et <literal>FALSE</literal> sera retourné. </para> </refsect1> </refentry> @@ -213,13 +224,14 @@ <paramdef>int <parameter>dbase_record_number</parameter></paramdef> </funcsynopsis> <simpara> - Remplace les données associées à l'enregistrement <parameter>record_number</parameter> + <function>dbase_replace_record</function> remplace les données + associées à l'enregistrement <parameter>record_number</parameter> par les données enregistrées dans <parameter>record</parameter>. Si le nombre de colonnes fourni n'est pas celui du nombre de champs dans la base, l'opération échouera, et <literal>FALSE</literal> sera retourné. </simpara> <simpara> - <parameter>dbase_record_number</parameter> est un entier qui peut aller de 1 + <parameter>dbase_record_number</parameter> est un entier qui peut aller de 1 jusqu'au nombre maximal d'enregistrement de la base (retourné par <function>dbase_numrecords</function>). </simpara> @@ -228,7 +240,7 @@ <refentry id="function.dbase-delete-record"> <refnamediv> <refname>dbase_delete_record</refname> - <refpurpose>Defface un enregistrement dans une base dBase.</refpurpose> + <refpurpose>Efface un enregistrement dans une base dBase.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -238,9 +250,10 @@ <paramdef>int <parameter>record</parameter></paramdef> </funcsynopsis> <para> - Marque l'enregistrement <parameter>record</parameter> pour l'effacement, dans la - base. Pour effacer réellement l'enregistrement, il faut utiliser aussi - <function>dbase_pack</function>. + <function>dbase_delete_record</function> marque l'enregistrement + <parameter>record</parameter> pour l'effacement, dans la base + <parameter>dbase_identifier</parameter>. Pour effacer réellement + l'enregistrement, il faut utiliser aussi <function>dbase_pack</function>. </para> </refsect1> </refentry> @@ -257,15 +270,15 @@ <paramdef>int <parameter>record</parameter></paramdef> </funcsynopsis> <para> - Retourne les données de l'enregistrement <parameter>record</parameter> - dans un tableau. Le tableau est indexé à partir de 0, et inclus - un membre nommé 'deleted' (effacé), qui sera mis à 1 - si l'enregistrement a été marqué pour l'effacement - (voir <function>dbase_delete_record</function>). + <function>dbase_get_record</function> retourne les données de + l'enregistrement <parameter>record</parameter> dans un tableau. Le tableau est + indexé à partir de 0, et inclus un membre nommé 'deleted' + (effacé), qui sera mis à 1 si l'enregistrement a été + marqué pour l'effacement (voir <function>dbase_delete_record</function>). </para> <para> - Chaque champs est converti au format approprié PHP. (Les dates sont - laissées au format chaîne). + Chaque champs est converti au format approprié PHP. (Les dates sont + laissées au format chaîne). </para> </refsect1> </refentry> @@ -286,7 +299,8 @@ <paramdef>int <parameter>record</parameter></paramdef> </funcsynopsis> <para> - Retourne les données de l'enregistrement <parameter>record</parameter> + <parameter>dbase_identifier</parameter> retourne les données + de l'enregistrement <parameter>record</parameter> dans un tableau associatif. Le tableau inclus un membre nommé 'deleted' (effacé), qui sera mis à 1 si l'enregistrement a été marqué pour l'effacement (voir @@ -312,10 +326,11 @@ <paramdef>int <parameter>dbase_identifier</parameter></paramdef> </funcsynopsis> <para> - Retourne le nombre de champs (colonnes) de la base de données spécifiée. - Les numéros de champs sont numérotés de 0 à dbase_numfields($db)-1, - tandis que les numéros d'enregistrements sont numérotés de 1 à - dbase_numrecords($db). + <function>dbase_numfields</function> retourne le nombre de champs (colonnes) + de la base de données <parameter>dbase_identifier</parameter>. + Les numéros de champs sont numérotés de 0 à + dbase_numfields($db)-1, tandis que les numéros d'enregistrements + sont numérotés de 1 à dbase_numrecords($db). <example> <title>Utiliser <function>dbase_numfields</function></title> <programlisting role="php"> @@ -345,10 +360,11 @@ <paramdef>int <parameter>dbase_identifier</parameter></paramdef> </funcsynopsis> <para> - Retourne le nombre d'enregistrements (lignes) dans la base spécifiée. - Les numéros de champs sont numérotés de 0 à dbase_numfields($db)-1, - tandis que les numéros d'enregistrements sont numérotés de 1 à - dbase_numrecords($db). + <function>dbase_numrecords</function> retourne le nombre d'enregistrements + (lignes) dans la base <parameter>dbase_identifier</parameter>. + Les numéros de champs sont numérotés de 0 à + dbase_numfields($db)-1, tandis que les numéros d'enregistrements + sont numérotés de 1 à dbase_numrecords($db). </para> </refsect1> </refentry> Index: phpdoc/fr/functions/filesystem.xml diff -u phpdoc/fr/functions/filesystem.xml:1.12 phpdoc/fr/functions/filesystem.xml:1.13 --- phpdoc/fr/functions/filesystem.xml:1.12 Mon Feb 26 03:10:50 2001 +++ phpdoc/fr/functions/filesystem.xml Wed Mar 7 10:08:43 2001 @@ -149,7 +149,7 @@ </para> <note> <simpara> - <function>chown</function> est inopérante sous Windows. + <function>chown</function> est inopérante sous Windows. </simpara> </note> </refsect1> @@ -1012,7 +1012,9 @@ n'importe quelle plateforme (Unix et Windows compris). </simpara> <simpara> - <function>flock</function> retourne <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> sinon. (le verrou n'a pas pu être obtenu). + <function>flock</function> retourne <literal>TRUE</literal> en cas + de succès, et <literal>FALSE</literal> + sinon. (le verrou n'a pas pu être obtenu). </simpara> <warning> <para> @@ -1123,17 +1125,18 @@ </itemizedlist> De plus, <parameter>mode</parameter> peut contenir la lettre 'b'. Cette option n'est utile que sur les systèmes qui font la différence entre - les fichiers binaires et les fichiers textes (en bref, c'est inutile sous Unix). + les fichiers binaires et les fichiers textes (en bref, c'est une + fonctionnalité Windows, totalement inutile sous Unix). Si il n'est pas nécessaire, il sera ignoré. </para> <para> - Vous pouvez utiliser le troisième paramètre optionnel - pour explorer le dossier <link linkend="ini.include-path">include_path</link>, - en le mettant à 1. + Vous pouvez utiliser le troisième paramètre optionnel + pour explorer le dossier <link linkend="ini.include-path">include_path</link>, + en le mettant à 1. </para> <para> <example> - <title>Exemple avec fopen()</title> + <title>Exemple avec <function>fopen</function></title> <programlisting role="php"> <?php $fp = fopen("/home/rasmus/file.txt", "r"); @@ -1150,27 +1153,27 @@ pas nécessairement accessibles au processus serveur. </simpara> <para> - Sous Windows, assurez vous de bien échapper les anti-slash - utilisés dans le chemin du fichier, ou bien utilisez des slash. - <informalexample> - <programlisting role="php"> + Sous Windows, assurez-vous de bien échapper les anti-slash + utilisés dans le chemin du fichier, ou bien utilisez des slash. + <informalexample> + <programlisting role="php"> <?php $fp = fopen("c:\\data\\info.txt", "r"); ?> - </programlisting> - </informalexample> - </para> - <simpara> - Voir aussi <function>fclose</function>, <function>fsockopen</function>, - <function>socket_set_timeout</function>, et <function>popen</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.fpassthru"> + </programlisting> + </informalexample> + </para> + <simpara> + Voir aussi <function>fclose</function>, <function>fsockopen</function>, + <function>socket_set_timeout</function>, et <function>popen</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.fpassthru"> <refnamediv> <refname>fpassthru</refname> <refpurpose> - Affiche la partie du fichier située après le pointeur du fichier. + Affiche la partie du fichier située après le pointeur du fichier. </refpurpose> </refnamediv> <refsect1> @@ -1260,7 +1263,7 @@ <programlisting role="php"> <?php // Lit un fichier, et le place dans une chaîne -$filename = "/usr/local/something.txt"; +$filename = "/usr/local/quelquechose.txt"; $fd = fopen ($filename, "r"); $contents = fread ($fd, filesize ($filename)); fclose ($fd); @@ -1268,15 +1271,35 @@ </programlisting> </informalexample> </para> - <simpara> - Voir aussi <function>fwrite</function>, <function>fopen</function>, - <function>fsockopen</function>, <function>popen</function>, - <function>fgets</function>, <function>fgetss</function>, - <function>file</function>, et <function>fpassthru</function>. - </simpara> - </refsect1> - </refentry> -<refentry id="function.fscanf"> + <note> + <para> + Sur les systèmes qui différentient les fichiers textes et binaires + (i.e. Windows) le fichier doit être ouvert avec la lettre 'b' +ajoutée au + paramètre de mode de la fonction <function>fopen</function>. + </para> + </note> + <para> + <note> + <informalexample> + <programlisting role="php"> +<?php +$filename = "c:\\fichiers\\uneimage.gif"; +$fd = fopen ($filename, "rb"); +$contents = fread ($fd, filesize ($filename)); +fclose ($fd); +?> + </programlisting> + </note> + </para> + <simpara> + Voir aussi <function>fwrite</function>, <function>fopen</function>, + <function>fsockopen</function>, <function>popen</function>, + <function>fgets</function>, <function>fgetss</function>, + <function>file</function>, et <function>fpassthru</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.fscanf"> <refnamediv> <refname>fscanf</refname> <refpurpose>Analyse un fichier en fonction d'un format</refpurpose> @@ -1697,7 +1720,7 @@ </para> <note> <simpara> - <function>is_link</function> est inopérante sous Windows. + <function>is_link</function> est inopérante sous Windows. </simpara> </note> </refsect1> @@ -1829,7 +1852,7 @@ </para> <note> <simpara> - <function>link</function> est inopérante sous Windows. + <function>link</function> est inopérante sous Windows. </simpara> </note> </refsect1> @@ -1862,7 +1885,7 @@ </para> <note> <simpara> - <function>linkinfo</function> est inopérante sous Windows. + <function>linkinfo</function> est inopérante sous Windows. </simpara> </note> </refsect1> @@ -2115,7 +2138,7 @@ </para> <note> <simpara> - <function>readlink</function> est inopérante sous Windows. + <function>readlink</function> est inopérante sous Windows. </simpara> </note> </refsect1> @@ -2355,7 +2378,7 @@ </para> <note> <simpara> - <function>symlink</function> est inopérante sous Windows. + <function>symlink</function> est inopérante sous Windows. </simpara> </note> </refsect1> @@ -2525,7 +2548,7 @@ </para> <note> <simpara> - <function>unlink</function> peut ne pas fonctionner sous Windows. + <function>unlink</function> peut ne pas fonctionner sous Windows. </simpara> </note> </refsect1> Index: phpdoc/fr/functions/funchand.xml diff -u phpdoc/fr/functions/funchand.xml:1.7 phpdoc/fr/functions/funchand.xml:1.8 --- phpdoc/fr/functions/funchand.xml:1.7 Tue Jan 23 02:51:52 2001 +++ phpdoc/fr/functions/funchand.xml Wed Mar 7 10:08:43 2001 @@ -200,7 +200,7 @@ <refnamediv> <refname>func_get_arg</refname> <refpurpose> - Retourne un élément de la liste des arguments + Retourne un élément de la liste des arguments </refpurpose> </refnamediv> <refsect1> @@ -387,6 +387,72 @@ </para> <para> Voir aussi <function>method_exists</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.get-defined-functions"> + <refnamediv> + <refname>get_defined_functions</refname> + <refpurpose> + Liste toutes les fonctions définies + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>get_defined_functions</function></funcdef> + <paramdef>void <parameter></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>get_defined_functions</function> 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 + <varname>$arr["internal"]</varname>, et les fonctions utilisateurs + sont accessibles via <varname>$arr["user"]</varname>. + <informalexample> + <programlisting role="php"> +<?php +function maligne($id, $data) { + return +"<tr><th>$id</th><td>$data</td></tr>\n"; +} +$arr = get_defined_functions(); +print_r($arr); +?> + </programlisting> + </informalexample> + </para> + <para> + Ce script va afficher : + <informalexample> + <programlisting> +Array +( + [internal] => Array + ( + [0] => zend_version + [1] => func_num_args + [2] => func_get_arg + [3] => func_get_args + [4] => strlen + [5] => strcmp + [6] => strncmp + ... + [750] => bcscale + [751] => bccomp + ) + [user] => Array + ( + [0] => maligne + ) +) + </programlisting> + </informalexample> + </para> + <para> + Voir aussi <function>get_defined_vars</function>. </para> </refsect1> </refentry> Index: phpdoc/fr/functions/info.xml diff -u phpdoc/fr/functions/info.xml:1.10 phpdoc/fr/functions/info.xml:1.11 --- phpdoc/fr/functions/info.xml:1.10 Sat Feb 3 16:33:28 2001 +++ phpdoc/fr/functions/info.xml Wed Mar 7 10:08:43 2001 @@ -183,7 +183,8 @@ <paramdef>string <parameter>varname</parameter></paramdef> </funcsynopsis> <para> - Retourne la valeur de la variable d'environnement <parameter>varname</parameter>, + <function>getenv</function> retourne la valeur de la variable + d'environnement <parameter>varname</parameter>, ou <literal>FALSE</literal> en cas d'erreur. <informalexample> <programlisting role="php"> @@ -206,9 +207,7 @@ <refentry id="function.get-cfg-var"> <refnamediv> <refname>get_cfg_var</refname> - <refpurpose> - Retourne la valeur d'une option de PHP - </refpurpose> + <refpurpose>Retourne la valeur d'une option de PHP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -217,8 +216,9 @@ <paramdef>string <parameter>varname</parameter></paramdef> </funcsynopsis> <simpara> - Retourne la valeur courante de l'option PHP <parameter>varname</parameter>, - ou bien <literal>FALSE</literal> en cas d'erreur. + <function>get_cfg_var</function> retourne la valeur courante de + l'option PHP <parameter>varname</parameter>, ou bien + <literal>FALSE</literal> en cas d'erreur. </simpara> <simpara> <function>get_cfg_var</function> ne retourne pas les options qui @@ -247,7 +247,8 @@ <paramdef>void</paramdef> </funcsynopsis> <simpara> - Retourne le nom du possesseur du script courant. + <function>get_current_user</function> retourne le nom du possesseur + du script courant. </simpara> <simpara> Voir aussi <function>getmyuid</function>, <function>getmypid</function>, @@ -269,9 +270,9 @@ <paramdef>void</paramdef> </funcsynopsis> <simpara> - Retourne le configuration actuelle de l'option - <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> - (0 pour l'option désactivée, 1 pour l'option activée). + <function>get_magic_quotes_gpc</function> retourne le configuration actuelle + de l'option <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> + (0 pour l'option désactivée, 1 pour l'option activée). </simpara> <simpara> Voir aussi <function>get_magic_quotes_runtime</function>, @@ -295,7 +296,8 @@ <paramdef>void</paramdef> </funcsynopsis> <simpara> - RRetourne la configuration actuelle de l'option + <function>get_magic_quotes_runtime</function> retourne la configuration + actuelle de l'option <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>. (0 pour option desactivée, 1 pour option sactivée). </simpara> @@ -309,7 +311,7 @@ <refnamediv> <refname>getlastmod</refname> <refpurpose> - Retourne la date de dernière modification de la page. + Retourne la date de dernière modification de la page. </refpurpose> </refnamediv> <refsect1> @@ -319,11 +321,12 @@ <paramdef>void</paramdef> </funcsynopsis> <para> - <function>getlastmod</function> retourne la date de dernière - modification de la page. La valeur retournée est - un marqueur de temps UNIX, utilisable comme paramètre avec - la fonction <function>date</function>. - Retourne <literal>FALSE</literal> en cas d'erreur. + <function>getlastmod</function> retourne la date de dernière + modification de la page. La valeur retournée est + un marqueur de temps UNIX, utilisable comme paramètre avec + la fonction <function>date</function>. + <function>getlastmod</function> retourne <literal>FALSE</literal> en + cas d'erreur. <example> <title>Exemple avec <function>getlastmod</function></title> <programlisting role="php"> @@ -353,7 +356,8 @@ <paramdef>void</paramdef> </funcsynopsis> <para> - Retourne l'inode du script, ou <literal>FALSE</literal> en cas d'erreur. + <function>getmyinode</function> retourne l'inode du script, + ou <literal>FALSE</literal> en cas d'erreur. </para> <para> Voir aussi <function>getmyuid</function>, @@ -363,7 +367,7 @@ </para> <note> <simpara> - Cette fonction est inopérante sur les systèmes Windows. + <function>getmyinode</function> est inopérante sur les systèmes +Windows. </simpara> </note> </refsect1> @@ -380,12 +384,13 @@ <paramdef>void</paramdef> </funcsynopsis> <para> - Retourne le numéro de processus actuel ou <literal>FALSE</literal> en cas d'erreur. + <function>getmypid</function> retourne le numéro de processus + actuel ou <literal>FALSE</literal> en cas d'erreur. </para> <para> - Il est à noter que si vous utilisez PHP comme module Apache, - il n'est pas guarantit que deux invocations distinctes de la fonction - donnent des résultats différents. + Il est à noter que si vous utilisez PHP comme module Apache, + il n'est pas guarantit que deux invocations distinctes de la fonction + donnent des résultats différents. </para> <warning> <para> @@ -413,7 +418,8 @@ <paramdef>void</paramdef> </funcsynopsis> <simpara> - Retourne l'UID du propriétaire du script actuel ou <literal>FALSE</literal> en cas d'erreur. + <function>getmyuid</function> retourne l'UID du propriétaire + du script actuel ou <literal>FALSE</literal> en cas d'erreur. </simpara> <simpara> Voir aussi <function>getmypid</function>, <function>get_current_user</function>, @@ -475,19 +481,21 @@ </funcprototype> </funcsynopsis> <para> - Change la valeur de l'option de configuration <parameter>varname</parameter> + <function>ini_alter</function> change la valeur de l'option de + configuration <parameter>varname</parameter> et lui donne la valeur de <parameter>newvalue</parameter>. - Retourne <literal>FALSE</literal> en cas d'échec, et la valeur - précédente en cas de succès. + <function>ini_alter</function> retourne <literal>FALSE</literal> + en cas d'échec, et la valeur précédente en + cas de succès. </para> <note> <para> - Cette fonction est un alias de <function>ini_set</function> + <function>ini_alter</function> est un alias de <function>ini_set</function> </para> </note> <para> Voir aussi <function>ini_get</function>, - <function>ini_restore</function>, + <function>ini_restore</function> et <function>ini_set</function> </para> </refsect1> @@ -506,12 +514,13 @@ </funcprototype> </funcsynopsis> <para> - Retourne la valeur de l'option de configuration <parameter>varname</parameter> - en cas de succès, et <literal>FALSE</literal>. + <function>ini_get</function> retourne la valeur de l'option de + configuration <parameter>varname</parameter> en cas de succès, et + <literal>FALSE</literal>. </para> <para> Voir aussi <function>ini_alter</function>, - <function>ini_restore</function>, + <function>ini_restore</function> et <function>ini_set</function> </para> </refsect1> @@ -530,8 +539,8 @@ </funcprototype> </funcsynopsis> <para> - Restaure la valeur originale de l'option de configuration - <parameter>varname</parameter>. + <function>ini_restore</function> restaure la valeur originale de + l'option de configuration <parameter>varname</parameter>. </para> <para> Voir aussi <function>ini_alter</function>, @@ -555,9 +564,11 @@ </funcprototype> </funcsynopsis> <para> - Change la valeur de l'option de configuration <parameter>varname</parameter> + <function>ini_set</function> change la valeur de l'option de + configuration <parameter>varname</parameter> et lui donne la valeur de <parameter>newvalue</parameter>. - Retourne <literal>FALSE</literal> en cas d'échec, et la valeur + <function>ini_set</function> retourne <literal>FALSE</literal> + en cas d'échec, et la valeur précédente en cas de succès. </para> <para> @@ -1061,7 +1072,7 @@ </para> </refsect1> </refentry> -<refentry id="function.get-required-files"> + <refentry id="function.get-required-files"> <refnamediv> <refname>get_required_files</refname> <refpurpose> @@ -1182,6 +1193,42 @@ </para> </refsect1> </refentry> + <refentry id="function.zend-version"> + <refnamediv> + <refname>zend_version</refname> + <refpurpose>Lit la version courante du moteur Zend.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>zendversion</function></funcdef> + <paramdef>void<parameter></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>zendversion</function> retourne une chaîne contenant le + numéro de version du moteur d'analyse Zend, pour l'exécutable + PHP courant. + <example> + <title>Exemple <function>zendversion</function></title> + <programlisting role="php"> +<?php +// affiche e.g. 'Version du moteur Zend: 1.0.4' +// ou bien quelquechose d'approchant si votre version de PHP date +echo "Version du moteur Zend: ".zend_version(); +?> + </programlisting> + </example> + </para> + <para> + Voir aussi <function>phpinfo</function>, + <function>phpcredits</function>, + <function>php_logo_guid</function> et + <function>phpversion</function>. + </para> + </refsect1> + </refentry> </reference> <!-- Keep this comment at the end of the file Local variables: Index: phpdoc/fr/functions/sybase.xml diff -u phpdoc/fr/functions/sybase.xml:1.6 phpdoc/fr/functions/sybase.xml:1.7 --- phpdoc/fr/functions/sybase.xml:1.6 Mon Jan 22 03:58:33 2001 +++ phpdoc/fr/functions/sybase.xml Wed Mar 7 10:08:43 2001 @@ -58,25 +58,26 @@ </funcprototype> </funcsynopsis> <para> - <function>sybase_close</function> retourne <literal>TRUE</literal> en cas de succès, - et <literal>FALSE</literal> en cas d'erreur. + <function>sybase_close</function> retourne <literal>TRUE</literal> + en cas de succès et <literal>FALSE</literal> en cas d'erreur. </para> <para> - <function>sybase_close</function> termine la connexion avec le serveur Sybase - associé à l'identifiant de connexion - <parameter>link_identifier</parameter>. + <function>sybase_close</function> termine la connexion avec le serveur Sybase + associé à l'identifiant de connexion + <parameter>link_identifier</parameter>. </para> <para> - Notez qu'il n'est pas utile de fermer les connexions non persistantes, - car elles seront terminées à la fin du script. + Notez qu'il n'est pas utile de fermer les connexions non persistantes, + car elles seront terminées à la fin du script. </para> <para> - <function>sybase_close</function> ne ferme pas les connexions persistantes - générées par <function>sybase_pconnect</function>. + <function>sybase_close</function> ne ferme pas les connexions persistantes + générées par <function>sybase_pconnect</function>. </para> <para> - Voir aussi : <function>sybase_connect</function> et - <function>sybase_pconnect</function>. + Voir aussi + <function>sybase_connect</function> et + <function>sybase_pconnect</function>. </para> </refsect1> </refentry> @@ -356,10 +357,12 @@ </funcprototype> </funcsynopsis> <para> - <function>sybase_free_result</function> n'est vraiment utile que si vous - risquez d'utiliser trop de mémoire durant votre script. La mémoire occupée par - les résultats est automatiquement libérée à la fin du script. Mais, si vous êtes - sûr de ne pas avoir besoin du résultat ultérieurement. + <function>sybase_free_result</function> n'est vraiment utile que si vous + risquez d'utiliser trop de mémoire durant votre script. La + mémoire occupée par les résultats est + automatiquement libérée à la fin du script. Mais, + si vous êtes sûr de ne pas avoir besoin du résultat + ultérieurement. </para> </refsect1> </refentry> @@ -419,8 +422,8 @@ </funcprototype> </funcsynopsis> <para> - <function>sybase_min_client_severity</function> fixe la sévérité minimale - du client. + <function>sybase_min_client_severity</function> fixe la +sévérité + minimale du client. <note> <para> Cette fonction est disponible avec l'interface CT vers Sybase, mais pas avec la @@ -429,14 +432,16 @@ </note> </para> <para> - See also: <function>sybase_min_server_severity</function>. + Voir aussi : <function>sybase_min_server_severity</function>. </para> </refsect1> </refentry> <refentry id="function.sybase-min-error-severity"> <refnamediv> <refname>sybase_min_error_severity</refname> - <refpurpose>Fixe la sévérité minimale du client pour les erreurs</refpurpose> + <refpurpose> + Fixe la sévérité minimale du client pour les erreurs + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -447,8 +452,8 @@ </funcprototype> </funcsynopsis> <para> - <function>sybase_min_error_severity</function> fixe la sévérité minimale - du client pour les erreurs. + <function>sybase_min_error_severity</function> fixe la +sévérité + minimale du client pour les erreurs. </para> <para> Voir aussi: <function>sybase_min_message_severity</function>. @@ -458,7 +463,9 @@ <refentry id="function.sybase-min-message-severity"> <refnamediv> <refname>sybase_min_message_severity</refname> - <refpurpose>Fixe la sévérité minimale du client pour les messages</refpurpose> + <refpurpose> + Fixe la sévérité minimale du client pour les messages + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -469,8 +476,8 @@ </funcprototype> </funcsynopsis> <para> - <function>sybase_min_message_severity</function> fixe la sévérité minimale - du client pour les messages. + <function>sybase_min_message_severity</function> fixe la + sévérité minimale du client pour les messages. </para> <para> Voir aussi: <function>sybase_min_error_severity</function>. @@ -480,7 +487,9 @@ <refentry id="function.sybase-min-server-severity"> <refnamediv> <refname>sybase_min_server_severity</refname> - <refpurpose>Fixe la sévérité minimale du client pour le serveur</refpurpose> + <refpurpose> + Fixe la sévérité minimale du client pour le serveur + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -491,8 +500,8 @@ </funcprototype> </funcsynopsis> <para> - <function>sybase_min_server_severity</function> fixe la sévérité minimale - du client pour le serveur. + <function>sybase_min_server_severity</function> fixe la +sévérité + minimale du client pour le serveur. <note> <para> Cette fonction est disponible avec l'interface CT vers Sybase, mais pas avec la @@ -572,23 +581,25 @@ <literal>FALSE</literal> en cas d'erreur. </para> <para> - <function>sybase_connect</function> se comporte comme - <function>sybase_connect</function> avec deux différence majeures : + <function>sybase_connect</function> se comporte comme + <function>sybase_connect</function> avec deux différence majeures : </para> <para> - Premièrement, lors de la connexion, la fonction va chercher une connexion - (persistante) déjà ouverte, avec le même hôte, nom de compte et mot de passe. Si - une telle connexion est trouvée, un identifiant de cette connexion est retourné, - plutôt que d'en ouvrir une nouvelle. + Premièrement, lors de la connexion, la fonction va chercher une connexion + (persistante) déjà ouverte, avec le même hôte, + nom de compte et mot de passe. Si une telle connexion est trouvée, + un identifiant de cette connexion est retourné, plutôt que + d'en ouvrir une nouvelle. </para> <para> - Deuxièmement, la connexion au serveur SyBase ne sera pas terminée lors de la - fin du script. Au contraire, le lien sera maintenu pour des connexions - ultérieures. <function>sybase_close</function> ne fermera pas un lien crée par - <function>sybase_pconnect</function>). + Deuxièmement, la connexion au serveur SyBase ne sera pas + terminée lors de la fin du script. Au contraire, le lien + sera maintenu pour des connexions ultérieures. + <function>sybase_close</function> ne fermera pas un lien crée par + <function>sybase_pconnect</function>. </para> <para> - Ce type de liens est dit 'persistent'. + Ce type de liens est dit 'persistent'. </para> </refsect1> </refentry> @@ -607,18 +618,21 @@ </funcprototype> </funcsynopsis> <para> - Retourne un identifiant de résultat positif en cas de succès, et <literal>FALSE</literal> sinon. + <function>sybase_query</function> retourne un identifiant de résultat + positif en cas de succès, et <literal>FALSE</literal> sinon. </para> <para> - <function>sybase_query</function> envoie une requête à la base de données - courante, sur le serveur associé à l'identifiant de connexion. Si l'identifiant - de connexion n'est pas précisé, la fonction essaiera d'utiliser la dernière - connexion ouverte. Si aucune connexion n'a été ouverte, la fonction va tenter - d'ouvrir une connexion avec la fonction <function>sybase_connect</function>. + <function>sybase_query</function> envoie une requête à + la base de données courante, sur le serveur associé à + l'identifiant de connexion. Si l'identifiant de connexion n'est pas + précisé, la fonction essaiera d'utiliser la dernière + connexion ouverte. Si aucune connexion n'a été ouverte, + la fonction va tenter d'ouvrir une connexion avec la fonction + <function>sybase_connect</function>. </para> <para> - Voir aussi: - <function>sybase_select_db</function> et <function>sybase_connect</function>. + Voir aussi: <function>sybase_select_db</function> et + <function>sybase_connect</function>. </para> </refsect1> </refentry> @@ -638,19 +652,20 @@ </funcprototype> </funcsynopsis> <para> - <function>sybase_result</function> retourne le contenu d'une cellule. L'argument - <parameter>field</parameter> peut être l'index du champs, ou bien le nom du - champs, ou encore, le nom de la table " point " le nom du champs. Si la colonne - a été aliasée ('SELECT foo AS bar FROM...'), utilisez l'alias à la place du nom - de la colonne. + <function>sybase_result</function> retourne le contenu d'une cellule. L'argument + <parameter>field</parameter> peut être l'index du champs, ou bien le nom du + champs, ou encore, le nom de la table " point " le nom du champs. Si la colonne + a été aliasée ('SELECT foo AS bar FROM...'), utilisez + l'alias à la place du nom de la colonne. </para> <para> - Lorsque vous travaillez sur des résultats de grande taille, vous devriez - utiliser les autres fonctions qui lisent une ligne entière (voir plus loin). - Etant donné que ces fonctions lisent une ligne entière, elles sont BEAUCOUP plus - rapide que <function>sybase_result</function>. De plus, l'utilisation d'index - numérique est beaucoup plus rapide que les noms des champs, ou les noms des tables - et des champs. + Lorsque vous travaillez sur des résultats de grande taille, vous devriez + utiliser les autres fonctions qui lisent une ligne entière + (voir plus loin). Etant donné que ces fonctions lisent une + ligne entière, elles sont BEAUCOUP plus rapide que + <function>sybase_result</function>. De plus, l'utilisation d'index + numérique est beaucoup plus rapide que les noms des champs, + ou les noms des tables et des champs. </para> <para> Fonctions de substitution, à haute efficacité : @@ -674,22 +689,25 @@ </funcprototype> </funcsynopsis> <para> - Retourne <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> en cas d'erreur. + <function>sybase_select_db</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> en cas d'erreur. </para> <para> - <function>sybase_select_db</function> change la base de données courante et - active sur le serveur associé avec l'identifiant de connexion - <parameter>link_identifier</parameter>. Si <parameter>link_identifier</parameter> - n'est pas précisé, le dernier lien ouvert est utilisé. Si aucun lien n'a été - ouvert, la fonction va tenter d'en établir un en appelant - <function>sybase_connect</function>. + <function>sybase_select_db</function> change la base de données courante +et + active sur le serveur associé avec l'identifiant de connexion + <parameter>link_identifier</parameter>. Si <parameter>link_identifier</parameter> + n'est pas précisé, le dernier lien ouvert est utilisé. Si + aucun lien n'a été ouvert, la fonction va tenter d'en +établir + un en appelant <function>sybase_connect</function>. </para> <para> - Tous les prochains appels à <function>sybase_query</function> seront faites - sur la bas de données courante et active. + Tous les prochains appels à <function>sybase_query</function> seront +faites + sur la bas de données courante et active. </para> - <para> Voir aussi : <function>sybase_connect</function>, <function>sybase_pconnect</function> - et <function>sybase_query</function>. + <para> + Voir aussi : <function>sybase_connect</function>, + <function>sybase_pconnect</function> et + <function>sybase_query</function>. </para> </refsect1> </refentry> Index: phpdoc/fr/functions/var.xml diff -u phpdoc/fr/functions/var.xml:1.10 phpdoc/fr/functions/var.xml:1.11 --- phpdoc/fr/functions/var.xml:1.10 Sat Feb 3 16:33:28 2001 +++ phpdoc/fr/functions/var.xml Wed Mar 7 10:08:43 2001 @@ -5,7 +5,7 @@ <refnamediv> <refname>doubleval</refname> <refpurpose> - Retourne la valeur numérique (double) de la variable. + Retourne la valeur numérique (double) de la variable. </refpurpose> </refnamediv> <refsect1> @@ -92,7 +92,8 @@ <paramdef>mixed <parameter>var</parameter></paramdef> </funcsynopsis> <para> - Retourne le type de la variable PHP <parameter>var</parameter>. + <function>gettype</function> retourne le type de la + variable PHP <parameter>var</parameter>. </para> <para> Les chaînes de caractères que peut retourner la fonction @@ -132,11 +133,94 @@ </para> </refsect1> </refentry> + <refentry id="function.get-defined-vars"> + <refnamediv> + <refname>get_defined_vars</refname> + <refpurpose> + Liste toutes les variables définies + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>get_defined_vars</function></funcdef> + <paramdef>void <parameter></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>get_defined_vars</function> retourne un tableau multidimensionnel + contenant la liste de toutes les variables définies, qu'elles soient + des variables d'environnement, de serveurs ou définies par l'utilisateur. + <informalexample> + <programlisting role="php"> +<?php +$b = array(1,1,2,3,5,8); +$arr = get_defined_vars(); +// affiche $b +print_r($arr["b"]); +// affiche le chemin jusqu'à l'interpréteur CGI PHP (si PHP est +utilisé en CGI) +// i.e. /usr/local/bin/php +echo $arr["_"]; +// affiche la ligne de commande, s'il y en a une +print_r($arr["argv"]); +// affiche toutes les variables serveurs +print_r($arr["HTTP_SERVER_VARS"]); +// affiche toutes les clés disponibles dans les tableaux de variables +print_r(array_keys(get_defined_vars())); +?> + </programlisting> + </informalexample> + </para> + <para> + Voir aussi <function>get_defined_functions</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.get-resource-type"> + <refnamediv> + <refname>get_resource_type</refname> + <refpurpose>Retourne le type de ressource</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>get_resource_type</function></funcdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>get_resource_type</function> retourne une chaîne +représentant + le type de ressources de <parameter>handle</parameter>. Si le paramètre + n'est pas une ressource valide, une erreur est générée. + <informalexample> + <programlisting role="php"> +<?php +$c = mysql_connect(); +echo get_resource_type($c)."\n"; +// affiche : mysql link +// (lien mysql) +$fp = fopen("foo","w"); +echo get_resource_type($fp)."\n"; +// affiche : file +// (fichier) +$doc = new_xmldoc("1.0"); +echo get_resource_type($doc->doc)."\n"; +// affiche : domxml document +// (document domxml) +?> + </programlisting> + </informalexample> + </para> + </refsect1> + </refentry> <refentry id="function.intval"> <refnamediv> <refname>intval</refname> <refpurpose> - Retourne la valeur numérique (integer) de la variable.</refpurpose> + Retourne la valeur numérique (integer) de la variable. + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -150,9 +234,10 @@ </funcprototype> </funcsynopsis> <simpara> - Retourne la valeur numérique (integer) de la variable - <parameter>var</parameter>, en convertisant la valeur dans la - base spécifiée (par défaut en base 10). + <function>intval</function> retourne la valeur numérique + entière (integer) de la variable <parameter>var</parameter>, en + convertisant la valeur dans la base spécifiée (par + défaut en base 10). </simpara> <simpara> <parameter>var</parameter> peut être de type scalaire. Vous ne @@ -180,7 +265,8 @@ </funcprototype> </funcsynopsis> <para> - Renvoie la valeur <literal>TRUE</literal> si la variable <parameter>var</parameter> est un tableau, + <function>is_array</function> renvoie la valeur <literal>TRUE</literal> + si la variable <parameter>var</parameter> est un tableau, <literal>FALSE</literal> sinon. </para> <para> @@ -245,8 +331,9 @@ </funcprototype> </funcsynopsis> <para> - Renvoie <literal>TRUE</literal> si la variable <parameter>var</parameter> est du type "double", - <literal>FALSE</literal> sinon. + <function>is_double</function> renvoie <literal>TRUE</literal> si + la variable <parameter>var</parameter> est du type "double", + <literal>FALSE</literal> sinon. </para> <para> Voir aussi <function>is_array</function>, @@ -363,8 +450,9 @@ </funcprototype> </funcsynopsis> <para> - Renvoie <literal>TRUE</literal> si la variable <parameter>var</parameter> est du type - integer (long), <literal>FALSE</literal> sinon. + <function>is_long</function> renvoie <literal>TRUE</literal> + si la variable <parameter>var</parameter> est du type + entier long (long), <literal>FALSE</literal> sinon. </para> <para> Voir aussi <function>is_bool</function>, @@ -426,7 +514,8 @@ </funcprototype> </funcsynopsis> <para> - Renvoie <literal>TRUE</literal> si la variable <parameter>var</parameter> est un objet, + <function>is_object</function> renvoie <literal>TRUE</literal> + si la variable <parameter>var</parameter> est un objet, <literal>FALSE</literal> sinon. </para> <para> @@ -516,8 +605,9 @@ </funcprototype> </funcsynopsis> <para> - Renvoie <literal>TRUE</literal> si la variable <parameter>var</parameter> est du type "string", - <literal>FALSE</literal> sinon. + <function>is_string</function> renvoie <literal>TRUE</literal> + si la variable <parameter>var</parameter> est du type chaine + de caractères (string), <literal>FALSE</literal> sinon. </para> <para> Voir aussi <function>is_long</function>, @@ -544,8 +634,9 @@ </funcprototype> </funcsynopsis> <simpara> - Renvoie <literal>TRUE</literal> si la variable <parameter>var</parameter> est définie, - <literal>FALSE</literal> sinon. + <function>isset</function> renvoie <literal>TRUE</literal> + si la variable <parameter>var</parameter> est définie, + <literal>FALSE</literal> sinon. </simpara> <para> Si une variable a été désaffectée avec la fonction @@ -678,12 +769,12 @@ </funcprototype> </funcsynopsis> <para> - <function>settype</function> modifie le type de la variable - <parameter>var</parameter> en <parameter>type</parameter>. + <function>settype</function> modifie le type de la variable + <parameter>var</parameter> en <parameter>type</parameter>. </para> <para> - Les valeurs possibles pour le paramètre - <parameter>type</parameter> sont : + Les valeurs possibles pour le paramètre + <parameter>type</parameter> sont : <itemizedlist> <listitem><simpara>"integer"</simpara></listitem> <listitem><simpara>"double"</simpara></listitem> @@ -693,7 +784,8 @@ </itemizedlist> </para> <para> - Renvoie <literal>TRUE</literal> en cas de succès, <literal>FALSE</literal> sinon. + <function>settype</function> renvoie <literal>TRUE</literal> + en cas de succès, <literal>FALSE</literal> sinon. </para> <para> Voir aussi <function>gettype</function>. @@ -714,13 +806,13 @@ </funcprototype> </funcsynopsis> <simpara> - Retourne la valeur de la variable <parameter>var</parameter>, - au format chaîne de caractères. + <function>strval</function> retourne la valeur de la variable + <parameter>var</parameter>, au format chaîne de caractères. </simpara> <simpara> - <parameter>var</parameter> peut être un scalaire. Vous ne pouvez - pas utiliser la fonction <function>strval</function> avec des tableaux - ou des objets. + <parameter>var</parameter> peut être un scalaire. Vous ne pouvez + pas utiliser la fonction <function>strval</function> avec des tableaux + ou des objets. </simpara> <simpara> Voir aussi <function>doubleval</function>, <function>intval</function>, Index: phpdoc/fr/functions/zlib.xml diff -u phpdoc/fr/functions/zlib.xml:1.6 phpdoc/fr/functions/zlib.xml:1.7 --- phpdoc/fr/functions/zlib.xml:1.6 Fri Jan 26 06:43:31 2001 +++ phpdoc/fr/functions/zlib.xml Wed Mar 7 10:08:43 2001 @@ -90,7 +90,8 @@ <paramdef>int <parameter>zp</parameter></paramdef> </funcsynopsis> <para> - Retourne <literal>TRUE</literal> si le pointeur interne du fichier compressé est à + <function>gzeof</function> retourne <literal>TRUE</literal> si le pointeur + interne du fichier compressé est à la fin du fichier, sinon retourne <literal>FALSE</literal>. </para> <para> @@ -551,7 +552,7 @@ <refentry id="function.gzcompress"> <refnamediv> <refname>gzcompress</refname> - <refpurpose>Compresse une chaˆne avec Gz</refpurpose> + <refpurpose>Compresse une chaˆne (ZLIB)</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -565,15 +566,24 @@ </funcprototype> </funcsynopsis> <para> - <function>gzcompress</function> retourne la version compressé GZ de - la chaîne <parameter>data</parameter>, ou <literal>FALSE</literal> - en cas d'erreur. Le paramètre <parameter>level</parameter> peut - prendre des valeurs depuis 0 (pas de compression) jusqu'à 9 - (compression maximum). + <function>gzcompress</function> retourne la version compressé avec + le format de données ZLIB de la chaîne <parameter>data</parameter>, + ou <literal>FALSE</literal> en cas d'erreur. Le paramètre + <parameter>level</parameter> peut prendre des valeurs depuis 0 + (pas de compression) jusqu'à 9 (compression maximum). + </para> + <para> + Pour plus de détails sur la compression ZLIB et son algorithme, + reportez vous au document de spécifications + <ulink url="&url.rfc1950;">ZLIB Compressed Data Format Specification version +3.3</ulink> + (RFC 1950). + </para> + <para> + Voir aussi <function>gzdeflate</function>, + <function>gzinflate</function>, + <function>gzuncompress</function> et + <function>gzencode</function>. </para> - <para> - Voir aussi <function>gzuncompress</function>. - </para> </refsect1> </refentry> <refentry id="function.gzuncompress"> @@ -610,10 +620,144 @@ </para> </note> <para> + Voir aussi <function>gzdeflate</function>, + <function>gzinflate</function>, + <function>gzcompress</function> et + <function>gzencode</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.gzdeflate"> + <refnamediv> + <refname>gzdeflate</refname> + <refpurpose>Compresse une chaîne (DEFLATE)</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>gzdeflate</function></funcdef> + <paramdef>string <parameter>data</parameter></paramdef> + <paramdef>int + <parameter><optional>level</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>gzdeflate</function> retourne la version compressée + de <parameter>data</parameter> en utilisant le format de données + DEFLATE, ou <literal>FALSE</literal> si une erreur est survenue. + Le paramètre optionnel <parameter>level</parameter> peut prendre des + valeurs de 0 (pas de compression) jusqu'à 9 (compression maximum, + vitesse minimum). + </para> + <para> + Pour plus de détails sur la compression ZLIB et son algorithme, + reportez vous au document de spécifications + <ulink url="&url.rfc1951;">DEFLATE Compressed Data Format Specification version +1.3</ulink> + (RFC 1951). + </para> + <para> + Voir aussi + <function>gzinflate</function>, + <function>gzcompress</function>, + <function>gzuncompress</function> et + <function>gzencode</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.gzinflate"> + <refnamediv> + <refname>gzinflate</refname> + <refpurpose>Décompresse une chaîne (INFLATE)</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>gzinflate</function></funcdef> + <paramdef>string <parameter>data</parameter></paramdef> + <paramdef>int + <parameter><optional>length</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>gzinflate</function> décompresse la chaîne + <parameter>data</parameter>. <parameter>data</parameter> + doit avoir été compressée avec +<function>gzdeflate</function>. + <function>gzinflate</function> retourne les données + originales décompressées, ou bien <literal>FALSE</literal> + si une erreur survient. <function>gzinflate</function> + retournera une erreur si les données décompressées sont plus + grandes que 256 fois la taille des données compressées + <parameter>data</parameter> ou que le paramètre + optionnel <parameter>length</parameter>. + </para> + <para> Voir aussi <function>gzcompress</function>. + <function>gzuncompress</function>, + <function>gzdeflate</function> et + <function>gzencode</function>. </para> </refsect1> </refentry> + <refentry id="function.gzencode"> + <refnamediv> + <refname>gzencode</refname> + <refpurpose>Crée une chaîne compréssée avec +gzip</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>gzencode</function></funcdef> + <paramdef>string <parameter>data</parameter></paramdef> + <paramdef>int + <parameter><optional>level</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>gzencode</function> retourne la chaîne + <parameter>data</parameter> compressée et compatible avec + le programme <command>gzip</command>, ou bien <literal>FALSE</literal> + si une erreur survient. Le paramètre optionnel + <parameter>level</parameter> peut prendre des valeurs de + 0 (par de compression) jusqu'à 9 (compression maximum, + vitess minimum). Par défaut, le niveau de compression est + 1. + </para> + <para> + La chaîne retournée contient les entêtes appropriés et +la + structure de données demandées par gzip pour faire un + fichier .gz file, e.g.: + <example> + <title>Création d'un fichier .gz (gzip)</title> + <programlisting role="php"> +<?php +$data = implode("", "bigfile.txt"); +$gzdata = gzencode($data, 9); +$fp = fopen("bigfile.txt.gz", "w"); +fwrite($fp, $gzdata); +fclose($fp); +?> + </programlisting> + </example> + </para> + <para> + Pour plus de détails sur le format GZIP, reportez vous à : + <ulink url="&url.rfc1952">GZIP file format specification version 4.3</ulink> + (RFC 1952). + </para> + <para> + Voir aussi <function>gzcompress</function>. + <function>gzuncompress</function>, + <function>gzdeflate</function> et + <function>gzinflate</function>. + </para> + </refsect1> + </refentry> </reference> <!-- Keep this comment at the end of the file Local variables: Index: phpdoc/fr/functions/array.xml diff -u phpdoc/fr/functions/array.xml:1.25 phpdoc/fr/functions/array.xml:1.26 --- phpdoc/fr/functions/array.xml:1.25 Tue Mar 6 10:30:48 2001 +++ phpdoc/fr/functions/array.xml Wed Mar 7 10:08:43 2001 @@ -1072,6 +1072,43 @@ </para> </refsect1> </refentry> + <refentry id="function.array-sum"> + <refnamediv> + <refname>array_sum</refname> + <refpurpose> + Calcule la somme des valeurs du tableau + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>array_sum</function></funcdef> + <paramdef>array <parameter>arr</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>array_sum</function> retourne la somme des + valeurs du tableau, sous forme d'un entier ou d'un + nombre à virgule flottante. + </para> + <para> + <example> + <title>Exemple avec <function>array_sum</function></title> + <programlisting role="php"> +<?php +$a = array(2,4,6,8); +echo "somme(a) = ".array_sum($a)."\n"; +// affiche : somme(a) = 20 +$b = array("a"=>1.2,"b"=>2.3,"c"=>3.4); +echo "somme(b) = ".array_sum($b)."\n"; +// affiche : somme(b) = 6.9 +?> + </programlisting> + </example> + </para> + </refsect1> + </refentry> <refentry id="function.array-unique"> <refnamediv> <refname>array_unique</refname> @@ -1910,7 +1947,7 @@ est le même que celui de la valeur trouvée dans <parameter>haystack</parameter>. </para> <para> - See also <function>in_array</function>. + Voir aussi <function>in_array</function>. </para> </refsect1> </refentry>