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ée des sé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ée des sé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 < 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 < 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);
?>
- </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
être appelé avant <function>cpdf_open</function>
pour être effective. Elle fixe les limites de tous
les documents ouverts aprè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é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é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émoire. Les pages terminées prennent moins de
place, mais ne peuvent plus être modifié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ès.
</para>
<para>
- Voir aussi <function>cpdf_close</function>.
+ Voir aussi <function>cpdf_close</function>.
</para>
</refsect1>
</refentry>
@@ -469,7 +469,7 @@
appelée dans paramè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> écrit un document
PDF dans un fichier, s'il a été créé
- en mémoire. <function>cpdf_save_to_file</function> n'est
- pas nécessaire si un nom de fichier a été
+ en mémoire. <function>cpdf_save_to_file</function> n'est
+ pas nécessaire si un nom de fichier a été
fourni lors de l'appel à <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ú toutes les prochaînes opérations
- vont avoir lieu. On peut changer de page jusqu'à ce qu'une
- page soit terminée avec <function>cpdf_finalize_page</function>.
+ <function>cpdf_set_current_page</function> fixe la page
+ courante, oú toutes les prochaînes opérations
+ vont avoir lieu. On peut changer de page jusqu'à ce qu'une
+ page soit terminé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 @@
à 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é 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é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é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é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éfaut (72) qui est utilisé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éfaut (72) qui est utilisé.
</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ées sur fichiers. En tant que tel, les fonctionnalités
sont limitées à une partie des fonctionnalités des
bases de donné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és codées dans DB2 et gdbm
ne sont pas supportées, car elles ne sont compatibles qu'au
niveau du code source, et ne peuvent pas gé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é 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écrit comme un "ensemble d'outils qui fournissent une base
de données performante, tant pour les applications
indé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éger, pour créer et
- lire des bases de données constantes". C'est l'auteur de qmail qui
- l'a é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éger, pour créer et
+ lire des bases de données constantes". C'est l'auteur de qmail qui
+ l'a é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écupère un pointeur dessus.
+ Ouvre un dossier, et récupère un pointeur dessus.
</refpurpose>
</refnamediv>
<refsect1>
@@ -152,6 +152,30 @@
pour être utilisé avec les fonctions
<function>closedir</function>, <function>readdir</function>
et <function>rewinddir</function>.
+ </para>
+ <para>
+ Si le paramètre <parameter>path</parameter> n'est pas un dossier
+ valide, ou si le dossier ne peut être accédé
+ pour des raisons de permissions ou des erreurs liées au
+ système de fichiers, <function>opendir</function> retourne
+ <literal>FALSE</literal> et génè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">
+<?php
+if ($dir = @opendir("/tmp")) {
+ while($file = readdir($dir)) {
+ echo "$file\n";
+ }
+ closedir($dir);
+}
+?>
+ </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ètre le chemin complet
- d'un fichier et en extrait le nom du fichier.
+ <function>basename</function> prend en paramètre le chemin complet
+ d'un fichier et en extrait le nom du fichier.
</para>
<para>
- Sous Windows, les caractères (<literal>/</literal>) et antislash
- (<literal>\</literal>) sont utilisés comme séparateur de
- dossier. Sous les autres OS, seul le caractère slash
- (<literal>/</literal>) est utilisé.
+ Sous Windows, les caractères (<literal>/</literal>) et antislash
+ (<literal>\</literal>) sont utilisés comme séparateur de
+ dossier. Sous les autres OS, seul le caractère slash
+ (<literal>/</literal>) est utilisé.
</para>
<para>
<example>
@@ -690,7 +690,7 @@
du serveur.
</simpara>
<simpara>
- Le résultat de <function>file_exists</function> est mis en cache.
+ Le résultat de <function>file_exists</function> est mis en cache.
Reportez-vous à <function>clearstatcache</function> pour
plus de dé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érique : il faut
utiliser
<function>posix_getpwuid</function> pour retrouver le nom d'utilisateur.
</para>
@@ -1431,8 +1431,8 @@
type les autres systèmes (i.e. Windows) retourne -1.
</para>
<para>
- Les résultats de <function>fstat</function> sont mis en cache .
- Reportez-vous à la fonction <function>clearstatcache</function>
+ Les résultats de <function>fstat</function> sont mis en cache .
+ Reportez-vous à la fonction <function>clearstatcache</function>
pour plus de détails.
</para>
</refsect1>
@@ -1485,8 +1485,8 @@
<para>
<function>ftruncate</function> prend le pointeur de fichier
<parameter>fp</parameter> et le tronque à la taille de
- <parameter>size</parameter>. La fonction retourne
- <literal>TRUE</literal> en cas de succès, et
+ <parameter>size</parameter>. La fonction retourne
+ <literal>TRUE</literal> en cas de succè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éer un fichier
+ <function>set_file_buffer</function> pour cré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é en lecture.</refpurpose>
+ <refpurpose>Indique un fichier est autorisé en
+é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 écriture.
</para>
<para>
N'oubliez pas que PHP accède aux fichiers avec les mê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écent.
</simpara>
<simpara>
- PHP 3, d'un autre coté, ne doit pas être utilisé
- avec une version plus récente que la 2.01. Depuis la
+ PHP 3, d'un autre coté, ne doit pas être utilisé
+ avec une version plus ré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écent.
</simpara>
</sect1>
@@ -239,7 +239,7 @@
<title>Installation des anciennes versions de PDFLib</title>
<simpara>
Si vous utilisez PDFLib 2.01 vérifiez comment votre librairie a
- été installée. Il doit y avoir un fichier (ou
+ été installée. Il doit y avoir un fichier (ou
un lien) vers <filename>libpdf.so</filename>. La version 2.01 ne fait
que créer une librairie avec le nom <filename>libpdf2.01.so</filename>
qui ne peut être trouvé 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épare une police pour
+ <function>pdf_findfont</function> prépare une police pour
utilisation ultérieure avec <function>pdf_setfont</function>.
Les dimensions seront chargées, et lorsque c'est possible, le
fichier de police sera vérifié, mais pas utilisé.
@@ -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és (si le style de bord d'une annotation est en
- pointillés). <parameter>black</parameter> représente
- la taille des traits noirs, et <parameter>white</parameter> celle
+ des pointillés (si le style de bord d'une annotation est en
+ pointillés). <parameter>black</parameter> repré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éférencez une police dans un fichier
+ Si vous réfé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êmes.
Sinon, la police sera aggrandie plusieur fois (Merci à
@@ -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ères
- qui n'ont pas pu être traités, car ils ne rentraient pas
+ qui n'ont pas pu être traité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 été 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éveloppé au département de
- Science informatique, à UC Berkeley, mis en place la majorité
- des concepts des bases relationnelles, actuellement disponibles sur le
- marché. PostgreSQL accepte le langage SQL92/SQL3, assure
- l'intégrité transactionnelle, et l'extension de type.
- PostgreSQL est une évolution du code originale de Berkeley :
- il est Open Source et dans le domaine public.
+ Postgres, initialement développé au département de
+ Science informatique, à UC Berkeley, mis en place la majorité
+ des concepts des bases relationnelles, actuellement disponibles sur le
+ marché. PostgreSQL accepte le langage SQL92/SQL3, assure
+ l'intégrité transactionnelle, et l'extension de type.
+ PostgreSQL est une é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 à
- (en anglais) : <ulink url="&url.pgsql;">www.PostgreSQL.org</ulink>.
+ PostgreSQL est disponible sans frais. La version actuelle est disponible à
+ (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édiée à ces nouvelles capacités.
- La socket est située dans le dossier
- <filename>/tmp/.s.PGSQL.5432</filename>. Cette option peut être
- activée avec '-i' passé au <command>postmaster</command>
- et cela s'interprète: "é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édiée à ces nouvelles capacités.
+ La socket est située dans le dossier
+ <filename>/tmp/.s.PGSQL.5432</filename>. Cette option peut être
+ activée avec '-i' passé au <command>postmaster</command>
+ et cela s'interprète: "é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é à
- <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é à <parameter>connection</parameter>.
</para>
<note>
<para>
@@ -187,8 +188,9 @@
//connexion à une base de données nommée "marie"
$dbconn2 = pg_connect("host=localhost port=5432 dbname=marie");
//connexion à une base de données nommée "marie" sur
l'hôte "localhost" sur le port "5432"
-$dbconn3 = pg_connect("user=agneau password=baaaa dbname=marie ");
-//connexion à une base de données nommé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 à une base de données nommée "marie" sur le serveur
+"mouton" avec
+// un nom d'utilisateur et le mot de passe associé
?>
</programlisting>
</example>
@@ -226,9 +228,9 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne le nom de la base de donnée PostgreSQL associée
- à 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ées
+ PostgreSQL associée à 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ès une opération de copie. Il faut utiliser
cette fonction, sous peine de recevoir une erreur "out of sync"
- (désynchronisé). Retourne <literal>TRUE</literal> en cas de
succès, et
- <literal>FALSE</literal> sinon.
+ (désynchronisé). Retourne <literal>TRUE</literal>
+ en cas de succès, et <literal>FALSE</literal> sinon.
</para>
<para>
Pour plus de détails et un exemple voyez :
@@ -274,12 +276,14 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne une chaîne contenant le dernier message d'erreur, ou
<literal>FALSE</literal> en cas d'échec. Il sera impossible d'obtenir des
détails sur
- l'erreur générée, en utilisant la fonction
- <function>pg_errormessage</function> si une erreur est survenue dans
- la dernière action pour laquelle une connexion valide existe.
- Cette fonction retournera une chaîne contenant le message
- d'erreur généré par le serveur final.
+ <function>pg_errormessage</function> retourne une chaîne contenant
+ le dernier message d'erreur, ou <literal>FALSE</literal>
+ en cas d'échec. Il sera impossible d'obtenir des détails sur
+ l'erreur générée, en utilisant la fonction
+ <function>pg_errormessage</function> si une erreur est survenue dans
+ la dernière action pour laquelle une connexion valide existe.
+ <function>pg_errormessage</function> retournera une chaîne contenant
+ le message d'erreur généré par le serveur final.
</para>
</refsect1>
</refentry>
@@ -298,23 +302,24 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne un index de résultat, si la requête a été
- correctement exécutée, et <literal>FALSE</literal> en cas
d'échec, ou si
- la connexion connection n'était pas un index de connexion valide. En
- cas d'erreur, le message d'erreur peut être obtenu grâce à la
- fonction <function>pg_errormessage</function>, si l'index de connexion
- était valide. Envoie une requête à un serveur
- PostgreSQL identifié grâce à l'index de connexion. La
- réponse retournée par cette fonction est un index de
- résultat qui devra être utilisé pour accéder
- aux lignes de résultat, grâce à d'autres
- fonctions PostgreSQL.
+ <function>pg_exec</function> retourne un index de résultat,
+ si la requête a été correctement exécutée,
+ et <literal>FALSE</literal> en cas d'échec, ou si
+ la connexion connection n'était pas un index de connexion valide. En
+ cas d'erreur, le message d'erreur peut être obtenu grâce à la
+ fonction <function>pg_errormessage</function>, si l'index de connexion
+ était valide. Envoie une requête à un serveur
+ PostgreSQL identifié grâce à l'index de connexion. La
+ réponse retournée par cette fonction est un index de
+ résultat qui devra être utilisé pour accéder
+ aux lignes de résultat, grâce à d'autres
+ fonctions PostgreSQL.
<note>
<simpara>
- PHP/FI retournait 1 lorsque la requête n'attendait pas de
- données en réponse (insertion, modifcations, par exemple),
- et retournait un nombre plus grand que 1, même sur un select qui
- donnait un ensemble vide. Ce n'est plus le cas.
+ PHP/FI retournait 1 lorsque la requête n'attendait pas de
+ données en réponse (insertion, modifcations, par exemple),
+ et retournait un nombre plus grand que 1, mê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 à la ligne demandée, dans
- le résultat identifiée par result, et <literal>FALSE</literal>
, si il ne
- reste plus de lignes.
- </para>
- <para>
- <function>pg_fetch_array</function> est une version évoluée de
- <function>pg_fetch_row</function>. En plus de proposer un tableau à
- indice numérique, elle peut aussi enregistrer les données
- dans un tableau associatif, en utilisant les noms des champs comme
- clé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
+ à la ligne demandée, dans le résultat identifié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 évoluée de
+ <function>pg_fetch_row</function>. En plus de proposer un tableau à
+ indice numérique, elle peut aussi enregistrer les données
+ dans un tableau associatif, en utilisant les noms des champs comme
+ clé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 été ajouté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étails, reportez vous à
- <function>pg_fetch_row</function>.
+ Pour plus de détails, reportez vous à
+ <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é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ée, ou
+ <literal>FALSE</literal> , si il n'y a plus de lignes.
</para>
<para>
<function>pg_fetch_object</function> est similaire à
@@ -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é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é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):
?>
- <H1>Connexion impossible à la base postgres <?php echo $database
></H1> <?php
+ <H1>Connexion impossible à la base postgres <?php echo $database
+></H1> <?php
exit;
endif;
$qu = pg_exec($db_conn, "SELECT * FROM verlag ORDER BY autor");
$row = 0; // postgres ré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."<BR>";
+ echo $data->autor." (";
+ echo $data->jahr ."): ";
+ echo $data->titel."<BR>";
$row++;
endwhile;
?>
-<PRE><?php
+<PRE><?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->$item[0]."\n";
endwhile;
$row++;
endwhile;
echo "----------\n";
?>
-</PRE>
+</PRE>
<?php
pg_freeresult($qu);
pg_close($db_conn);
@@ -500,8 +507,9 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne un tableau qui contient les données de la ligne demandée,
- ou <literal>FALSE</literal> , si il ne reste plus de lignes.
+ <function>pg_fetch_row</function> retourne un tableau qui contient
+ les données de la ligne demandé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ésultat
@@ -510,9 +518,9 @@
sous la forme d'un tableau, qui commence à l'index 0.
</para>
<para>
- Les appels ultérieurs à <function>pg_fetch_row</function>
- retourneront la ligne d'après, ou bien <literal>FALSE</literal>,
lorsqu'il n'y aura
- plus de lignes.
+ Les appels ultérieurs à <function>pg_fetch_row</function>
+ retourneront la ligne d'aprè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 à NULL. Retourne 0 si le champs n'est pas NULL.
- Retourne 1 si le champs est à NULL. Le champs peut être
- identifié avec son nom ou son index numérique
- (commencant à 0).
+ <function>pg_fieldisnull</function> teste si un champs est à
+ NULL. <function>pg_fieldisnull</function> retourne 0 si le champs n'est
+ pas NULL. <function>pg_fieldisnull</function> retourne 1 si le champs est
+ à NULL. Le champs peut être identifié avec son nom ou
+ son index numérique (commencant à 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éro <parameter>field_number</parameter> dans le
- résultat <parameter>result_id</parameter>. La numérotation
- des champs commence à 0.
+ colonne numéro <parameter>field_number</parameter> dans le
+ résultat <parameter>result_id</parameter>. La numérotation
+ des champs commence à 0.
</para>
</refsect1>
</refentry>
@@ -819,9 +828,9 @@
<parameter>oid</parameter> est un identifiant d'objet de grande taille
qui sera exporté dans le fichier <parameter>filename</parameter>, qui
spécifie son chemin. RetourneFALSEsi une erreur survient,
- et <literal>TRUE</literal> en cas de succè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è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ès, ou
- FALSEen cas d'erreur. Ouvre une connexion permanente à
+ <function>pg_pconnect</function> retourne un index de connexion
+ en cas de succès, ou <literal>FALSE</literal> en cas d'erreur.
+ <function>pg_pconnect</function> ouvre une connexion permanente à
une base PostgreSQL. Les arguments doivent être insérés
dans une chaîne à 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ès rapides dans une table, initiée par une
opération de copie PostgreSQL copy-operation. Le caractère final
- NULL est automatiquement ajouté. Retourne <literal>TRUE</literal> en cas
de succès,
- et <literal>FALSE</literal>.
+ NULL est automatiquement ajouté. Retourne <literal>TRUE</literal>
+ en cas de succè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é dans un fichier. Pour comprendre ces
- lignes, il faut être familier avec le protocole de communication
- interne à 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é dans un fichier.
+ Pour comprendre ces lignes, il faut être familier avec le protocole
+ de communication interne à PostgreSQL. Pour ceux qui le ne sont pas,
elles peuvent être utiles pour suivre les requêtes et les erreurs :
avec la commande <command>grep '^To backend' trace.log</command>, vous
pourrez voir les requêtes réellement envoyé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ée à
- <parameter>connection_id</parameter>.
+ <function>pg_tty</function> retourne le nom de tty de la connexion
+ associée à <parameter>connection_id</parameter>.
</para>
</refsect1>
</refentry>
@@ -1329,13 +1339,13 @@
</funcprototype>
</funcsynopsis>
<para>
- Termine le suivi d'une connexion PostgreSQL, initiée avec
- <function>pg_trace</function>. <parameter>connection</parameter>
- indique la connexion à suivre. Par défaut, c'est la
- dernière ouverte.
+ <function>pg_untrace</function> termine le suivi d'une connexion
+ PostgreSQL, initiée avec <function>pg_trace</function>.
+ <parameter>connection</parameter> indique la connexion à
+ suivre. Par défaut, c'est la derniè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înes</titleabbrev>
<partintro>
<simpara>
- Ces fonctions permettent la manipulations de chaînes de
- caractères. Certaines sections plus spécialisées
- sont disponibles dès les sections sur les expressions
- régulières et dans la section URL.
+ Ces fonctions permettent la manipulations de chaînes de
+ caractères. Certaines sections plus spécialisées
+ sont disponibles dès les sections sur les expressions
+ régulières et dans la section URL.
</simpara>
- <para>
+ <para>
Pour plus de détails sur le comportement des chaînes de
caractères,
notamment concerenant les guillemets simples ou doubles, et les
séquences d'échappement, reportez vous à
@@ -2591,18 +2591,18 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>strrchr</function> retourne la partie de la chaîne
- <parameter>haystack</parameter> qui commence à la dernière
- occurence de <parameter>needle</parameter> et va jusqu'à la fin de
- la chaîne <parameter>haystack</parameter>.
+ <function>strrchr</function> retourne la partie de la chaîne
+ <parameter>haystack</parameter> qui commence à la dernière
+ occurence de <parameter>needle</parameter> et va jusqu'à la fin de
+ la chaîne <parameter>haystack</parameter>.
</para>
<para>
- <function>strrchr</function> retourne <literal>FALSE</literal>
- si <parameter>needle</parameter> n'est pas trouvé.
+ <function>strrchr</function> retourne <literal>FALSE</literal>
+ si <parameter>needle</parameter> n'est pas trouvé.
</para>
<para>
- Si <parameter>needle</parameter> contient plus d'un caractère,
- les autres sont ignorés.
+ Si <parameter>needle</parameter> contient plus d'un caractère,
+ les autres sont ignorés.
</para>
<para>
Si <parameter>needle</parameter> n'est pas une chaîne, il est converti en
@@ -2643,7 +2643,8 @@
<para>
<function>str_repeat</function> retourne <parameter>input_str</parameter>
répétées <parameter>multiplier</parameter>
- fois. <parameter>multiplier</parameter> doit être supérieur
à 0.
+ fois. <parameter>multiplier</parameter> doit être
+ supérieur à 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'à la fin.
</para>
<para>
- Si <parameter>needle</parameter> n'est pas trouvé, retourne
<literal>FALSE</literal>.
+ Si <parameter>needle</parameter> n'est pas trouvé, retourne
+ <literal>FALSE</literal>.
</para>
<para>
<note>
@@ -2850,10 +2852,10 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>strtok</function> est utilisée pour morceller une chaîne.
- Pour cela, si vous avez une chaîne du type "ceci est une chaîne
- exemple", vous pouvez la morceller en mots, en utilisant ' ' comme
- délimiteur.
+ <function>strtok</function> est utilisée pour morceller une
+ chaîne. Pour cela, si vous avez une chaîne du type "ceci
+ est une chaîne exemple", vous pouvez la morceller en mots, en
+ utilisant ' ' comme délimiteur.
<example>
<title>Exemple avec <function>strtok</function></title>
<programlisting role="php">
@@ -2915,7 +2917,8 @@
<?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
?>
</programlisting>
</example>
@@ -3158,17 +3161,19 @@
</informalexample>
</para>
<para>
- Si <parameter>length</parameter> est donné et positif, la chaîne
retournée aura
- la longueur <parameter>length</parameter>. Si <parameter>length</parameter> est
- donné et négatif, la chaîne retournée aura la
longueur
+ Si <parameter>length</parameter> est donné et positif,
+ la chaîne retournée aura la longueur <parameter>length</parameter>.
+ Si <parameter>length</parameter> est donné et négatif, la
+ chaîne retournée aura la longueur
<parameter>length</parameter>, en partant de la fin.
</para>
<para>
- Exemples:
+ Exemple:
<informalexample>
<programlisting role="php">
<?php
-$rest = substr("abcdef", 1, -1); // retourne "bcde"
+$rest = substr("abcdef", 1, -1);
+// retourne "bcde"
?>
</programlisting>
</informalexample>
@@ -3312,7 +3317,7 @@
<refnamediv>
<refname>ucfirst</refname>
<refpurpose>
- Force le premier caractère d'une chaîne en majuscule.
+ Force le premier caractère d'une chaîne en majuscule.
</refpurpose>
</refnamediv>
<refsect1>
@@ -3324,23 +3329,24 @@
</funcprototype>
</funcsynopsis>
<para>
- Met le premier caractère d'une chaîne <parameter>str</parameter>
- en majuscule, si ce caractère est alphabétique.
+ <function>ucfirst</function> met le premier caractère
+ d'une chaîne <parameter>str</parameter> en majuscules, si
+ ce caractère est alphabétique.
</para>
<para>
- Notez que le caractère 'alphabétique' est déterminé
- par la table de caractères locale. Par exemple, dans la table des
- caractères par défaut du "C", des caractères tels que
- a-umlaut (ä) ne seront pas convertis.
- <example>
- <title>Exemple avec <function>ucfirst</function></title>
- <programlisting role="php">
+ Notez que le caractère 'alphabétique' est déterminé
+ par la table de caractères locale. Par exemple, dans la table des
+ caractères par défaut du "C", des caractères tels que
+ a-umlaut (ä) ne seront pas convertis.
+ <example>
+ <title>Exemple avec <function>ucfirst</function></title>
+ <programlisting role="php">
<?php
$text = 'marie a un petit agneau, et l'adore.';
$text = ucfirst($text); // $text vaut : Marie a un petit agneau, et l'adore
?>
- </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ère de chaque mot
- de la chaîne <parameter>str</parameter> si ce caractère est une
- lettre.
+ <function>ucwords</function> met le premier caractère de chaque mot
+ de la chaîne <parameter>str</parameter> si ce caractè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">
<?php
$text = "marie a un petit agneau, et l'adore.";
$text = ucwords($text); // $text vaut : Marie A Un Petit Agneau, Et l'Adore.
?>
- </programlisting>
+ </programlisting>
</example>
</para>
<note>
@@ -3432,8 +3438,8 @@
</para>
<note>
<para>
- Le paramètre <parameter>cut</parameter> a été
- ajouté dans PHP 4.0.3.
+ Le paramètre <parameter>cut</parameter> a été
+ ajouté 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îne dont les séquences de
- caractères %xy, avec xy deux valeurs hexadécimales,
- auront été remplacées par le caractère
- ASCII correspondant. Par exemple, la chaîne
+ <function>rawurldecode</function> retourne une chaîne dont les
+ séquences de caractères %xy, avec xy deux valeurs
+ hexadécimales, auront été remplacées
+ par le caractère ASCII correspondant. Par exemple, la chaî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îne dont tous les caractères
- non-alpha-numériques (hormis <screen>-_.</screen>.)
- auront été remplacés par des séquences %xy
+ <function>rawurlencode</function> retourne une chaîne dont tous
+ les caractères non-alpha-numériques
+ (hormis <screen>-_.</screen>) auront été remplacés
+ par des séquences <literal>%xy</literal>
(<literal>%</literal>), avec xy deux valeurs hexadécimales.
Ce codage est conforme à la RFC1738 qui évite que les
caractères spéciaux soient interprétés
@@ -129,16 +130,18 @@
<example>
<title>Exemple avec <function>rawurlencode</function></title>
<programlisting role="php">
-echo '<A HREF="ftp://user:', rawurlencode ('foo @+%/'),
- '@ftp.my.com/x.txt">';
+<?php
+echo '<A HREF="ftp://user:', rawurlencode ('foo @+%/'), '@ftp.my.com/x.txt">';
+?>
</programlisting>
</example>
Ou, si vous transmettez un chemin dans une URL
<example>
<title>Exemple avec <function>rawurlencode</function></title>
<programlisting role="php">
-echo '<A HREF="http://x.com/department_list_script/',
- rawurlencode ('sales et marketing/Miami'), '">';
+<?php
+echo '<A HREF="http://x.com/department_list_script/', rawurlencode ('sales et
+marketing/Miami'), '">';
+?>
</programlisting>
</example>
</para>
@@ -162,10 +165,9 @@
</funcprototype>
</funcsynopsis>
<para>
- Décode toutes les séquences
- <literal>%<replaceable>##</replaceable></literal> et
- les remplace par leur valeur. La chaîne ainsi
- décodée est retournée.
+ <function>urldecode</function> décode toutes les séquences
+ <literal>%<replaceable>##</replaceable></literal> et les remplace par
+ leur valeur. La chaîne ainsi décodée est retournée.
<example>
<title>Exemple avec <function>urldecode</function></title>
<programlisting role="php">
@@ -202,22 +204,22 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne une chaîne dont les caractères
- non alpha-numériques (hormis <literal>-_.</literal>)
- sont remplacés par des séquences commencant
- par un caractère pourcentage (<literal>%</literal>),
- suivi de deux chiffres hexadécimaux. Les espaces sont
- remplacés par des signes plus (<literal>+</literal>).
- Ce codage est celui qui est utilisé pour poster des
- informations dans les formulaires HTML. Le type MIME est
- <literal>application/x-www-form-urlencoded</literal>.
- Ce codage est différent de celui spécifié
- dans la RFC1738 (voir <function>rawurlencode</function>) : pour
- des raisons historiques, les espaces sont remplacé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 à l'autre.
+ <function>urlencode</function> retourne une chaîne dont les
+ caractères non alpha-numériques (hormis <literal>-_.</literal>)
+ sont remplacés par des séquences commencant
+ par un caractère pourcentage (<literal>%</literal>),
+ suivi de deux chiffres hexadécimaux. Les espaces sont
+ remplacés par des signes plus (<literal>+</literal>).
+ Ce codage est celui qui est utilisé pour poster des
+ informations dans les formulaires HTML. Le type MIME est
+ <literal>application/x-www-form-urlencoded</literal>.
+ Ce codage est différent de celui spécifié
+ dans la RFC1738 (voir <function>rawurlencode</function>) : pour
+ des raisons historiques, les espaces sont remplacé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 à l'autre.
<example>
<title>Exemple avec <function>urlencode</function></title>
<programlisting role="php">
@@ -246,7 +248,7 @@
à la place de <literal>&</literal> comme
séparateur. Vous n'avez alors pas à changer la directive
arg_separator. Laissez la à &, 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
- écrire et lire des fichier bzip2 (.bz2) de manière transparente.
- </para>
- <para>
- Le support <acronym>bzip2</acronym> par PHP n'est pas activé par
- dé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 >= 1.0.x.
- </para>
- <sect1 id="bzip2-example">
- <title>Exemple de compression bzip2</title>
- <para>
- Cet exemple ouvre un fichier temporaire, et écrit une ligne de test,
- puis il en affiche le contenu.
- </para>
- <example>
- <title>Exemple avec bzip2</title>
- <programlisting role="php">
-<?php
-
-$filename = "/tmp/fichier_de_test.bz2";
-$str = "Ceci est une chaîne de test.\n";
-
-// ouvre le fichier en écriture
-$bz = bzopen($filename, "w");
-
-// écrit une chaîne dans le fichier
-bzwrite($bz, $str);
-
-// ferme le fichier
-bzclose($bz);
-
-// ouvre le fichier en lecture
-$bz = bzopen($filename, "r");
-
-// lit 10 caractères
-print bzread($bz, 10);
-
-// affiche tout le reste du fichier, puis le ferme
-print bzread($bz);
-
-bzclose($bz);
-
-?>
- </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ésenté par le pointeur <parameter>bz</parameter>.
- </para>
- <para>
- <function>bzclose</function> retourne <literal>TRUE</literal>
- en cas de succès, et <literal>FALSE</literal> sinon.
- </para>
- <para>
- Le pointeur de fichier <parameter>bz</parameter> doit être
- valide, et avoir été 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î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îne
- <parameter>source</parameter> et retourne les données
- ainsi encodée.
- </para>
- <para>
- Le paramètre optionnel <parameter>blocksize</parameter> spécifie
- la taille de bloc utilisé durant la compression, et doit être un
- nombre de 1 à 9, sachant que 9 représente la meilleure compression,
- mais qu'elle utilise plus de ressource pour ce faire.
- <parameter>blocksize</parameter> vaut par défaut 4.
- </para>
- <para>
- Le paramètre optionnel <parameter>workfactor</parameter> contrôle
- le comportement de la compression dans les pires cas de données
- hautement répétitives. Cette valeur peut aller de 0 à 250 (0
- est une valeur spéciale, et 30 la valeur par défaut). En dehors
- de <parameter>workfactor</parameter>, le résultat sera le même.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>bzcompress</function></title>
- <programlisting role="php">
-<?php
-$str = "données de test";
-$bzstr = bzcompress($str, 9);
-?>
- </programlisting>
- </example>
- </para>
- <para>
- Voir aussi <function>bzdecompress</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.bzdecompress">
- <refnamediv>
- <refname>bzdecompress</refname>
- <refpurpose>Décompresse une chaî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écompresse la chaîne
- <parameter>source</parameter>, en supposant qu'elle a été
- compressée avec bzip2, puis la retourne. Si le paramètre
- optionnel <parameter>small</parameter> vaut <literal>TRUE</literal>,
- un autre algorithme de décompression sera utilisé : il consomme
- moins de mémoire (le maximum demandé tombe autour de
- 2300 ko), mais fonctionne globalement à la moitié de
- la vitesse. Reportez-vous à la
- <ulink url="&url.bzip2;">documentation bzip2</ulink> pour plus de
- détails sur cette fonctionnalité.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>bzdecompress</function></title>
- <programlisting role="php">
-<?php
-$str = $bzdecompress($bzstr);
-?>
- </programlisting>
- </example>
- </para>
- <para>
- Voir aussi <function>bzcompress</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.bzerrno">
- <refnamediv>
- <refname>bzerrno</refname>
- <refpurpose>Retourne le numé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éro d'erreur
- du fichier bz2 représenté 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é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éro et le message d'erreur
- du fichier bz2 représenté 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">
-<?php
-$error = bzerror($bz);
-
-echo $error["errno"];
-echo $error["errstr"];
-?>
- </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ésenté 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'écriture de toutes les données compressé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'écriture du
- fichier représenté par <parameter>bz</parameter>.
- </para>
- <para>
- <function>bzflush</function> retourne <literal>TRUE</literal>
- en cas de succè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é 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 écriture ou en lecture. <parameter>filename</parameter>
- est le nom du fichier à ouvrir. <parameter>mode</parameter>
- est similaire au même paramètre de la fonction
<function>fopen</function>
- (`r' pour lecture, `w' pour écriture, etc.).
- </para>
- <para>
- Si l'ouverture é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">
-<?php
-$bz = bzopen("/tmp/foo.bz2", "r");
-?>
- </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'à <parameter>length</parameter>
- octets depuis le fichier bzip2, référencé par le pointeur
- <parameter>bz</parameter>. La lecture s'arrête lorsque
- <parameter>length</parameter> octets (non compressés)
- ont été lus, qu'une erreur est rencontrée,
- ou bien que la fin du fichier a été atteinte :
- le premier des trois qui survient. Si le paramètre
- optionnel <parameter>length</parameter> est omis,
- <function>bzread</function> lit 1024 octets (non compressés) en
- même temps.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>bzread</function></title>
- <programlisting role="php">
-<?php
-$bz = bzopen("/tmp/foo.bz2", "r");
-$str = bzread($bz, 2048);
-echo $str;
-?>
- </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> écrit le contenu de la chaîne
- <parameter>data</parameter> dans le fichier bzip2 représenté
- par <parameter>bz</parameter>. Si le paramètre optionnel
- <parameter>length</parameter> est fourni, l'écriture sera
arrêtée
- après l'écriture de <parameter>length</parameter>
- octets (non compressés), ou la fin de la chaîne
- (le premier qui survient).
- </para>
- <para>
- <example>
- <title>Exemple <function>bzwrite</function></title>
- <programlisting role="php">
-<?php
-$str = "données non compressées";
-$bz = bzopen("/tmp/foo.bz2", "w");
-bzwrite($bz, $str, strlen($str));
-?>
- </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 écrire et lire des fichier bzip2 (.bz2) de manière
+transparente. </para> <para> Le support <acronym>bzip2</acronym> par PHP n'est
+pas activé par dé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 >= 1.0.x. </para> <sect1 id="bzip2-example">
+<title>Exemple de compression bzip2</title> <para> Cet exemple ouvre un
+fichier temporaire, et écrit une ligne de test, puis il en affiche le
+contenu. </para> <example> <title>Exemple avec bzip2</title>
+<programlisting role="php"><?php$filename = "/tmp/fichier_de_test.bz2";$str =
+"Ceci est une chaîne de test.\n";// ouvre le fichier en écriture$bz =
+bzopen($filename, "w");// écrit une chaîne dans le fichierbzwrite($bz,
+$str);// ferme le fichierbzclose($bz);// ouvre le fichier en lecture$bz =
+bzopen($filename, "r");// lit 10 caractèresprint bzread($bz, 10);// affiche
+tout le reste du fichier, puis le fermeprint bzread($bz);bzclose($bz);?>
+</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ésenté par le pointeur <parameter>bz</parameter>. </para>
+<para> <function>bzclose</function> retourne <literal>TRUE</literal> en cas
+de succès, et <literal>FALSE</literal> sinon. </para> <para> Le
+pointeur de fichier <parameter>bz</parameter> doit être valide, et avoir
+été 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î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îne
+<parameter>source</parameter> et retourne les données ainsi
+encodée. </para> <para> Le paramètre optionnel
+<parameter>blocksize</parameter> spécifie la taille de bloc utilisé
+durant la compression, et doit être un nombre de 1 à 9, sachant que
+9 représente la meilleure compression, mais qu'elle utilise plus de
+ressource pour ce faire. <parameter>blocksize</parameter> vaut par défaut
+4. </para> <para> Le paramètre optionnel
+<parameter>workfactor</parameter> contrôle le comportement de la
+compression dans les pires cas de données hautement
+répétitives. Cette valeur peut aller de 0 à 250 (0 est une
+valeur spéciale, et 30 la valeur par défaut). En dehors de
+<parameter>workfactor</parameter>, le résultat sera le même. </para>
+ <para> <example> <title>Exemple avec
+<function>bzcompress</function></title> <programlisting role="php"><?php$str
+= "données de test";$bzstr = bzcompress($str, 9);?> </programlisting>
+ </example> </para> <para> Voir aussi <function>bzdecompress</function>.
+ </para> </refsect1> </refentry> <refentry id="function.bzdecompress">
+<refnamediv> <refname>bzdecompress</refname> <refpurpose>Décompresse une
+chaî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écompresse la chaîne <parameter>source</parameter>, en supposant
+qu'elle a été compressée avec bzip2, puis la retourne. Si le
+paramètre optionnel <parameter>small</parameter> vaut
+<literal>TRUE</literal>, un autre algorithme de décompression sera
+utilisé : il consomme moins de mémoire (le maximum demandé
+tombe autour de 2300 ko), mais fonctionne globalement à la moitié
+de la vitesse. Reportez-vous à la <ulink
+url="&url.bzip2;">documentation bzip2</ulink> pour plus de détails sur
+cette fonctionnalité. </para> <para> <example> <title>Exemple
+avec <function>bzdecompress</function></title> <programlisting
+role="php"><?php$str = $bzdecompress($bzstr);?> </programlisting>
+</example> </para> <para> Voir aussi <function>bzcompress</function>.
+</para> </refsect1> </refentry> <refentry id="function.bzerrno"> <refnamediv>
+ <refname>bzerrno</refname> <refpurpose>Retourne le numé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éro d'erreur du
+fichier bz2 représenté 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é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éro et le message
+d'erreur du fichier bz2 représenté 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"><?php$error =
+bzerror($bz);echo $error["errno"];echo $error["errstr"];?> </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ésenté 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'écriture de toutes les données compressé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'écriture du
+fichier représenté par <parameter>bz</parameter>. </para> <para>
+ <function>bzflush</function> retourne <literal>TRUE</literal> en cas de
+succè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é 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
+écriture ou en lecture. <parameter>filename</parameter> est le nom du
+fichier à ouvrir. <parameter>mode</parameter> est similaire au même
+paramètre de la fonction <function>fopen</function> (`r' pour lecture, `w'
+pour écriture, etc.). </para> <para> Si l'ouverture é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"><?php$bz = bzopen("/tmp/foo.bz2", "r");?> </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'à <parameter>length</parameter> octets depuis le fichier bzip2,
+référencé par le pointeur <parameter>bz</parameter>. La
+lecture s'arrête lorsque <parameter>length</parameter> octets (non
+compressés) ont été lus, qu'une erreur est
+rencontrée, ou bien que la fin du fichier a été atteinte :
+ le premier des trois qui survient. Si le paramètre optionnel
+<parameter>length</parameter> est omis, <function>bzread</function> lit 1024
+octets (non compressés) en même temps. </para> <para>
+<example> <title>Exemple avec <function>bzread</function></title>
+<programlisting role="php"><?php$bz = bzopen("/tmp/foo.bz2", "r");$str =
+bzread($bz, 2048);echo $str;?> </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>
+écrit le contenu de la chaîne <parameter>data</parameter> dans le
+fichier bzip2 représenté par <parameter>bz</parameter>. Si le
+paramètre optionnel <parameter>length</parameter> est fourni,
+l'écriture sera arrêtée après l'écriture de
+<parameter>length</parameter> octets (non compressés), ou la fin de la
+chaîne (le premier qui survient). </para> <para> <example>
+<title>Exemple <function>bzwrite</function></title> <programlisting
+role="php"><?php$str = "données non compressées";$bz =
+bzopen("/tmp/foo.bz2", "w");bzwrite($bz, $str, strlen($str));?>
+</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
