cvs: phpdoc /fr/functions bzip2.xml cpdf.xml dba.xml dir.xml filesystem.xml pdf.xml pgsql.xml strings.xml url.xml

From: Date: Mon, 26 Feb 2001 11:10:50 +0000
Subject: cvs: phpdoc /fr/functions bzip2.xml cpdf.xml dba.xml dir.xml filesystem.xml pdf.xml pgsql.xml strings.xml url.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969334485@lists.php.net to get a copy of this message
dams Mon Feb 26 03:10:50 2001 EDT Modified files: /phpdoc/fr/functions cpdf.xml dba.xml dir.xml filesystem.xml pdf.xml pgsql.xml strings.xml url.xml bzip2.xml Log: Corrected is_writable, Corrected some mistakes, removed all illegal chars.

Index: phpdoc/fr/functions/cpdf.xml diff -u phpdoc/fr/functions/cpdf.xml:1.7 phpdoc/fr/functions/cpdf.xml:1.8 --- phpdoc/fr/functions/cpdf.xml:1.7 Tue Feb 20 00:42:39 2001 +++ phpdoc/fr/functions/cpdf.xml Mon Feb 26 03:10:50 2001 @@ -86,9 +86,9 @@ </programlisting> </example> <simpara> - La distribution pdflib contient un exemple plus complet, qui - cr&eacute;e des s&eacute;ries de pages avec une horloge. Voici - cet exemple convertit en script PHP qui utilise l'extension ClibPDF : + La distribution pdflib contient un exemple plus complet, qui + cr&eacute;e des s&eacute;ries de pages avec une horloge. Voici + cet exemple convertit en script PHP qui utilise l'extension ClibPDF : </simpara> <example> <title>Exemple pdfclock de la distribution pdflib 2.0</title> @@ -106,7 +106,7 @@ cpdf_translate($pdf, $radius + $margin, $radius + $margin); cpdf_save($pdf); cpdf_setrgbcolor($pdf, 0.0, 0.0, 1.0); - /* minute strokes */ + /* indications des minutes */ cpdf_setlinewidth($pdf, 2.0); for ($alpha = 0; $alpha &lt; 360; $alpha += 6) { @@ -117,7 +117,7 @@ } cpdf_restore($pdf); cpdf_save($pdf); - /* 5 minute strokes */ + /* Indications des 5 minutes */ cpdf_setlinewidth($pdf, 3.0); for ($alpha = 0; $alpha &lt; 360; $alpha += 30) { @@ -127,7 +127,7 @@ cpdf_stroke($pdf); } $ltime = getdate(); - /* draw hour hand */ + /* aiguille des heures */ cpdf_save($pdf); cpdf_rotate($pdf, -(($ltime['minutes']/60.0) + $ltime['hours'] - 3.0) * 30.0); cpdf_moveto($pdf, -$radius/10, -$radius/20); @@ -136,7 +136,7 @@ cpdf_closepath($pdf); cpdf_fill($pdf); cpdf_restore($pdf); - /* draw minute hand */ + /* aiguille des minutes */ cpdf_save($pdf); cpdf_rotate($pdf, -(($ltime['seconds']/60.0) + $ltime['minutes'] - 15.0) * 6.0); cpdf_moveto($pdf, -$radius/10, -$radius/20); @@ -145,7 +145,7 @@ cpdf_closepath($pdf); cpdf_fill($pdf); cpdf_restore($pdf); - /* draw second hand */ + /* aiguille des secondes */ cpdf_setrgbcolor($pdf, 1.0, 0.0, 0.0); cpdf_setlinewidth($pdf, 2); cpdf_save($pdf); @@ -154,18 +154,18 @@ cpdf_lineto($pdf, $radius, 0.0); cpdf_stroke($pdf); cpdf_restore($pdf); - /* draw little circle at center */ + /* Un petit cercle au centre */ cpdf_circle($pdf, 0, 0, $radius/30); cpdf_fill($pdf); cpdf_restore($pdf); cpdf_finalize_page($pdf, $pagecount+1); } cpdf_finalize($pdf); -Header("Content-type: application/pdf"); +header("Content-type: application/pdf"); cpdf_output_buffer($pdf); cpdf_close($pdf); ?&gt; - </programlisting> + </programlisting> </example> </partintro> <refentry id="function.cpdf-global-set-document-limits"> @@ -189,14 +189,14 @@ </funcsynopsis> <para> <function>cpdf_global_set_document_limits</function> permet de - fixer plusieurs limites au document PDF. + fixer plusieurs limites au document PDF. <function>cpdf_global_set_document_limits</function> doit &ecirc;tre appel&eacute; avant <function>cpdf_open</function> pour &ecirc;tre effective. Elle fixe les limites de tous les documents ouverts apr&egrave;s. </para> <para> - Voir aussi <function>cpdf_open</function>. + Voir aussi <function>cpdf_open</function>. </para> </refsect1> </refentry> @@ -219,7 +219,7 @@ </para> <para> Voir aussi <function>cpdf_set_subject</function>, - <function>cpdf_set_title</function> et + <function>cpdf_set_title</function> et <function>cpdf_set_keywords</function>. </para> </refsect1> @@ -288,7 +288,7 @@ </para> <para> Voir aussi <function>cpdf_set_title</function>, - <function>cpdf_set_creator</function> et + <function>cpdf_set_creator</function> et <function>cpdf_set_subject</function>. </para> </refsect1> @@ -396,7 +396,7 @@ d&eacute;faut, cette valeur vaut 72. </para> <para> - Voir aussi <function>cpdf_set_current_page</function>. + Voir aussi <function>cpdf_set_current_page</function>. </para> </refsect1> </refentry> @@ -417,12 +417,12 @@ <para> <function>cpdf_finalize_page</function> termine la page de num&eacute;ro <parameter>page_number</parameter>. - <function>cpdf_finalize_page</function> ne fait qu'une sauvegarde + <function>cpdf_finalize_page</function> ne fait qu'une sauvegarde m&eacute;moire. Les pages termin&eacute;es prennent moins de place, mais ne peuvent plus &ecirc;tre modifi&eacute;es. </para> <para> - Voir aussi <function>cpdf_page_init</function>. + Voir aussi <function>cpdf_page_init</function>. </para> </refsect1> </refentry> @@ -444,7 +444,7 @@ appeler <function>cpdf_close</function> apr&egrave;s. </para> <para> - Voir aussi <function>cpdf_close</function>. + Voir aussi <function>cpdf_close</function>. </para> </refsect1> </refentry> @@ -469,7 +469,7 @@ appel&eacute;e dans param&egrave;tre de nom de fichier. </para> <para> - Voir aussi <function>cpdf_open</function>. + Voir aussi <function>cpdf_open</function>. </para> </refsect1> </refentry> @@ -488,15 +488,15 @@ </funcprototype> </funcsynopsis> <para> - <function>cpdf_save_to_file</function> Žcrit un document + <function>cpdf_save_to_file</function> &eacute;crit un document PDF dans un fichier, s'il a &eacute;t&eacute; cr&eacute;&eacute; - en m&eacute;moire. <function>cpdf_save_to_file</function> n'est - pas n&eacute;cessaire si un nom de fichier a &eacute;t&eacute; + en m&eacute;moire. <function>cpdf_save_to_file</function> n'est + pas n&eacute;cessaire si un nom de fichier a &eacute;t&eacute; fourni lors de l'appel &agrave; <function>cpdf_open</function>. </para> <para> - Voir aussi <function>cpdf_output_buffer</function>, - <function>cpdf_open</function>. + Voir aussi <function>cpdf_output_buffer</function> + et <function>cpdf_open</function>. </para> </refsect1> </refentry> @@ -515,13 +515,13 @@ </funcprototype> </funcsynopsis> <para> - <function>cpdf_set_current_page</function> fixe la page - courante, o&uacute; toutes les procha&icirc;nes op&eacute;rations - vont avoir lieu. On peut changer de page jusqu'&agrave; ce qu'une - page soit termin&eacute;e avec <function>cpdf_finalize_page</function>. + <function>cpdf_set_current_page</function> fixe la page + courante, o&uacute; toutes les procha&icirc;nes op&eacute;rations + vont avoir lieu. On peut changer de page jusqu'&agrave; ce qu'une + page soit termin&eacute;e avec <function>cpdf_finalize_page</function>. </para> <para> - Voir aussi <function>cpdf_finalize_page</function>. + Voir aussi <function>cpdf_finalize_page</function>. </para> </refsect1> </refentry> @@ -554,7 +554,7 @@ </example> </para> <para> - Voir aussi <function>cpdf_end_text</function>. + Voir aussi <function>cpdf_end_text</function>. </para> </refsect1> </refentry> @@ -587,7 +587,7 @@ </example> </para> <para> - Voir aussi <function>cpdf_begin_text</function>. + Voir aussi <function>cpdf_begin_text</function>. </para> </refsect1> </refentry> @@ -611,8 +611,8 @@ </para> <para> Voir aussi <function>cpdf_text</function>, - <function>cpdf_begin_text</function>, - <function>cpdf_end_text</function>. + <function>cpdf_begin_text</function> + et <function>cpdf_end_text</function>. </para> </refsect1> </refentry> @@ -649,7 +649,7 @@ </note> </para> <para> - Voir aussi <function>cpdf_text</function>. + Voir aussi <function>cpdf_text</function>. </para> </refsect1> </refentry> @@ -693,7 +693,7 @@ &agrave; la doc de ClibPDF, pour les valeurs possibles. </para> <para> - Voir aussi <function>cpdf_show_xy</function>. + Voir aussi <function>cpdf_show_xy</function>. </para> </refsect1> </refentry> @@ -752,7 +752,7 @@ affich&eacute; par <function>cpdf_continue_text</function>. </para> <para> - Voir aussi <function>cpdf_continue_text</function>. + Voir aussi <function>cpdf_continue_text</function>. </para> </refsect1> </refentry> @@ -1031,7 +1031,7 @@ </example> </para> <para> - Voir aussi <function>cpdf_save</function>. + Voir aussi <function>cpdf_save</function>. </para> </refsect1> </refentry> @@ -1314,7 +1314,7 @@ qui est utilis&eacute;e. </para> <para> - Voir aussi <function>cpdf_moveto</function>. + Voir aussi <function>cpdf_moveto</function>. </para> </refsect1> </refentry> @@ -1456,7 +1456,7 @@ qui est utilis&eacute;e. </para> <para> - Voir aussi <function>cpdf_arc</function>. + Voir aussi <function>cpdf_arc</function>. </para> </refsect1> </refentry> @@ -1494,7 +1494,7 @@ qui est utilis&eacute;e. </para> <para> - Voir aussi <function>cpdf_circle</function>. + Voir aussi <function>cpdf_circle</function>. </para> </refsect1> </refentry> @@ -1618,7 +1618,7 @@ <function>cpdf_stroke</function>, <function>cpdf_setgray_fill</function>, <function>cpdf_setgray</function>, - <function>cpdf_setrgbcolor_fill</function> et + <function>cpdf_setrgbcolor_fill</function> et <function>cpdf_setrgbcolor</function>. </para> </refsect1> @@ -1646,7 +1646,7 @@ <function>cpdf_fill</function>, <function>cpdf_setgray_fill</function>, <function>cpdf_setgray</function>, - <function>cpdf_setrgbcolor_fill</function> et + <function>cpdf_setrgbcolor_fill</function> et <function>cpdf_setrgbcolor</function>. </para> </refsect1> @@ -1674,7 +1674,7 @@ <function>cpdf_fill</function>, <function>cpdf_setgray_fill</function>, <function>cpdf_setgray</function>, - <function>cpdf_setrgbcolor_fill</function> et + <function>cpdf_setrgbcolor_fill</function> et <function>cpdf_setrgbcolor</function>. </para> </refsect1> @@ -1718,7 +1718,7 @@ couleur de remplissage courante, par <parameter>value</parameter>. </para> <para> - Voir aussi <function>cpdf_setrgbcolor_fill</function>. + Voir aussi <function>cpdf_setrgbcolor_fill</function>. </para> </refsect1> </refentry> @@ -1741,7 +1741,7 @@ couleur de dessin courante, par <parameter>value</parameter>. </para> <para> - Voir aussi <function>cpdf_setrgbcolor_stroke</function>. + Voir aussi <function>cpdf_setrgbcolor_stroke</function>. </para> </refsect1> </refentry> @@ -1988,7 +1988,7 @@ la valeur par d&eacute;faut (72) qui est utilis&eacute;e. </para> <para> - Voir aussi <function>cpdf_place_inline_image</function>. + Voir aussi <function>cpdf_place_inline_image</function>. </para> </refsect1> </refentry> @@ -2024,7 +2024,7 @@ la valeur par d&eacute;faut (72) qui est utilis&eacute;. </para> <para> - Voir aussi <function>cpdf_import_jpeg</function>. + Voir aussi <function>cpdf_import_jpeg</function>. </para> </refsect1> </refentry> Index: phpdoc/fr/functions/dba.xml diff -u phpdoc/fr/functions/dba.xml:1.5 phpdoc/fr/functions/dba.xml:1.6 --- phpdoc/fr/functions/dba.xml:1.5 Tue Jan 16 02:38:38 2001 +++ phpdoc/fr/functions/dba.xml Mon Feb 26 03:10:50 2001 @@ -10,7 +10,7 @@ donn&eacute;es sur fichiers. En tant que tel, les fonctionnalit&eacute;s sont limit&eacute;es &agrave; une partie des fonctionnalit&eacute;s des bases de donn&eacute;es modernes, comme - <ulink url="">Sleepycat Software's DB2</ulink>. (A ne pas confondre avec + <ulink url="&url.sleepycat;">Sleepycat Software's DB2</ulink>. (A ne pas confondre avec IBM's DB2 software, qui fonctionne avec <link linkend="ref.odbc">ODBC</link>.). </para> <para> @@ -30,44 +30,44 @@ compatibilit&eacute;s cod&eacute;es dans DB2 et gdbm ne sont pas support&eacute;es, car elles ne sont compatibles qu'au niveau du code source, et ne peuvent pas g&eacute;rer le format dbm originel. - (--with-dbm) + (<link linkend="install.configure.with-dbm">--with-dbm</link>). </simpara> </listitem> <listitem> <simpara> ndbm est un nouveau type de dbm plus flexible. Il a cependant la majorit&eacute; des limitations du genre. - (--with-ndbm) + (<link linkend="install.configure.with-ndbm">--with-ndbm</link>). </simpara> </listitem> <listitem> <simpara> gdbm est <ulink url="">la base dbm GNU</ulink>. - (--with-gdbm) + (<link linkend="install.configure.with-gdbm">--with-gdbm</link>). </simpara> </listitem> <listitem> <simpara> - db2 est <ulink url="">DB2 de Sleepycat Software</ulink>. Elle se + db2 est <ulink url="&url.sleepycat;">DB2 de Sleepycat Software</ulink>. Elle se d&eacute;crit comme un "ensemble d'outils qui fournissent une base de donn&eacute;es performante, tant pour les applications ind&eacute;pendantes que pour le client/serveur". - (--with-db2) + (<link linkend="install.configure.with-db2">--with-db2</link>). </simpara> </listitem> <listitem> <simpara> DB3 est le <ulink url="&url.sleepycat;">DB3 de Sleepycat Software</ulink>. - (--with-db3) + (<link linkend="install.configure.with-db3">--with-db3</link>). </simpara> </listitem> <listitem> <simpara> - cdb est "un package rapide, robuste, l&eacute;ger, pour cr&eacute;er et - lire des bases de donn&eacute;es constantes". C'est l'auteur de qmail qui - l'a &eacute;crit, et elle est disponible <ulink url="">ici</ulink>. Puisque - c'est une base constante, elle ne supporte que la lecture. - (--with-cdb) + cdb est "un package rapide, robuste, l&eacute;ger, pour cr&eacute;er et + lire des bases de donn&eacute;es constantes". C'est l'auteur de qmail qui + l'a &eacute;crit, et elle est disponible <ulink url="">ici</ulink>. Puisque + c'est une base constante, elle ne supporte que la lecture. + (<link linkend="install.configure.with-cdb">--with-cdb</link>). </simpara> </listitem> </itemizedlist> Index: phpdoc/fr/functions/dir.xml diff -u phpdoc/fr/functions/dir.xml:1.5 phpdoc/fr/functions/dir.xml:1.6 --- phpdoc/fr/functions/dir.xml:1.5 Sat Feb 17 04:55:59 2001 +++ phpdoc/fr/functions/dir.xml Mon Feb 26 03:10:50 2001 @@ -136,7 +136,7 @@ <refnamediv> <refname>opendir</refname> <refpurpose> - Ouvre un dossier, et r&eacute;cup&egrave;re un pointeur dessus. + Ouvre un dossier, et r&eacute;cup&egrave;re un pointeur dessus. </refpurpose> </refnamediv> <refsect1> @@ -152,6 +152,30 @@ pour &ecirc;tre utilis&eacute; avec les fonctions <function>closedir</function>, <function>readdir</function> et <function>rewinddir</function>. + </para> + <para> + Si le param&egrave;tre <parameter>path</parameter> n'est pas un dossier + valide, ou si le dossier ne peut &ecirc;tre acc&eacute;d&eacute; + pour des raisons de permissions ou des erreurs li&eacute;es au + syst&egrave;me de fichiers, <function>opendir</function> retourne + <literal>FALSE</literal> et g&eacute;n&egrave;re une erreur PHP. + Vous pouvez supprimer cette erreur en ajoutant + <literal>@</literal> avant le nom de la fonction. + </para> + <para> + <example> + <title>Exemple <function>opendir</function></title> + <programlisting role="php"> +&lt;?php +if ($dir = @opendir("/tmp")) { + while($file = readdir($dir)) { + echo "$file\n"; + } + closedir($dir); +} +?&gt; + </programlisting> + </example> </para> </refsect1> </refentry> Index: phpdoc/fr/functions/filesystem.xml diff -u phpdoc/fr/functions/filesystem.xml:1.11 phpdoc/fr/functions/filesystem.xml:1.12 --- phpdoc/fr/functions/filesystem.xml:1.11 Thu Feb 22 03:05:29 2001 +++ phpdoc/fr/functions/filesystem.xml Mon Feb 26 03:10:50 2001 @@ -17,14 +17,14 @@ </funcprototype> </funcsynopsis> <para> - <function>basename</function> prend en param&egrave;tre le chemin complet - d'un fichier et en extrait le nom du fichier. + <function>basename</function> prend en param&egrave;tre le chemin complet + d'un fichier et en extrait le nom du fichier. </para> <para> - Sous Windows, les caract&egrave;res (<literal>/</literal>) et antislash - (<literal>\</literal>) sont utilis&eacute;s comme s&eacute;parateur de - dossier. Sous les autres OS, seul le caract&egrave;re slash - (<literal>/</literal>) est utilis&eacute;. + Sous Windows, les caract&egrave;res (<literal>/</literal>) et antislash + (<literal>\</literal>) sont utilis&eacute;s comme s&eacute;parateur de + dossier. Sous les autres OS, seul le caract&egrave;re slash + (<literal>/</literal>) est utilis&eacute;. </para> <para> <example> @@ -690,7 +690,7 @@ du serveur. </simpara> <simpara> - Le r&eacute;sultat de <function>file_exists</function> est mis en cache. + Le r&eacute;sultat de <function>file_exists</function> est mis en cache. Reportez-vous &agrave; <function>clearstatcache</function> pour plus de d&eacute;tails. </simpara> @@ -860,7 +860,7 @@ </funcsynopsis> <para> <function>fileowner</function> renvoie le nom du possesseur du fichier - <parameter>filename</parameter>, ou <literal>FALSE</literal> en cas d'erreur. + <parameter>filename</parameter>, ou <literal>FALSE</literal> en cas d'erreur. L'identification du possesseur de fichier est num&eacute;rique : il faut utiliser <function>posix_getpwuid</function> pour retrouver le nom d'utilisateur. </para> @@ -1431,8 +1431,8 @@ type les autres syst&egrave;mes (i.e. Windows) retourne -1. </para> <para> - Les r&eacute;sultats de <function>fstat</function> sont mis en cache . - Reportez-vous &agrave; la fonction <function>clearstatcache</function> + Les r&eacute;sultats de <function>fstat</function> sont mis en cache . + Reportez-vous &agrave; la fonction <function>clearstatcache</function> pour plus de d&eacute;tails. </para> </refsect1> @@ -1485,8 +1485,8 @@ <para> <function>ftruncate</function> prend le pointeur de fichier <parameter>fp</parameter> et le tronque &agrave; la taille de - <parameter>size</parameter>. La fonction retourne - <literal>TRUE</literal> en cas de succ&egrave;s, et + <parameter>size</parameter>. La fonction retourne + <literal>TRUE</literal> en cas de succ&egrave;s, et <literal>FALSE</literal> sinon. </para> </refsect1> @@ -1564,7 +1564,7 @@ </simpara> <para> L'exemple suivant montre comment utiliser la fonction - <function>set_file_buffer</function> pour cr&eacute;er un fichier + <function>set_file_buffer</function> pour cr&eacute;er un fichier sans buffer. <example> <title>Exemple avec <function>set_file_buffer</function></title> @@ -1599,7 +1599,7 @@ </funcprototype> </funcsynopsis> <para> - <function>is_dir</function> retourne <literal>TRUE</literal> si + <function>is_dir</function> retourne <literal>TRUE</literal> si <parameter>filename</parameter> existe et est un dossier. </para> <para> @@ -1737,7 +1737,7 @@ <refentry id="function.is-writable"> <refnamediv> <refname>is_writable</refname> - <refpurpose>Indique un fichier est autoris&eacute; en lecture.</refpurpose> + <refpurpose>Indique un fichier est autoris&eacute; en &eacute;criture.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1749,7 +1749,7 @@ </funcsynopsis> <para> <function>is_writable</function> retourne <literal>TRUE</literal> si - <parameter>filename</parameter> existe et est accessible en lecture. + <parameter>filename</parameter> existe et est accessible en &eacute;criture. </para> <para> N'oubliez pas que PHP acc&egrave;de aux fichiers avec les m&ecirc;mes Index: phpdoc/fr/functions/pdf.xml diff -u phpdoc/fr/functions/pdf.xml:1.10 phpdoc/fr/functions/pdf.xml:1.11 --- phpdoc/fr/functions/pdf.xml:1.10 Sun Feb 25 06:11:06 2001 +++ phpdoc/fr/functions/pdf.xml Mon Feb 26 03:10:50 2001 @@ -228,10 +228,10 @@ vous devez utiliser PDFlib 3.0 ou plus r&eacute;cent. </simpara> <simpara> - PHP 3, d'un autre cot&eacute;, ne doit pas &ecirc;tre utilis&eacute; - avec une version plus r&eacute;cente que la 2.01. Depuis la + PHP 3, d'un autre cot&eacute;, ne doit pas &ecirc;tre utilis&eacute; + avec une version plus r&eacute;cente que la 2.01. Depuis la version 1.61 du source <filename>php3/functions/pdf.c</filename> - (php 3.19), il est possible d'utiliser la version PDFlib 3.0 ou + (php 3.19), il est possible d'utiliser la version PDFlib 3.0 ou plus r&eacute;cent. </simpara> </sect1> @@ -239,7 +239,7 @@ <title>Installation des anciennes versions de PDFLib</title> <simpara> Si vous utilisez PDFLib 2.01 v&eacute;rifiez comment votre librairie a - &eacute;t&eacute; install&eacute;e. Il doit y avoir un fichier (ou + &eacute;t&eacute; install&eacute;e. Il doit y avoir un fichier (ou un lien) vers <filename>libpdf.so</filename>. La version 2.01 ne fait que cr&eacute;er une librairie avec le nom <filename>libpdf2.01.so</filename> qui ne peut &ecirc;tre trouv&eacute; lors de la compilation du @@ -938,7 +938,7 @@ (<parameter>x2</parameter>, <parameter>y2</parameter>). </para> <para> - Voir aussi <function>pdf_moveto</function>, + Voir aussi <function>pdf_moveto</function>, <function>pdf_lineto</function> et <function>pdf_stroke</function>. </para> @@ -1080,7 +1080,7 @@ </funcprototype> </funcsynopsis> <para> - <function>pdf_findfont</function> pr&eacute;pare une police pour + <function>pdf_findfont</function> pr&eacute;pare une police pour utilisation ult&eacute;rieure avec <function>pdf_setfont</function>. Les dimensions seront charg&eacute;es, et lorsque c'est possible, le fichier de police sera v&eacute;rifi&eacute;, mais pas utilis&eacute;. @@ -1486,9 +1486,7 @@ </para> </refsect1> </refentry> - <!-- function pdf-open-png alreadydefined - <refentry id="function.pdf-open-png"> <refnamediv> <refname>pdf_open_png</refname> @@ -1504,9 +1502,7 @@ </para> </refsect1> </refentry> - --> - <refentry id="function.pdf-open-tiff"> <refnamediv> <refname>pdf_open_tiff</refname> @@ -2059,9 +2055,9 @@ </funcsynopsis> <para> <function>pdf_set_border_dash</function> modifie la longueur - des pointill&eacute;s (si le style de bord d'une annotation est en - pointill&eacute;s). <parameter>black</parameter> repr&eacute;sente - la taille des traits noirs, et <parameter>white</parameter> celle + des pointill&eacute;s (si le style de bord d'une annotation est en + pointill&eacute;s). <parameter>black</parameter> repr&eacute;sente + la taille des traits noirs, et <parameter>white</parameter> celle des espaces blancs. </para> <para> @@ -2192,7 +2188,7 @@ </note> <note> <simpara> - Si vous r&eacute;f&eacute;rencez une police dans un fichier + Si vous r&eacute;f&eacute;rencez une police dans un fichier <filename>.upr</filename>, assurez-vous que le nom du fichier <filename>.afm</filename> et celui de la police sont bien les m&ecirc;mes. Sinon, la police sera aggrandie plusieur fois (Merci &agrave; @@ -2267,7 +2263,7 @@ <note> <simpara> <function>pdf_set_info</function> remplace pdf_set_info_keywords(), - pdf_set_info_title(), pdf_set_info_subject(), pdf_set_info_creator() et + pdf_set_info_title(), pdf_set_info_subject(), pdf_set_info_creator() et pdf_set_info_subject(). </simpara> </note> @@ -2490,7 +2486,7 @@ </para> <para> <function>pdf_show_boxed</function> retourne le nombre de caract&egrave;res - qui n'ont pas pu &ecirc;tre trait&eacute;s, car ils ne rentraient pas + qui n'ont pas pu &ecirc;tre trait&eacute;s, car ils ne rentraient pas dans le rectangle. </para> <para> @@ -2566,7 +2562,7 @@ </funcsynopsis> <para> <function>pdf_stringwidth</function> retourne la largeur du texte - <parameter>text</parameter> avec la police courante. Il faut qu'une + <parameter>text</parameter> avec la police courante. Il faut qu'une police ait &eacute;t&eacute; choisie auparavant. </para> <para> @@ -2672,7 +2668,7 @@ </example> </para> <para> - Voir aussi <function>pdf_close_image</function>, + Voir aussi <function>pdf_close_image</function>, <function>pdf_open_jpeg</function>, <function>pdf_open_gif</function>, <function>pdf_execute_image</function>, Index: phpdoc/fr/functions/pgsql.xml diff -u phpdoc/fr/functions/pgsql.xml:1.9 phpdoc/fr/functions/pgsql.xml:1.10 --- phpdoc/fr/functions/pgsql.xml:1.9 Fri Jan 26 06:44:21 2001 +++ phpdoc/fr/functions/pgsql.xml Mon Feb 26 03:10:50 2001 @@ -3,26 +3,26 @@ <titleabbrev>PostgreSQL</titleabbrev> <partintro> <para> - Postgres, initialement d&eacute;velopp&eacute; au d&eacute;partement de - Science informatique, &agrave; UC Berkeley, mis en place la majorit&eacute; - des concepts des bases relationnelles, actuellement disponibles sur le - march&eacute;. PostgreSQL accepte le langage SQL92/SQL3, assure - l'int&eacute;grit&eacute; transactionnelle, et l'extension de type. - PostgreSQL est une &eacute;volution du code originale de Berkeley : - il est Open Source et dans le domaine public. + Postgres, initialement d&eacute;velopp&eacute; au d&eacute;partement de + Science informatique, &agrave; UC Berkeley, mis en place la majorit&eacute; + des concepts des bases relationnelles, actuellement disponibles sur le + march&eacute;. PostgreSQL accepte le langage SQL92/SQL3, assure + l'int&eacute;grit&eacute; transactionnelle, et l'extension de type. + PostgreSQL est une &eacute;volution du code originale de Berkeley : + il est Open Source et dans le domaine public. </para> <para> - PostgreSQL est disponible sans frais. La version actuelle est disponible &agrave; - (en anglais) : <ulink url="&url.pgsql;">www.PostgreSQL.org</ulink>. + PostgreSQL est disponible sans frais. La version actuelle est disponible &agrave; + (en anglais) : <ulink url="&url.pgsql;">www.PostgreSQL.org</ulink>. </para> <para> - Depuis la version 6.3 (03/02/1998) PostgreSQL utilise les sockets UNIX, et - une table est d&eacute;di&eacute;e &agrave; ces nouvelles capacit&eacute;s. - La socket est situ&eacute;e dans le dossier - <filename>/tmp/.s.PGSQL.5432</filename>. Cette option peut &ecirc;tre - activ&eacute;e avec '-i' pass&eacute; au <command>postmaster</command> - et cela s'interpr&egrave;te: "&eacute;coute sur les sockets TCP/IP et sur - les sockets Unix". + Depuis la version 6.3 (03/02/1998) PostgreSQL utilise les sockets UNIX, et + une table est d&eacute;di&eacute;e &agrave; ces nouvelles capacit&eacute;s. + La socket est situ&eacute;e dans le dossier + <filename>/tmp/.s.PGSQL.5432</filename>. Cette option peut &ecirc;tre + activ&eacute;e avec '-i' pass&eacute; au <command>postmaster</command> + et cela s'interpr&egrave;te: "&eacute;coute sur les sockets TCP/IP et sur + les sockets Unix". <table> <title>Postmaster et PHP</title> <tgroup cols="3"> @@ -64,9 +64,9 @@ </table> </para> <para> - Il est possible de se connecter avec la commande suivante : - <command>$conn = pg_Connect("host=monHote port=monPort tty=monTTY - options=mesOptions user=monUser password=monPassword dbname=maDB"); + Il est possible de se connecter avec la commande suivante : + <command>$conn = pg_Connect("host=monHote port=monPort tty=monTTY + options=myOptions dbname=myDB user=myUser password=myPassword"); </command> </para> <para> @@ -114,9 +114,10 @@ </funcprototype> </funcsynopsis> <para> - Retourne <literal>FALSE</literal> si l'index de connexion n'est pas valable, et <literal>TRUE</literal> sinon. - Ferme la connexion au serveur PostgreSQL associ&eacute; &agrave; - <parameter>connection</parameter>. + <function>pg_close</function> retourne <literal>FALSE</literal> si + l'index de connexion n'est pas valable, et <literal>TRUE</literal> sinon. + <function>pg_close</function> ferme la connexion au serveur PostgreSQL + associ&eacute; &agrave; <parameter>connection</parameter>. </para> <note> <para> @@ -187,8 +188,9 @@ //connexion &agrave; une base de donn&eacute;es nomm&eacute;e "marie" $dbconn2 = pg_connect("host=localhost port=5432 dbname=marie"); //connexion &agrave; une base de donn&eacute;es nomm&eacute;e "marie" sur l'h&ocirc;te "localhost" sur le port "5432" -$dbconn3 = pg_connect("user=agneau password=baaaa dbname=marie "); -//connexion &agrave; une base de donn&eacute;es nomm&eacute;e "marie" avec l'utilisateur "agneau" et le mot de passe "baaaa" +$dbconn3 = pg_Connect ("host=sheep port=5432 dbname=marie user=mouton password=baaaa"); +//connection &agrave; une base de donn&eacute;es nomm&eacute;e "marie" sur le serveur "mouton" avec +// un nom d'utilisateur et le mot de passe associ&eacute; ?&gt; </programlisting> </example> @@ -226,9 +228,9 @@ </funcprototype> </funcsynopsis> <para> - Retourne le nom de la base de donn&eacute;e PostgreSQL associ&eacute;e - &agrave; l'index de connexion connection, ou <literal>FALSE</literal> si connection n'est - pas valide. + <function>pg_dbname</function> retourne le nom de la base de donn&eacute;es + PostgreSQL associ&eacute;e &agrave; l'index de connexion connection, ou + <literal>FALSE</literal> si connection n'est pas valide. </para> </refsect1> </refentry> @@ -251,8 +253,8 @@ <function>pg_end_copy</function> synchronise le client PostgreSQL (ici PHP) avec le serveur, apr&egrave;s une op&eacute;ration de copie. Il faut utiliser cette fonction, sous peine de recevoir une erreur "out of sync" - (d&eacute;synchronis&eacute;). Retourne <literal>TRUE</literal> en cas de succ&egrave;s, et - <literal>FALSE</literal> sinon. + (d&eacute;synchronis&eacute;). Retourne <literal>TRUE</literal> + en cas de succ&egrave;s, et <literal>FALSE</literal> sinon. </para> <para> Pour plus de d&eacute;tails et un exemple voyez : @@ -274,12 +276,14 @@ </funcprototype> </funcsynopsis> <para> - Retourne une cha&icirc;ne contenant le dernier message d'erreur, ou <literal>FALSE</literal> en cas d'&eacute;chec. Il sera impossible d'obtenir des d&eacute;tails sur - l'erreur g&eacute;n&eacute;r&eacute;e, en utilisant la fonction - <function>pg_errormessage</function> si une erreur est survenue dans - la derni&egrave;re action pour laquelle une connexion valide existe. - Cette fonction retournera une cha&icirc;ne contenant le message - d'erreur g&eacute;n&eacute;r&eacute; par le serveur final. + <function>pg_errormessage</function> retourne une cha&icirc;ne contenant + le dernier message d'erreur, ou <literal>FALSE</literal> + en cas d'&eacute;chec. Il sera impossible d'obtenir des d&eacute;tails sur + l'erreur g&eacute;n&eacute;r&eacute;e, en utilisant la fonction + <function>pg_errormessage</function> si une erreur est survenue dans + la derni&egrave;re action pour laquelle une connexion valide existe. + <function>pg_errormessage</function> retournera une cha&icirc;ne contenant + le message d'erreur g&eacute;n&eacute;r&eacute; par le serveur final. </para> </refsect1> </refentry> @@ -298,23 +302,24 @@ </funcprototype> </funcsynopsis> <para> - Retourne un index de r&eacute;sultat, si la requ&ecirc;te a &eacute;t&eacute; - correctement ex&eacute;cut&eacute;e, et <literal>FALSE</literal> en cas d'&eacute;chec, ou si - la connexion connection n'&eacute;tait pas un index de connexion valide. En - cas d'erreur, le message d'erreur peut &ecirc;tre obtenu gr&acirc;ce &agrave; la - fonction <function>pg_errormessage</function>, si l'index de connexion - &eacute;tait valide. Envoie une requ&ecirc;te &agrave; un serveur - PostgreSQL identifi&eacute; gr&acirc;ce &agrave; l'index de connexion. La - r&eacute;ponse retourn&eacute;e par cette fonction est un index de - r&eacute;sultat qui devra &ecirc;tre utilis&eacute; pour acc&eacute;der - aux lignes de r&eacute;sultat, gr&acirc;ce &agrave; d'autres - fonctions PostgreSQL. + <function>pg_exec</function> retourne un index de r&eacute;sultat, + si la requ&ecirc;te a &eacute;t&eacute; correctement ex&eacute;cut&eacute;e, + et <literal>FALSE</literal> en cas d'&eacute;chec, ou si + la connexion connection n'&eacute;tait pas un index de connexion valide. En + cas d'erreur, le message d'erreur peut &ecirc;tre obtenu gr&acirc;ce &agrave; la + fonction <function>pg_errormessage</function>, si l'index de connexion + &eacute;tait valide. Envoie une requ&ecirc;te &agrave; un serveur + PostgreSQL identifi&eacute; gr&acirc;ce &agrave; l'index de connexion. La + r&eacute;ponse retourn&eacute;e par cette fonction est un index de + r&eacute;sultat qui devra &ecirc;tre utilis&eacute; pour acc&eacute;der + aux lignes de r&eacute;sultat, gr&acirc;ce &agrave; d'autres + fonctions PostgreSQL. <note> <simpara> - PHP/FI retournait 1 lorsque la requ&ecirc;te n'attendait pas de - donn&eacute;es en r&eacute;ponse (insertion, modifcations, par exemple), - et retournait un nombre plus grand que 1, m&ecirc;me sur un select qui - donnait un ensemble vide. Ce n'est plus le cas. + PHP/FI retournait 1 lorsque la requ&ecirc;te n'attendait pas de + donn&eacute;es en r&eacute;ponse (insertion, modifcations, par exemple), + et retournait un nombre plus grand que 1, m&ecirc;me sur un select qui + donnait un ensemble vide. Ce n'est plus le cas. </simpara> </note> </para> @@ -338,21 +343,22 @@ </funcprototype> </funcsynopsis> <para> - Retourne un tableau qui contient &agrave; la ligne demand&eacute;e, dans - le r&eacute;sultat identifi&eacute;e par result, et <literal>FALSE</literal> , si il ne - reste plus de lignes. - </para> - <para> - <function>pg_fetch_array</function> est une version &eacute;volu&eacute;e de - <function>pg_fetch_row</function>. En plus de proposer un tableau &agrave; - indice num&eacute;rique, elle peut aussi enregistrer les donn&eacute;es - dans un tableau associatif, en utilisant les noms des champs comme - cl&eacute;s. - </para> - <para> - L'argument optionnel <parameter>result_type</parameter> de - <function>pg_fetch_array</function> est une constante, qui peut prendre les - valeurs suivantes : PGSQL_ASSOC, PGSQL_NUM, et PGSQL_BOTH. + <function>pg_fetch_array</function> retourne un tableau qui contient + &agrave; la ligne demand&eacute;e, dans le r&eacute;sultat identifi&eacute;e + par <parameter>result</parameter>, et <literal>FALSE</literal> , s'il ne + reste plus de lignes. + </para> + <para> + <function>pg_fetch_array</function> est une version &eacute;volu&eacute;e de + <function>pg_fetch_row</function>. En plus de proposer un tableau &agrave; + indice num&eacute;rique, elle peut aussi enregistrer les donn&eacute;es + dans un tableau associatif, en utilisant les noms des champs comme + cl&eacute;s. + </para> + <para> + L'argument optionnel <parameter>result_type</parameter> de + <function>pg_fetch_array</function> est une constante, qui peut prendre les + valeurs suivantes : PGSQL_ASSOC, PGSQL_NUM, et PGSQL_BOTH. <note> <para> <parameter>result_type</parameter> a &eacute;t&eacute; ajout&eacute;e en @@ -361,13 +367,13 @@ </note> </para> <para> - Il est important de noter que <function>pg_fetch_array</function> n'est pas - significativement plus lent que <function>pg_fetch_row</function>, tandis - qu'elle fournit un confort d'utilisation notable. + Il est important de noter que <function>pg_fetch_array</function> n'est pas + significativement plus lent que <function>pg_fetch_row</function>, tandis + qu'elle fournit un confort d'utilisation notable. </para> <para> - Pour plus de d&eacute;tails, reportez vous &agrave; - <function>pg_fetch_row</function>. + Pour plus de d&eacute;tails, reportez vous &agrave; + <function>pg_fetch_row</function>. </para> <example> <title>PostgreSQL fetch array</title> @@ -410,8 +416,9 @@ </funcprototype> </funcsynopsis> <para> - Retourne un objet dont les membres sont les champs de la ligne demand&eacute;e, - ou <literal>FALSE</literal> , si il n'y a plus de lignes. + <function>pg_fetch_object</function> retourne un objet dont les + membres sont les champs de la ligne demand&eacute;e, ou + <literal>FALSE</literal> , si il n'y a plus de lignes. </para> <para> <function>pg_fetch_object</function> est similaire &agrave; @@ -433,9 +440,9 @@ </note> </para> <para> - Au niveau vitesse, cette fonction est aussi rapide que - <function>pg_fetch_row</function> et presque aussi rapide que - <function>pg_fetch_row</function> (la diff&eacute;rence est non significative). + Au niveau vitesse, <function>pg_fetch_object</function> est aussi rapide que + <function>pg_fetch_row</function> et presque aussi rapide que + <function>pg_fetch_row</function> (la diff&eacute;rence est non significative). </para> <para> Voir aussi: <function>pg_fetch_array</function> et @@ -448,19 +455,19 @@ $db_conn = pg_connect("host=localhost port=5432 dbname=$database"); if (!$db_conn): ?&gt; - &lt;H1&gt;Connexion impossible &agrave; la base postgres &lt;?php echo $database &gt;&lt;/H1> &lt;?php + &lt;H1&gt;Connexion impossible &agrave; la base postgres &lt;?php echo $database &gt;&lt;/H1&gt; &lt;?php exit; endif; $qu = pg_exec($db_conn, "SELECT * FROM verlag ORDER BY autor"); $row = 0; // postgres r&eacute;clame un compteur de ligne, d'autres bases ne le font pas. while ($data = pg_fetch_object($qu, $row)): - echo $data->autor." ("; - echo $data->jahr ."): "; - echo $data->titel."&lt;BR&gt;"; + echo $data-&gt;autor." ("; + echo $data-&gt;jahr ."): "; + echo $data-&gt;titel."&lt;BR&gt;"; $row++; endwhile; ?&gt; -&lt;PRE>&lt;?php +&lt;PRE&gt;&lt;?php $fields[] = array("autor", "Author"); $fields[] = array("jahr", " Year"); $fields[] = array("titel", " Title"); @@ -469,13 +476,13 @@ echo "----------\n"; reset($fields); while (list(,$item) = each($fields)): - echo $item[1].": ".$data->$item[0]."\n"; + echo $item[1].": ".$data-&gt;$item[0]."\n"; endwhile; $row++; endwhile; echo "----------\n"; ?&gt; -&lt;/PRE> +&lt;/PRE&gt; &lt;?php pg_freeresult($qu); pg_close($db_conn); @@ -500,8 +507,9 @@ </funcprototype> </funcsynopsis> <para> - Retourne un tableau qui contient les donn&eacute;es de la ligne demand&eacute;e, - ou <literal>FALSE</literal> , si il ne reste plus de lignes. + <function>pg_fetch_row</function> retourne un tableau qui contient + les donn&eacute;es de la ligne demand&eacute;e, ou + <literal>FALSE</literal> , si il ne reste plus de lignes. </para> <para> <function>pg_fetch_row</function> lit une ligne dans le r&eacute;sultat @@ -510,9 +518,9 @@ sous la forme d'un tableau, qui commence &agrave; l'index 0. </para> <para> - Les appels ult&eacute;rieurs &agrave; <function>pg_fetch_row</function> - retourneront la ligne d'apr&egrave;s, ou bien <literal>FALSE</literal>, lorsqu'il n'y aura - plus de lignes. + Les appels ult&eacute;rieurs &agrave; <function>pg_fetch_row</function> + retourneront la ligne d'apr&egrave;s, ou bien <literal>FALSE</literal>, + lorsqu'il n'y aura plus de lignes. </para> <para> Voir aussi: <function>pg_fetch_array</function>, @@ -561,10 +569,11 @@ </funcprototype> </funcsynopsis> <para> - Teste si un champs est &agrave; NULL. Retourne 0 si le champs n'est pas NULL. - Retourne 1 si le champs est &agrave; NULL. Le champs peut &ecirc;tre - identifi&eacute; avec son nom ou son index num&eacute;rique - (commencant &agrave; 0). + <function>pg_fieldisnull</function> teste si un champs est &agrave; + NULL. <function>pg_fieldisnull</function> retourne 0 si le champs n'est + pas NULL. <function>pg_fieldisnull</function> retourne 1 si le champs est + &agrave; NULL. Le champs peut &ecirc;tre identifi&eacute; avec son nom ou + son index num&eacute;rique (commencant &agrave; 0). </para> </refsect1> </refentry> @@ -584,9 +593,9 @@ </funcsynopsis> <para> <function>pg_fieldname</function> va retourne le nom du champs qui occupe la - colonne num&eacute;ro <parameter>field_number</parameter> dans le - r&eacute;sultat <parameter>result_id</parameter>. La num&eacute;rotation - des champs commence &agrave; 0. + colonne num&eacute;ro <parameter>field_number</parameter> dans le + r&eacute;sultat <parameter>result_id</parameter>. La num&eacute;rotation + des champs commence &agrave; 0. </para> </refsect1> </refentry> @@ -819,9 +828,9 @@ <parameter>oid</parameter> est un identifiant d'objet de grande taille qui sera export&eacute; dans le fichier <parameter>filename</parameter>, qui sp&eacute;cifie son chemin. RetourneFALSEsi une erreur survient, - et <literal>TRUE</literal> en cas de succ&egrave;s. N'oubliez pas que la manipulation d'un - objet de grande taille dans PostgreSQL doit intervenir dans une - transaction. + et <literal>TRUE</literal> en cas de succ&egrave;s. + N'oubliez pas que la manipulation d'un objet de grande taille + dans PostgreSQL doit intervenir dans une transaction. </para> </refsect1> </refentry> @@ -1043,14 +1052,15 @@ </funcprototype> </funcsynopsis> <para> - Retourne un index de connexion en cas de succ&egrave;s, ou - FALSEen cas d'erreur. Ouvre une connexion permanente &agrave; + <function>pg_pconnect</function> retourne un index de connexion + en cas de succ&egrave;s, ou <literal>FALSE</literal> en cas d'erreur. + <function>pg_pconnect</function> ouvre une connexion permanente &agrave; une base PostgreSQL. Les arguments doivent &ecirc;tre ins&eacute;r&eacute;s dans une cha&icirc;ne &agrave; guillemets. Ils incluent : - <parameter>dbname</parameter> - <parameter>port</parameter>, <parameter>host</parameter>, - <parameter>tty</parameter>, <parameter>options</parameter>, - <parameter>user</parameter>, et <parameter>password</parameter> + <parameter>host</parameter>, + <parameter>port</parameter>, <parameter>tty</parameter>, + <parameter>options</parameter>, <parameter>dbname</parameter>, + <parameter>user</parameter> et <parameter>password</parameter>. </para> <para> <function>pg_pconnect</function> retourne un indentifiant de @@ -1104,8 +1114,8 @@ par NULL) au serveur PostgreSQL. Ceci est pratique pour effectuer des insertions tr&egrave;s rapides dans une table, initi&eacute;e par une op&eacute;ration de copie PostgreSQL copy-operation. Le caract&egrave;re final - NULL est automatiquement ajout&eacute;. Retourne <literal>TRUE</literal> en cas de succ&egrave;s, - et <literal>FALSE</literal>. + NULL est automatiquement ajout&eacute;. Retourne <literal>TRUE</literal> + en cas de succ&egrave;s, et <literal>FALSE</literal>. </para> <note> <para> @@ -1272,10 +1282,10 @@ </funcprototype> </funcsynopsis> <para> - Active le suivi des communication entre PHP et le serveur PostgreSQL. - Cet historique sera enregistr&eacute; dans un fichier. Pour comprendre ces - lignes, il faut &ecirc;tre familier avec le protocole de communication - interne &agrave; PostgreSQL. Pour ceux qui le ne sont pas, + <function>pg_trace</function> active le suivi des communications entre PHP et + le serveur PostgreSQL. Cet historique sera enregistr&eacute; dans un fichier. + Pour comprendre ces lignes, il faut &ecirc;tre familier avec le protocole + de communication interne &agrave; PostgreSQL. Pour ceux qui le ne sont pas, elles peuvent &ecirc;tre utiles pour suivre les requ&ecirc;tes et les erreurs : avec la commande <command>grep '^To backend' trace.log</command>, vous pourrez voir les requ&ecirc;tes r&eacute;ellement envoy&eacute;es au serveur PostgreSQL. @@ -1308,8 +1318,8 @@ <paramdef>int <parameter>connection_id</parameter></paramdef> </funcsynopsis> <para> - <function>pg_tty</function>retourne le nom de tty de la connexion associ&eacute;e &agrave; - <parameter>connection_id</parameter>. + <function>pg_tty</function> retourne le nom de tty de la connexion + associ&eacute;e &agrave; <parameter>connection_id</parameter>. </para> </refsect1> </refentry> @@ -1329,13 +1339,13 @@ </funcprototype> </funcsynopsis> <para> - Termine le suivi d'une connexion PostgreSQL, initi&eacute;e avec - <function>pg_trace</function>. <parameter>connection</parameter> - indique la connexion &agrave; suivre. Par d&eacute;faut, c'est la - derni&egrave;re ouverte. + <function>pg_untrace</function> termine le suivi d'une connexion + PostgreSQL, initi&eacute;e avec <function>pg_trace</function>. + <parameter>connection</parameter> indique la connexion &agrave; + suivre. Par d&eacute;faut, c'est la derni&egrave;re ouverte. </para> <para> - Retourne toujours <literal>TRUE</literal>. + <function>pg_untrace</function> retourne toujours <literal>TRUE</literal>. </para> <para> Voir aussi <function>pg_trace</function>. Index: phpdoc/fr/functions/strings.xml diff -u phpdoc/fr/functions/strings.xml:1.29 phpdoc/fr/functions/strings.xml:1.30 --- phpdoc/fr/functions/strings.xml:1.29 Fri Feb 23 02:29:22 2001 +++ phpdoc/fr/functions/strings.xml Mon Feb 26 03:10:50 2001 @@ -3,12 +3,12 @@ <titleabbrev>Cha&icirc;nes</titleabbrev> <partintro> <simpara> - Ces fonctions permettent la manipulations de cha&icirc;nes de - caract&egrave;res. Certaines sections plus sp&eacute;cialis&eacute;es - sont disponibles d&egrave;s les sections sur les expressions - r&eacute;guli&egrave;res et dans la section URL. + Ces fonctions permettent la manipulations de cha&icirc;nes de + caract&egrave;res. Certaines sections plus sp&eacute;cialis&eacute;es + sont disponibles d&egrave;s les sections sur les expressions + r&eacute;guli&egrave;res et dans la section URL. </simpara> - <para> + <para> Pour plus de d&eacute;tails sur le comportement des cha&icirc;nes de caract&egrave;res, notamment concerenant les guillemets simples ou doubles, et les s&eacute;quences d'&eacute;chappement, reportez vous &agrave; @@ -2591,18 +2591,18 @@ </funcprototype> </funcsynopsis> <para> - <function>strrchr</function> retourne la partie de la cha&icirc;ne - <parameter>haystack</parameter> qui commence &agrave; la derni&egrave;re - occurence de <parameter>needle</parameter> et va jusqu'&agrave; la fin de - la cha&icirc;ne <parameter>haystack</parameter>. + <function>strrchr</function> retourne la partie de la cha&icirc;ne + <parameter>haystack</parameter> qui commence &agrave; la derni&egrave;re + occurence de <parameter>needle</parameter> et va jusqu'&agrave; la fin de + la cha&icirc;ne <parameter>haystack</parameter>. </para> <para> - <function>strrchr</function> retourne <literal>FALSE</literal> - si <parameter>needle</parameter> n'est pas trouv&eacute;. + <function>strrchr</function> retourne <literal>FALSE</literal> + si <parameter>needle</parameter> n'est pas trouv&eacute;. </para> <para> - Si <parameter>needle</parameter> contient plus d'un caract&egrave;re, - les autres sont ignor&eacute;s. + Si <parameter>needle</parameter> contient plus d'un caract&egrave;re, + les autres sont ignor&eacute;s. </para> <para> Si <parameter>needle</parameter> n'est pas une cha&icirc;ne, il est converti en @@ -2643,7 +2643,8 @@ <para> <function>str_repeat</function> retourne <parameter>input_str</parameter> r&eacute;p&eacute;t&eacute;es <parameter>multiplier</parameter> - fois. <parameter>multiplier</parameter> doit &ecirc;tre sup&eacute;rieur &agrave; 0. + fois. <parameter>multiplier</parameter> doit &ecirc;tre + sup&eacute;rieur &agrave; 0. </para> <example> <title>Exemple avec <function>str_repeat</function></title> @@ -2654,7 +2655,7 @@ </programlisting> </example> <para> - Cet exemple affichera "-=-=-=-=-=-=-=-=-=-=". + Cet exemple affichera "<literal>-=-=-=-=-=-=-=-=-=-=</literal>". </para> <note> <para> @@ -2804,7 +2805,8 @@ occurrence de <parameter>needle</parameter>, jusqu'&agrave; la fin. </para> <para> - Si <parameter>needle</parameter> n'est pas trouv&eacute;, retourne <literal>FALSE</literal>. + Si <parameter>needle</parameter> n'est pas trouv&eacute;, retourne + <literal>FALSE</literal>. </para> <para> <note> @@ -2850,10 +2852,10 @@ </funcprototype> </funcsynopsis> <para> - <function>strtok</function> est utilis&eacute;e pour morceller une cha&icirc;ne. - Pour cela, si vous avez une cha&icirc;ne du type "ceci est une cha&icirc;ne - exemple", vous pouvez la morceller en mots, en utilisant ' ' comme - d&eacute;limiteur. + <function>strtok</function> est utilis&eacute;e pour morceller une + cha&icirc;ne. Pour cela, si vous avez une cha&icirc;ne du type "ceci + est une cha&icirc;ne exemple", vous pouvez la morceller en mots, en + utilisant ' ' comme d&eacute;limiteur. <example> <title>Exemple avec <function>strtok</function></title> <programlisting role="php"> @@ -2915,7 +2917,8 @@ &lt;?php $str = "Marie A Un Petit Agneau, Et Elle L'Adore"; $str = strtolower($str); -print $str; # Affiche : marie a un petit agneau, et elle l'adore +print $str; +# Affiche : marie a un petit agneau, et elle l'adore ?&gt; </programlisting> </example> @@ -3158,17 +3161,19 @@ </informalexample> </para> <para> - Si <parameter>length</parameter> est donn&eacute; et positif, la cha&icirc;ne retourn&eacute;e aura - la longueur <parameter>length</parameter>. Si <parameter>length</parameter> est - donn&eacute; et n&eacute;gatif, la cha&icirc;ne retourn&eacute;e aura la longueur + Si <parameter>length</parameter> est donn&eacute; et positif, + la cha&icirc;ne retourn&eacute;e aura la longueur <parameter>length</parameter>. + Si <parameter>length</parameter> est donn&eacute; et n&eacute;gatif, la + cha&icirc;ne retourn&eacute;e aura la longueur <parameter>length</parameter>, en partant de la fin. </para> <para> - Exemples: + Exemple: <informalexample> <programlisting role="php"> &lt;?php -$rest = substr("abcdef", 1, -1); // retourne "bcde" +$rest = substr("abcdef", 1, -1); +// retourne "bcde" ?&gt; </programlisting> </informalexample> @@ -3312,7 +3317,7 @@ <refnamediv> <refname>ucfirst</refname> <refpurpose> - Force le premier caract&egrave;re d'une cha&icirc;ne en majuscule. + Force le premier caract&egrave;re d'une cha&icirc;ne en majuscule. </refpurpose> </refnamediv> <refsect1> @@ -3324,23 +3329,24 @@ </funcprototype> </funcsynopsis> <para> - Met le premier caract&egrave;re d'une cha&icirc;ne <parameter>str</parameter> - en majuscule, si ce caract&egrave;re est alphab&eacute;tique. + <function>ucfirst</function> met le premier caract&egrave;re + d'une cha&icirc;ne <parameter>str</parameter> en majuscules, si + ce caract&egrave;re est alphab&eacute;tique. </para> <para> - Notez que le caract&egrave;re 'alphab&eacute;tique' est d&eacute;termin&eacute; - par la table de caract&egrave;res locale. Par exemple, dans la table des - caract&egrave;res par d&eacute;faut du "C", des caract&egrave;res tels que - a-umlaut (&auml;) ne seront pas convertis. - <example> - <title>Exemple avec <function>ucfirst</function></title> - <programlisting role="php"> + Notez que le caract&egrave;re 'alphab&eacute;tique' est d&eacute;termin&eacute; + par la table de caract&egrave;res locale. Par exemple, dans la table des + caract&egrave;res par d&eacute;faut du "C", des caract&egrave;res tels que + a-umlaut (&auml;) ne seront pas convertis. + <example> + <title>Exemple avec <function>ucfirst</function></title> + <programlisting role="php"> &lt;?php $text = 'marie a un petit agneau, et l'adore.'; $text = ucfirst($text); // $text vaut : Marie a un petit agneau, et l'adore ?&gt; - </programlisting> - </example> + </programlisting> + </example> </para> <para> Voir aussi <function>strtoupper</function> et <function>strtolower</function>. @@ -3363,17 +3369,17 @@ </funcprototype> </funcsynopsis> <para> - <function>ucwords</function> met le premier caract&egrave;re de chaque mot - de la cha&icirc;ne <parameter>str</parameter> si ce caract&egrave;re est une - lettre. + <function>ucwords</function> met le premier caract&egrave;re de chaque mot + de la cha&icirc;ne <parameter>str</parameter> si ce caract&egrave;re est une + lettre. <example> - <title>Exemple avec <function>ucwords</function></title> - <programlisting role="php"> + <title>Exemple avec <function>ucwords</function></title> + <programlisting role="php"> &lt;?php $text = "marie a un petit agneau, et l'adore."; $text = ucwords($text); // $text vaut : Marie A Un Petit Agneau, Et l'Adore. ?&gt; - </programlisting> + </programlisting> </example> </para> <note> @@ -3432,8 +3438,8 @@ </para> <note> <para> - Le param&egrave;tre <parameter>cut</parameter> a &eacute;t&eacute; - ajout&eacute; dans PHP 4.0.3. + Le param&egrave;tre <parameter>cut</parameter> a &eacute;t&eacute; + ajout&eacute; dans PHP 4.0.3. </para> </note> <para> Index: phpdoc/fr/functions/url.xml diff -u phpdoc/fr/functions/url.xml:1.6 phpdoc/fr/functions/url.xml:1.7 --- phpdoc/fr/functions/url.xml:1.6 Wed Feb 7 01:16:56 2001 +++ phpdoc/fr/functions/url.xml Mon Feb 26 03:10:50 2001 @@ -90,16 +90,16 @@ </funcprototype> </funcsynopsis> <para> - Retourne une cha&icirc;ne dont les s&eacute;quences de - caract&egrave;res %xy, avec xy deux valeurs hexad&eacute;cimales, - auront &eacute;t&eacute; remplac&eacute;es par le caract&egrave;re - ASCII correspondant. Par exemple, la cha&icirc;ne + <function>rawurldecode</function> retourne une cha&icirc;ne dont les + s&eacute;quences de caract&egrave;res %xy, avec xy deux valeurs + hexad&eacute;cimales, auront &eacute;t&eacute; remplac&eacute;es + par le caract&egrave;re ASCII correspondant. Par exemple, la cha&icirc;ne <screen>foo%20bar%40baz</screen> devient <screen>foo bar@baz</screen>. </para> <simpara> Voir aussi <function>rawurlencode</function>, - <function>urldecode</function>, - <function>urlencode</function>. + <function>urldecode</function> et + <function>urlencode</function>. </simpara> </refsect1> </refentry> @@ -117,9 +117,10 @@ </funcprototype> </funcsynopsis> <para> - Retourne une cha&icirc;ne dont tous les caract&egrave;res - non-alpha-num&eacute;riques (hormis <screen>-_.</screen>.) - auront &eacute;t&eacute; remplac&eacute;s par des s&eacute;quences %xy + <function>rawurlencode</function> retourne une cha&icirc;ne dont tous + les caract&egrave;res non-alpha-num&eacute;riques + (hormis <screen>-_.</screen>) auront &eacute;t&eacute; remplac&eacute;s + par des s&eacute;quences <literal>%xy</literal> (<literal>%</literal>), avec xy deux valeurs hexad&eacute;cimales. Ce codage est conforme &agrave; la RFC1738 qui &eacute;vite que les caract&egrave;res sp&eacute;ciaux soient interpr&eacute;t&eacute;s @@ -129,16 +130,18 @@ <example> <title>Exemple avec <function>rawurlencode</function></title> <programlisting role="php"> -echo '&lt;A HREF="ftp://user:', rawurlencode ('foo @+%/'), - '@ftp.my.com/x.txt">'; +&lt;?php +echo '&lt;A HREF="ftp://user:', rawurlencode ('foo @+%/'), '@ftp.my.com/x.txt">'; +?&gt; </programlisting> </example> Ou, si vous transmettez un chemin dans une URL <example> <title>Exemple avec <function>rawurlencode</function></title> <programlisting role="php"> -echo '&lt;A HREF="http://x.com/department_list_script/', - rawurlencode ('sales et marketing/Miami'), '">'; +&lt;?php +echo '&lt;A HREF="http://x.com/department_list_script/', rawurlencode ('sales et marketing/Miami'), '">'; +?&gt; </programlisting> </example> </para> @@ -162,10 +165,9 @@ </funcprototype> </funcsynopsis> <para> - D&eacute;code toutes les s&eacute;quences - <literal>%<replaceable>##</replaceable></literal> et - les remplace par leur valeur. La cha&icirc;ne ainsi - d&eacute;cod&eacute;e est retourn&eacute;e. + <function>urldecode</function> d&eacute;code toutes les s&eacute;quences + <literal>%<replaceable>##</replaceable></literal> et les remplace par + leur valeur. La cha&icirc;ne ainsi d&eacute;cod&eacute;e est retourn&eacute;e. <example> <title>Exemple avec <function>urldecode</function></title> <programlisting role="php"> @@ -202,22 +204,22 @@ </funcprototype> </funcsynopsis> <para> - Retourne une cha&icirc;ne dont les caract&egrave;res - non alpha-num&eacute;riques (hormis <literal>-_.</literal>) - sont remplac&eacute;s par des s&eacute;quences commencant - par un caract&egrave;re pourcentage (<literal>%</literal>), - suivi de deux chiffres hexad&eacute;cimaux. Les espaces sont - remplac&eacute;s par des signes plus (<literal>+</literal>). - Ce codage est celui qui est utilis&eacute; pour poster des - informations dans les formulaires HTML. Le type MIME est - <literal>application/x-www-form-urlencoded</literal>. - Ce codage est diff&eacute;rent de celui sp&eacute;cifi&eacute; - dans la RFC1738 (voir <function>rawurlencode</function>) : pour - des raisons historiques, les espaces sont remplac&eacute;s par - des signes plus (<literal>+</literal>). <function>urlencode</function> - est pratique pour transmettre des informations via une URL. - C'est aussi un moyen de passer des informations d'une - page &agrave; l'autre. + <function>urlencode</function> retourne une cha&icirc;ne dont les + caract&egrave;res non alpha-num&eacute;riques (hormis <literal>-_.</literal>) + sont remplac&eacute;s par des s&eacute;quences commencant + par un caract&egrave;re pourcentage (<literal>%</literal>), + suivi de deux chiffres hexad&eacute;cimaux. Les espaces sont + remplac&eacute;s par des signes plus (<literal>+</literal>). + Ce codage est celui qui est utilis&eacute; pour poster des + informations dans les formulaires HTML. Le type MIME est + <literal>application/x-www-form-urlencoded</literal>. + Ce codage est diff&eacute;rent de celui sp&eacute;cifi&eacute; + dans la RFC1738 (voir <function>rawurlencode</function>) : pour + des raisons historiques, les espaces sont remplac&eacute;s par + des signes plus (<literal>+</literal>). <function>urlencode</function> + est pratique pour transmettre des informations via une URL. + C'est aussi un moyen de passer des informations d'une + page &agrave; l'autre. <example> <title>Exemple avec <function>urlencode</function></title> <programlisting role="php"> @@ -246,7 +248,7 @@ &agrave; la place de <literal>&amp;</literal> comme s&eacute;parateur. Vous n'avez alors pas &agrave; changer la directive arg_separator. Laissez la &agrave; &amp;, mais encodez vos URL avec - <function>htmlentities</function>(urlencode($data)). + <function>htmlentities</function>. <example> <title> Exemple avec <function>urlencode</function> et Index: phpdoc/fr/functions/bzip2.xml diff -u phpdoc/fr/functions/bzip2.xml:1.4 phpdoc/fr/functions/bzip2.xml:1.5 --- phpdoc/fr/functions/bzip2.xml:1.4 Tue Feb 20 00:56:54 2001 +++ phpdoc/fr/functions/bzip2.xml Mon Feb 26 03:10:50 2001 @@ -1,441 +1 @@ - <reference id="ref.bzip2"> - <title>Compression Bzip2</title> - <titleabbrev>Bzip2</titleabbrev> - <partintro> - <para> - Ce module utilise les fonctions de la librairie <ulink - url="&url.bzip2;">bzip2</ulink>, de Julian Seward pour - &eacute;crire et lire des fichier bzip2 (.bz2) de mani&egrave;re transparente. - </para> - <para> - Le support <acronym>bzip2</acronym> par PHP n'est pas activ&eacute; par - d&eacute;faut. Vous devez utiliser l'option de configuration - <parameter>--with-bz2[=DIR]</parameter> lors de la compilation - de PHP pour l'activer. Ce module requiert la librairie - bzip2/libbzip2, version &gt;= 1.0.x. - </para> - <sect1 id="bzip2-example"> - <title>Exemple de compression bzip2</title> - <para> - Cet exemple ouvre un fichier temporaire, et &eacute;crit une ligne de test, - puis il en affiche le contenu. - </para> - <example> - <title>Exemple avec bzip2</title> - <programlisting role="php"> -&lt;?php - -$filename = "/tmp/fichier_de_test.bz2"; -$str = "Ceci est une cha&icirc;ne de test.\n"; - -// ouvre le fichier en &eacute;criture -$bz = bzopen($filename, "w"); - -// &eacute;crit une cha&icirc;ne dans le fichier -bzwrite($bz, $str); - -// ferme le fichier -bzclose($bz); - -// ouvre le fichier en lecture -$bz = bzopen($filename, "r"); - -// lit 10 caract&egrave;res -print bzread($bz, 10); - -// affiche tout le reste du fichier, puis le ferme -print bzread($bz); - -bzclose($bz); - -?&gt; - </programlisting> - </example> - </sect1> - </partintro> - <refentry id="function.bzclose"> - <refnamediv> - <refname>bzclose</refname> - <refpurpose>Ferme un fichier bzip2</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>bzclose</function></funcdef> - <paramdef>int <parameter>bz</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>bzclose</function> ferme le fichier bzip2 - repr&eacute;sent&eacute; par le pointeur <parameter>bz</parameter>. - </para> - <para> - <function>bzclose</function> retourne <literal>TRUE</literal> - en cas de succ&egrave;s, et <literal>FALSE</literal> sinon. - </para> - <para> - Le pointeur de fichier <parameter>bz</parameter> doit &ecirc;tre - valide, et avoir &eacute;t&eacute; ouvert avec <function>bzopen</function>. - </para> - <para> - Voir aussi <function>bzopen</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.bzcompress"> - <refnamediv> - <refname>bzcompress</refname> - <refpurpose>Compresse une cha&icirc;ne avec bzip2</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>bzcompress</function></funcdef> - <paramdef>string <parameter>source</parameter></paramdef> - <paramdef>int - <parameter><optional>blocksize</optional></parameter> - </paramdef> - <paramdef>int - <parameter><optional>workfactor</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>bzcompress</function> compresse la cha&icirc;ne - <parameter>source</parameter> et retourne les donn&eacute;es - ainsi encod&eacute;e. - </para> - <para> - Le param&egrave;tre optionnel <parameter>blocksize</parameter> sp&eacute;cifie - la taille de bloc utilis&eacute; durant la compression, et doit &ecirc;tre un - nombre de 1 &agrave; 9, sachant que 9 repr&eacute;sente la meilleure compression, - mais qu'elle utilise plus de ressource pour ce faire. - <parameter>blocksize</parameter> vaut par d&eacute;faut 4. - </para> - <para> - Le param&egrave;tre optionnel <parameter>workfactor</parameter> contr&ocirc;le - le comportement de la compression dans les pires cas de donn&eacute;es - hautement r&eacute;p&eacute;titives. Cette valeur peut aller de 0 &agrave; 250 (0 - est une valeur sp&eacute;ciale, et 30 la valeur par d&eacute;faut). En dehors - de <parameter>workfactor</parameter>, le r&eacute;sultat sera le m&ecirc;me. - </para> - <para> - <example> - <title>Exemple avec <function>bzcompress</function></title> - <programlisting role="php"> -&lt;?php -$str = "donn&eacute;es de test"; -$bzstr = bzcompress($str, 9); -?&gt; - </programlisting> - </example> - </para> - <para> - Voir aussi <function>bzdecompress</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.bzdecompress"> - <refnamediv> - <refname>bzdecompress</refname> - <refpurpose>D&eacute;compresse une cha&icirc;ne bzip2</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>bzdecompress</function></funcdef> - <paramdef>string <parameter>source</parameter></paramdef> - <paramdef>int - <parameter><optional>small</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>bzdecompress</function> d&eacute;compresse la cha&icirc;ne - <parameter>source</parameter>, en supposant qu'elle a &eacute;t&eacute; - compress&eacute;e avec bzip2, puis la retourne. Si le param&egrave;tre - optionnel <parameter>small</parameter> vaut <literal>TRUE</literal>, - un autre algorithme de d&eacute;compression sera utilis&eacute; : il consomme - moins de m&eacute;moire (le maximum demand&eacute; tombe autour de - 2300 ko), mais fonctionne globalement &agrave; la moiti&eacute; de - la vitesse. Reportez-vous &agrave; la - <ulink url="&url.bzip2;">documentation bzip2</ulink> pour plus de - d&eacute;tails sur cette fonctionnalit&eacute;. - </para> - <para> - <example> - <title>Exemple avec <function>bzdecompress</function></title> - <programlisting role="php"> -&lt;?php -$str = $bzdecompress($bzstr); -?&gt; - </programlisting> - </example> - </para> - <para> - Voir aussi <function>bzcompress</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.bzerrno"> - <refnamediv> - <refname>bzerrno</refname> - <refpurpose>Retourne le num&eacute;ro d'erreur bzip2</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>bzerrno</function></funcdef> - <paramdef>int <parameter>bz</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>bzerrno</function> retourne le num&eacute;ro d'erreur - du fichier bz2 repr&eacute;sent&eacute; par le pointeur - <parameter>bz</parameter>. - </para> - <para> - Voir aussi <function>bzerror</function> et <function>bzerrstr</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.bzerror"> - <refnamediv> - <refname>bzerror</refname> - <refpurpose> - Retourne le num&eacute;ro et le message d'erreur bzip2 dans un tableau - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>bzerror</function></funcdef> - <paramdef>int <parameter>bz</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>bzerror</function> retourne le num&eacute;ro et le message d'erreur - du fichier bz2 repr&eacute;sent&eacute; par le pointeur - <parameter>bz</parameter>. <function>bzerror</function> retourne - un tableau associatif. - </para> - <para> - <example> - <title>Exemple avec <function>bzerror</function></title> - <programlisting role="php"> -&lt;?php -$error = bzerror($bz); - -echo $error["errno"]; -echo $error["errstr"]; -?&gt; - </programlisting> - </example> - </para> - <para> - Voir aussi <function>bzerrno</function> et <function>bzerrstr</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.bzerrstr"> - <refnamediv> - <refname>bzerrstr</refname> - <refpurpose>Retourne le message d'erreur bzip2</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>bzerrstr</function></funcdef> - <paramdef>int <parameter>bz</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>bzerrstr</function> retourne le message d'erreur - du fichier bz2 repr&eacute;sent&eacute; par le pointeur - <parameter>bz</parameter>. - </para> - <para> - Voir aussi <function>bzerrno</function> et <function>bzerror</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.bzflush"> - <refnamediv> - <refname>bzflush</refname> - <refpurpose> - Force l'&eacute;criture de toutes les donn&eacute;es compress&eacute;es - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>bzflush</function></funcdef> - <paramdef>int <parameter>bz</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>bzflush</function> vide les buffers d'&eacute;criture du - fichier repr&eacute;sent&eacute; par <parameter>bz</parameter>. - </para> - <para> - <function>bzflush</function> retourne <literal>TRUE</literal> - en cas de succ&egrave;s, et <literal>FALSE</literal> sinon. - </para> - <para> - Voir aussi <function>bzread</function> et <function>bzwrite</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.bzopen"> - <refnamediv> - <refname>bzopen</refname> - <refpurpose>Ouvre un fichier compress&eacute; avec bzip2</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>bzopen</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>string <parameter>mode</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>bzopen</function> ouvre un fichier bzip2 (.bz2) - en &eacute;criture ou en lecture. <parameter>filename</parameter> - est le nom du fichier &agrave; ouvrir. <parameter>mode</parameter> - est similaire au m&ecirc;me param&egrave;tre de la fonction <function>fopen</function> - (`r' pour lecture, `w' pour &eacute;criture, etc.). - </para> - <para> - Si l'ouverture &eacute;choue, <function>bzopen</function> retourne - <literal>FALSE</literal>, sinon, elle retourne un pointeur - de fichier. - </para> - <para> - <example> - <title>Exemple avec <function>bzopen</function></title> - <programlisting role="php"> -&lt;?php -$bz = bzopen("/tmp/foo.bz2", "r"); -?&gt; - </programlisting> - </example> - </para> - <para> - Voir aussi <function>bzclose</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.bzread"> - <refnamediv> - <refname>bzread</refname> - <refpurpose>Lecture binaire d'un fichier bzip2</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>bzread</function></funcdef> - <paramdef>int <parameter>bz</parameter></paramdef> - <paramdef>int - <parameter><optional>length</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>bzread</function> lit jusqu'&agrave; <parameter>length</parameter> - octets depuis le fichier bzip2, r&eacute;f&eacute;renc&eacute; par le pointeur - <parameter>bz</parameter>. La lecture s'arr&ecirc;te lorsque - <parameter>length</parameter> octets (non compress&eacute;s) - ont &eacute;t&eacute; lus, qu'une erreur est rencontr&eacute;e, - ou bien que la fin du fichier a &eacute;t&eacute; atteinte : - le premier des trois qui survient. Si le param&egrave;tre - optionnel <parameter>length</parameter> est omis, - <function>bzread</function> lit 1024 octets (non compress&eacute;s) en - m&ecirc;me temps. - </para> - <para> - <example> - <title>Exemple avec <function>bzread</function></title> - <programlisting role="php"> -&lt;?php -$bz = bzopen("/tmp/foo.bz2", "r"); -$str = bzread($bz, 2048); -echo $str; -?&gt; - </programlisting> - </example> - </para> - <para> - Voir aussi <function>bzwrite</function> et <function>bzopen</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.bzwrite"> - <refnamediv> - <refname>bzwrite</refname> - <refpurpose>Ecriture binaire dans un fichier bzip2</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>bzwrite</function></funcdef> - <paramdef>int <parameter>bz</parameter></paramdef> - <paramdef>string <parameter>data</parameter></paramdef> - <paramdef>int - <parameter><optional>length</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>bzwrite</function> &eacute;crit le contenu de la cha&icirc;ne - <parameter>data</parameter> dans le fichier bzip2 repr&eacute;sent&eacute; - par <parameter>bz</parameter>. Si le param&egrave;tre optionnel - <parameter>length</parameter> est fourni, l'&eacute;criture sera arr&ecirc;t&eacute;e - apr&egrave;s l'&eacute;criture de <parameter>length</parameter> - octets (non compress&eacute;s), ou la fin de la cha&icirc;ne - (le premier qui survient). - </para> - <para> - <example> - <title>Exemple <function>bzwrite</function></title> - <programlisting role="php"> -&lt;?php -$str = "donn&eacute;es non compress&eacute;es"; -$bz = bzopen("/tmp/foo.bz2", "w"); -bzwrite($bz, $str, strlen($str)); -?&gt; - </programlisting> - </example> - </para> - <para> - Voir aussi <function>bzread</function> and <function>bzopen</function>. - </para> - </refsect1> - </refentry> - </reference> -<!-- Keep this comment at the end of the file -Local variables: -mode: sgml -sgml-omittag:t -sgml-shorttag:t -sgml-minimize-attributes:nil -sgml-always-quote-attributes:t -sgml-indent-step:1 -sgml-indent-data:t -sgml-parent-document:nil -sgml-default-dtd-file:"../../manual.ced" -sgml-exposed-tags:nil -sgml-local-catalogs:nil -sgml-local-ecat-files:nil -End: ---> + <reference id="ref.bzip2"> <title>Compression Bzip2</title> <titleabbrev>Bzip2</titleabbrev> <partintro> <para> Ce module utilise les fonctions de la librairie <ulink url="&url.bzip2;">bzip2</ulink>, de Julian Seward pour &eacute;crire et lire des fichier bzip2 (.bz2) de mani&egrave;re transparente. </para> <para> Le support <acronym>bzip2</acronym> par PHP n'est pas activ&eacute; par d&eacute;faut. Vous devez utiliser l'option de configuration <link linkend="install.configure.with-bzip2-dir">--with-bz2[=DIR]</link> lors de la compilation de PHP pour l'activer. Ce module requiert la librairie bzip2/libbzip2, version &gt;= 1.0.x. </para> <sect1 id="bzip2-example"> <title>Exemple de compression bzip2</title> <para> Cet exemple ouvre un fichier temporaire, et &eacute;crit une ligne de test, puis il en affiche le contenu. </para> <example> <title>Exemple avec bzip2</title> <programlisting role="php">&lt;?php$filename = "/tmp/fichier_de_test.bz2";$str = "Ceci est une cha&icirc;ne de test.\n";// ouvre le fichier en &eacute;criture$bz = bzopen($filename, "w");// &eacute;crit une cha&icirc;ne dans le fichierbzwrite($bz, $str);// ferme le fichierbzclose($bz);// ouvre le fichier en lecture$bz = bzopen($filename, "r");// lit 10 caract&egrave;resprint bzread($bz, 10);// affiche tout le reste du fichier, puis le fermeprint bzread($bz);bzclose($bz);?&gt; </programlisting> </example> </sect1> </partintro> <refentry id="function.bzclose"> <refnamediv> <refname>bzclose</refname> <refpurpose>Ferme un fichier bzip2</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>bzclose</function></funcdef> <paramdef>int <parameter>bz</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>bzclose</function> ferme le fichier bzip2 repr&eacute;sent&eacute; par le pointeur <parameter>bz</parameter>. </para> <para> <function>bzclose</function> retourne <literal>TRUE</literal> en cas de succ&egrave;s, et <literal>FALSE</literal> sinon. </para> <para> Le pointeur de fichier <parameter>bz</parameter> doit &ecirc;tre valide, et avoir &eacute;t&eacute; ouvert avec <function>bzopen</function>. </para> <para> Voir aussi <function>bzopen</function>. </para> </refsect1> </refentry> <refentry id="function.bzcompress"> <refnamediv> <refname>bzcompress</refname> <refpurpose>Compresse une cha&icirc;ne avec bzip2</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>string <function>bzcompress</function></funcdef> <paramdef>string <parameter>source</parameter></paramdef> <paramdef>int <parameter><optional>blocksize</optional></parameter> </paramdef> <paramdef>int <parameter><optional>workfactor</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>bzcompress</function> compresse la cha&icirc;ne <parameter>source</parameter> et retourne les donn&eacute;es ainsi encod&eacute;e. </para> <para> Le param&egrave;tre optionnel <parameter>blocksize</parameter> sp&eacute;cifie la taille de bloc utilis&eacute; durant la compression, et doit &ecirc;tre un nombre de 1 &agrave; 9, sachant que 9 repr&eacute;sente la meilleure compression, mais qu'elle utilise plus de ressource pour ce faire. <parameter>blocksize</parameter> vaut par d&eacute;faut 4. </para> <para> Le param&egrave;tre optionnel <parameter>workfactor</parameter> contr&ocirc;le le comportement de la compression dans les pires cas de donn&eacute;es hautement r&eacute;p&eacute;titives. Cette valeur peut aller de 0 &agrave; 250 (0 est une valeur sp&eacute;ciale, et 30 la valeur par d&eacute;faut). En dehors de <parameter>workfactor</parameter>, le r&eacute;sultat sera le m&ecirc;me. </para> <para> <example> <title>Exemple avec <function>bzcompress</function></title> <programlisting role="php">&lt;?php$str = "donn&eacute;es de test";$bzstr = bzcompress($str, 9);?&gt; </programlisting> </example> </para> <para> Voir aussi <function>bzdecompress</function>. </para> </refsect1> </refentry> <refentry id="function.bzdecompress"> <refnamediv> <refname>bzdecompress</refname> <refpurpose>D&eacute;compresse une cha&icirc;ne bzip2</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>string <function>bzdecompress</function></funcdef> <paramdef>string <parameter>source</parameter></paramdef> <paramdef>int <parameter><optional>small</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>bzdecompress</function> d&eacute;compresse la cha&icirc;ne <parameter>source</parameter>, en supposant qu'elle a &eacute;t&eacute; compress&eacute;e avec bzip2, puis la retourne. Si le param&egrave;tre optionnel <parameter>small</parameter> vaut <literal>TRUE</literal>, un autre algorithme de d&eacute;compression sera utilis&eacute; : il consomme moins de m&eacute;moire (le maximum demand&eacute; tombe autour de 2300 ko), mais fonctionne globalement &agrave; la moiti&eacute; de la vitesse. Reportez-vous &agrave; la <ulink url="&url.bzip2;">documentation bzip2</ulink> pour plus de d&eacute;tails sur cette fonctionnalit&eacute;. </para> <para> <example> <title>Exemple avec <function>bzdecompress</function></title> <programlisting role="php">&lt;?php$str = $bzdecompress($bzstr);?&gt; </programlisting> </example> </para> <para> Voir aussi <function>bzcompress</function>. </para> </refsect1> </refentry> <refentry id="function.bzerrno"> <refnamediv> <refname>bzerrno</refname> <refpurpose>Retourne le num&eacute;ro d'erreur bzip2</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>bzerrno</function></funcdef> <paramdef>int <parameter>bz</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>bzerrno</function> retourne le num&eacute;ro d'erreur du fichier bz2 repr&eacute;sent&eacute; par le pointeur <parameter>bz</parameter>. </para> <para> Voir aussi <function>bzerror</function> et <function>bzerrstr</function>. </para> </refsect1> </refentry> <refentry id="function.bzerror"> <refnamediv> <refname>bzerror</refname> <refpurpose> Retourne le num&eacute;ro et le message d'erreur bzip2 dans un tableau </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>array <function>bzerror</function></funcdef> <paramdef>int <parameter>bz</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>bzerror</function> retourne le num&eacute;ro et le message d'erreur du fichier bz2 repr&eacute;sent&eacute; par le pointeur <parameter>bz</parameter>. <function>bzerror</function> retourne un tableau associatif. </para> <para> <example> <title>Exemple avec <function>bzerror</function></title> <programlisting role="php">&lt;?php$error = bzerror($bz);echo $error["errno"];echo $error["errstr"];?&gt; </programlisting> </example> </para> <para> Voir aussi <function>bzerrno</function> et <function>bzerrstr</function>. </para> </refsect1> </refentry> <refentry id="function.bzerrstr"> <refnamediv> <refname>bzerrstr</refname> <refpurpose>Retourne le message d'erreur bzip2</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>string <function>bzerrstr</function></funcdef> <paramdef>int <parameter>bz</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>bzerrstr</function> retourne le message d'erreur du fichier bz2 repr&eacute;sent&eacute; par le pointeur <parameter>bz</parameter>. </para> <para> Voir aussi <function>bzerrno</function> et <function>bzerror</function>. </para> </refsect1> </refentry> <refentry id="function.bzflush"> <refnamediv> <refname>bzflush</refname> <refpurpose> Force l'&eacute;criture de toutes les donn&eacute;es compress&eacute;es </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>bzflush</function></funcdef> <paramdef>int <parameter>bz</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>bzflush</function> vide les buffers d'&eacute;criture du fichier repr&eacute;sent&eacute; par <parameter>bz</parameter>. </para> <para> <function>bzflush</function> retourne <literal>TRUE</literal> en cas de succ&egrave;s, et <literal>FALSE</literal> sinon. </para> <para> Voir aussi <function>bzread</function> et <function>bzwrite</function>. </para> </refsect1> </refentry> <refentry id="function.bzopen"> <refnamediv> <refname>bzopen</refname> <refpurpose>Ouvre un fichier compress&eacute; avec bzip2</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>bzopen</function></funcdef> <paramdef>string <parameter>filename</parameter></paramdef> <paramdef>string <parameter>mode</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>bzopen</function> ouvre un fichier bzip2 (.bz2) en &eacute;criture ou en lecture. <parameter>filename</parameter> est le nom du fichier &agrave; ouvrir. <parameter>mode</parameter> est similaire au m&ecirc;me param&egrave;tre de la fonction <function>fopen</function> (`r' pour lecture, `w' pour &eacute;criture, etc.). </para> <para> Si l'ouverture &eacute;choue, <function>bzopen</function> retourne <literal>FALSE</literal>, sinon, elle retourne un pointeur de fichier. </para> <para> <example> <title>Exemple avec <function>bzopen</function></title> <programlisting role="php">&lt;?php$bz = bzopen("/tmp/foo.bz2", "r");?&gt; </programlisting> </example> </para> <para> Voir aussi <function>bzclose</function>. </para> </refsect1> </refentry> <refentry id="function.bzread"> <refnamediv> <refname>bzread</refname> <refpurpose>Lecture binaire d'un fichier bzip2</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>string <function>bzread</function></funcdef> <paramdef>int <parameter>bz</parameter></paramdef> <paramdef>int <parameter><optional>length</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>bzread</function> lit jusqu'&agrave; <parameter>length</parameter> octets depuis le fichier bzip2, r&eacute;f&eacute;renc&eacute; par le pointeur <parameter>bz</parameter>. La lecture s'arr&ecirc;te lorsque <parameter>length</parameter> octets (non compress&eacute;s) ont &eacute;t&eacute; lus, qu'une erreur est rencontr&eacute;e, ou bien que la fin du fichier a &eacute;t&eacute; atteinte : le premier des trois qui survient. Si le param&egrave;tre optionnel <parameter>length</parameter> est omis, <function>bzread</function> lit 1024 octets (non compress&eacute;s) en m&ecirc;me temps. </para> <para> <example> <title>Exemple avec <function>bzread</function></title> <programlisting role="php">&lt;?php$bz = bzopen("/tmp/foo.bz2", "r");$str = bzread($bz, 2048);echo $str;?&gt; </programlisting> </example> </para> <para> Voir aussi <function>bzwrite</function> et <function>bzopen</function>. </para> </refsect1> </refentry> <refentry id="function.bzwrite"> <refnamediv> <refname>bzwrite</refname> <refpurpose>Ecriture binaire dans un fichier bzip2</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>bzwrite</function></funcdef> <paramdef>int <parameter>bz</parameter></paramdef> <paramdef>string <parameter>data</parameter></paramdef> <paramdef>int <parameter><optional>length</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>bzwrite</function> &eacute;crit le contenu de la cha&icirc;ne <parameter>data</parameter> dans le fichier bzip2 repr&eacute;sent&eacute; par <parameter>bz</parameter>. Si le param&egrave;tre optionnel <parameter>length</parameter> est fourni, l'&eacute;criture sera arr&ecirc;t&eacute;e apr&egrave;s l'&eacute;criture de <parameter>length</parameter> octets (non compress&eacute;s), ou la fin de la cha&icirc;ne (le premier qui survient). </para> <para> <example> <title>Exemple <function>bzwrite</function></title> <programlisting role="php">&lt;?php$str = "donn&eacute;es non compress&eacute;es";$bz = bzopen("/tmp/foo.bz2", "w");bzwrite($bz, $str, strlen($str));?&gt; </programlisting> </example> </para> <para> Voir aussi <function>bzread</function> and <function>bzopen</function>. </para> </refsect1> </refentry> </reference><!-- Keep this comment at the end of the fileLocal variables:mode: sgmlsgml-omittag:tsgml-shorttag:tsgml-minimize-attributes:nilsgml-always-quote-attributes:tsgml-indent-step:1sgml-indent-data:tsgml-parent-document:nilsgml-default-dtd-file:"../../manual.ced"sgml-exposed-tags:nilsgml-local-catalogs:nilsgml-local-ecat-files:nilEnd:--> \ No newline at end of file
« previous php.doc (#969334485) next »