dams Mon Mar 12 04:14:01 2001 EDT
Modified files:
/phpdoc/fr/functions bzip2.xml datetime.xml recode.xml regex.xml
strings.xml aspell.xml
Log:
Corrected mis-named functions.
Prepared aspell/bzip for ressources' appendix
Added latest updates
Index: phpdoc/fr/functions/bzip2.xml
diff -u phpdoc/fr/functions/bzip2.xml:1.6 phpdoc/fr/functions/bzip2.xml:1.7
--- phpdoc/fr/functions/bzip2.xml:1.6 Tue Feb 27 03:58:13 2001
+++ phpdoc/fr/functions/bzip2.xml Mon Mar 12 04:14:00 2001
@@ -1 +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
<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> et <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
+ <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>ressource
+<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>ressource
+<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>ressource
+<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>ressource
+<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>ressource
+<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>ressource
+<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>ressource
+<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> et <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
Index: phpdoc/fr/functions/datetime.xml
diff -u phpdoc/fr/functions/datetime.xml:1.15 phpdoc/fr/functions/datetime.xml:1.16
--- phpdoc/fr/functions/datetime.xml:1.15 Wed Mar 7 10:08:43 2001
+++ phpdoc/fr/functions/datetime.xml Mon Mar 12 04:14:00 2001
@@ -181,7 +181,7 @@
<listitem>
<simpara>
S - Suffixe ordinal d'un nombre, en anglais, sur deux lettres :
- i.e. "th", "nd"
+ i.e. "th", "nd"
</simpara>
</listitem>
<listitem>
@@ -237,12 +237,12 @@
</example>
</para>
<para>
- Il est possible d'utiliser <function>date</function> et
- <function>mktime</function> ensemble pour générer
- des dates dans futur ou dans passé.
+ Il est possible d'utiliser <function>date</function> et
+ <function>mktime</function> ensemble pour générer
+ des dates dans futur ou dans passé.
<example>
<title>
- Exemples avec <function>date</function> et <function>mktime</function>
+ Exemples avec <function>date</function> et <function>mktime</function>
</title>
<programlisting role="php">
<?php
@@ -254,10 +254,42 @@
</example>
</para>
<para>
- Pour formater des dates dans d'autres langues, utilisez les fonctions
- <function>setlocale</function> et <function>strftime</function>.
+ Voici maintenant quelques exemples de formattages avec
+ <function>date</function>. Notez que vous devriez �chapper tous
+ les autres caract�res, car s'ils ont une signification
+ sp�ciale, ils risquent de produire des effets secondaires
+ ind�sirables. Notez aussi que les versions futures de PHP
+ peuvent attribuer une signification � des lettres qui sont
+ actuellement inertes. Lorsque vous �chappez les caract�res,
+ pensez � utiiser des guillemets simples, pour que les
+ s�quences <literal>\n</literal> ne deviennent pas des
+ nouvelles lignes.
+ <example>
+ <title>Formattage avec <function>date</function></title>
+ <programlisting role="php">
+<?php
+/* Aujourd'hui, le 12 Mars 2001, 10:16:18 pm */
+$today = date("F j, Y, g:i a"); // March 12, 2001, 10:16 pm
+$today = date("m.d.y"); // 03.12.01
+$today = date("j, g, Y"); // 12, 3, 2001
+$today = date("Ymd"); // 20010312
+$today = date('h-i-s, j-m-y, it is w Day z '); // 05-16-17, 12-03-01, 1631 1618 6
+Monpm01
+$today = date('\C\'\e\s\t\ \l\e\ jS \j\o\u\r\.'); // C'est le 12th jour.
+$today = date("D M j g:i:s T Y"); // Mon Mar 12 15:16:08 MST 2001
+$today = date('H:m:s \m \e\s\t\ \l\e\ \m\o\i\s'); // 17:03:18 m est le mois
+$today = date("H:i:s"); // 10:16:18
+// notation fran�aise
+$today = date("d/m/y"); // 12/03/01
+$today = date("d/m/Y"); // 12/03/2001
+?>
+ </programlisting>
+ </example>
</para>
<para>
+ Pour formater des dates dans d'autres langues, utilisez les fonctions
+ <function>setlocale</function> et <function>strftime</function>.
+ </para>
+ <para>
Voir aussi <function>gmdate</function> et <function>mktime</function>.
</para>
</refsect1>
@@ -334,6 +366,18 @@
</listitem>
</itemizedlist>
</para>
+ <example>
+ <title>Exemple avec <function>getdate</function></title>
+ <programlisting role="php">
+<?php
+$aujourdhui = getdate();
+$mois = $today[month];
+$mjour = $today[mday];
+$annee = $today[year];
+echo "$mjour/$mois/$annee";
+?>
+ </programlisting>
+ </example>
</refsect1>
</refentry>
<refentry id="function.gettimeofday">
@@ -447,7 +491,7 @@
<refnamediv>
<refname>gmstrftime</refname>
<refpurpose>
- Formate une date/heure GMT/CUT en fonction des paramétrages locaux.
+ Formate une date/heure GMT/CUT en fonction des paramétrages locaux.
</refpurpose>
</refnamediv>
<refsect1>
@@ -471,14 +515,16 @@
<example>
<title>Exemple avec <function>gmstrftime</function></title>
<programlisting role="php">
+<?php
setlocale ('LC_TIME', 'en_US');
echo strftime ("%b %d %Y %H:%M:%S", mktime (20,0,0,12,31,98))."\n";
echo gmstrftime ("%b %d %Y %H:%M:%S", mktime (20,0,0,12,31,98))."\n";
+?>
</programlisting>
</example>
</para>
<para>
- Voir aussi <function>strftime</function>.
+ Voir aussi <function>strftime</function>.
</para>
</refsect1>
</refentry>
@@ -569,7 +615,7 @@
<refnamediv>
<refname>microtime</refname>
<refpurpose>
- Retourne le timestamp UNIX actuel avec microsecondes.
+ Retourne le timestamp UNIX actuel avec microsecondes.
</refpurpose>
</refnamediv>
<refsect1>
@@ -580,13 +626,38 @@
<paramdef>void</paramdef>
</funcprototype>
</funcsynopsis>
+ <para>
+ <function>microtime</function> retourne la chaîne "msec sec"
+ avec sec qui est mesurée en secondes depuis le début
+ de l'époque UNIX, (1er janvier 1970 00:00:00 GMT), et msec
+ qui est le nombre de microsecondes de cette heure. Cette fonction
+ est seulement disponible sur les systèmes d'exploitation qui
+ supportent la fonction syst�me gettimeofday().
+ </para>
<para>
- <function>microtime</function> retourne la chaîne "msec sec"
- avec sec qui est mesurée en secondes depuis le début
- de l'époque UNIX, (1er janvier 1970 00:00:00 GMT), et msec
- qui est le nombre de microsecondes de cette heure. Cette fonction
- est seulement disponible sur les systèmes d'exploitation qui
- supportent la fonction <function>gettimeofday</function>.
+ Les deux parties de la cha�ne sont exprim�es en secondes.
+ <example>
+ <title>Exemple avec <function>microtime</function></title>
+ <programlisting role="php">
+<?php
+function getmicrotime(){
+ list($sec, $usec) = explode(" ",microtime());
+ return ($sec + $usec);
+}
+
+$time_start = getmicrotime();
+
+for ($i=0; $i < 1000; $i++){
+ //ne rien faire, pendant un millier de fois...
+}
+
+$time_end = getmicrotime();
+$time = $time_end - $time_start;
+
+echo "Rien fait durant $time secondes";
+?>
+ </programlisting>
+ </example>
</para>
<para>
Voir aussi <function>time</function>.
@@ -597,7 +668,7 @@
<refnamediv>
<refname>mktime</refname>
<refpurpose>
- Retourne le timestamp UNIX d'une date.
+ Retourne le timestamp UNIX d'une date.
</refpurpose>
</refnamediv>
<refsect1>
@@ -617,32 +688,32 @@
</funcprototype>
</funcsynopsis>
<para>
- <emphasis>ATTENTION</emphasis> : l'ordre des arguments est
- différent de celui de la commande UNIX habituelle mktime(),
- et fournit des résultats aléatoires si on oublie cet
- ordre. C'est une erreur très commune que de se tromper de sens.
+ <emphasis>ATTENTION</emphasis> : l'ordre des arguments est
+ différent de celui de la commande UNIX habituelle mktime(),
+ et fournit des résultats aléatoires si on oublie cet
+ ordre. C'est une erreur très commune que de se tromper de sens.
</para>
<para>
- <function>mktime</function> retourne un timestamp UNIX
- correspondant aux arguments fournis. Ce timestamp est un
- entier long, contenant le nombre de secondes entre le début
- de l'époque UNIX (1er Janvier 1970) et le temps
- spécifié.
+ <function>mktime</function> retourne un timestamp UNIX
+ correspondant aux arguments fournis. Ce timestamp est un
+ entier long, contenant le nombre de secondes entre le début
+ de l'époque UNIX (1er Janvier 1970) et le temps
+ spécifié.
</para>
<para>
- Les arguments peuvent être omis, de gauche à droite,
- et tous les arguments manquants sont utilisés avec la valeur
- courante de l'heure et du jour.
+ Les arguments peuvent être omis, de gauche à droite,
+ et tous les arguments manquants sont utilisés avec la valeur
+ courante de l'heure et du jour.
</para>
<para>
- <parameter>is_dst</parameter> peut être mis à 1 si
- l'heure d'hiver est appliquée, 0 si elle ne l'est pas, et -1
- (par défaut) si on ne sait pas.
+ <parameter>is_dst</parameter> peut être mis à 1 si
+ l'heure d'hiver est appliquée, 0 si elle ne l'est pas, et -1
+ (par défaut) si on ne sait pas.
</para>
<note>
<para>
- <parameter>is_dst</parameter> a été ajouté
- à partir de la version 3.0.10.
+ <parameter>is_dst</parameter> a été ajouté
+ à partir de la version 3.0.10.
</para>
</note>
<para>
Index: phpdoc/fr/functions/recode.xml
diff -u phpdoc/fr/functions/recode.xml:1.7 phpdoc/fr/functions/recode.xml:1.8
--- phpdoc/fr/functions/recode.xml:1.7 Thu Mar 8 02:52:10 2001
+++ phpdoc/fr/functions/recode.xml Mon Mar 12 04:14:00 2001
@@ -71,9 +71,9 @@
</funcsynopsis>
<note>
<simpara>
- <function>recode_string</function> est un alias de
- <function>recode</function>. Elle a été ajoutée dans
- PHP 4.
+ <function>recode</function> est un alias de
+ <function>recode_string</function>. Elle a été
+ ajoutée en PHP 4.
</simpara>
</note>
</refsect1>
Index: phpdoc/fr/functions/regex.xml
diff -u phpdoc/fr/functions/regex.xml:1.8 phpdoc/fr/functions/regex.xml:1.9
--- phpdoc/fr/functions/regex.xml:1.8 Thu Mar 8 02:52:10 2001
+++ phpdoc/fr/functions/regex.xml Mon Mar 12 04:14:00 2001
@@ -383,7 +383,7 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>spliti</function> est identique à <function>spliti</function>,
+ <function>spliti</function> est identique à <function>split</function>,
hormis le fait qu'elle ignore la casse.
</para>
<para>
Index: phpdoc/fr/functions/strings.xml
diff -u phpdoc/fr/functions/strings.xml:1.30 phpdoc/fr/functions/strings.xml:1.31
--- phpdoc/fr/functions/strings.xml:1.30 Mon Feb 26 03:10:50 2001
+++ phpdoc/fr/functions/strings.xml Mon Mar 12 04:14:00 2001
@@ -20,7 +20,7 @@
<refnamediv>
<refname>AddCSlashes</refname>
<refpurpose>
- Ajoute des slashes dans une chaîne, comme en langage C.
+ Ajoute des slashes dans une chaîne, comme en langage C.
</refpurpose>
</refnamediv>
<refsect1>
@@ -1088,9 +1088,10 @@
utilisé par le serveur.
</para>
<para>
- <function>localeconv</function> retourne les informations à partir
- des données locales, comme définies par
<function>setlocale</function>.
- Le tableau associatif retourné contient les entrées suivantes :
+ <function>localeconv</function> retourne les informations à
+ partir des données locales, comme définies par
+ <function>setlocale</function>. Le tableau associatif retourné
+ contient les entrées suivantes :
<informaltable >
<tgroup cols="2">
<thead>
@@ -1218,6 +1219,7 @@
<example>
<title>Exemple avec <function>localeconv</function></title>
<programlisting role="php">
+<?php
setlocale(LC_ALL, "en_US");
$locale_info = localeconv();
echo "<PRE>\n";
@@ -1239,6 +1241,7 @@
echo "p_sign_posn: {$locale_info["p_sign_posn"]}\n";
echo "n_sign_posn: {$locale_info["n_sign_posn"]}\n";
echo "</PRE>\n";
+?>
</programlisting>
</example>
<para>
@@ -1643,35 +1646,35 @@
<funcsynopsis>
<funcprototype>
<funcdef>string <function>setlocale</function></funcdef>
- <paramdef>string <parameter>category</parameter></paramdef>
+ <paramdef>mixed <parameter>category</parameter></paramdef>
<paramdef>string <parameter>locale</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- <parameter>category</parameter> est une chaîne qui
- spécifie la catégorie de fonction qui va être
- affectée par les informations locales :
+ <parameter>category</parameter> est une chaîne ou une
+ constante qui spécifie la catégorie de fonction
+ qui va être affectée par les informations locales :
<itemizedlist>
<listitem>
<simpara>
- LC_ALL Toutes les fonctions ci-dessous
+ LC_ALL : toutes les fonctions ci-dessous
</simpara>
</listitem>
<listitem>
<simpara>
- LC_COLLATE pour les comparaisons de chaîne
+ LC_COLLATE : pour les comparaisons de chaînes
(voir <function>strcoll</function>)
</simpara>
</listitem>
<listitem>
<simpara>
- LC_CTYPE pour la classification de caractères et les conversions,
+ LC_CTYPE : pour la classification de caractères et les conversions,
par exemple <function>strtoupper</function>
</simpara>
</listitem>
<listitem>
<simpara>
- LC_MONETARY pour localeconv() - (en cours d'implémentation)
+ LC_MONETARY : pour localeconv() - (en cours d'implémentation)
</simpara>
</listitem>
<listitem>
Index: phpdoc/fr/functions/aspell.xml
diff -u phpdoc/fr/functions/aspell.xml:1.7 phpdoc/fr/functions/aspell.xml:1.8
--- phpdoc/fr/functions/aspell.xml:1.7 Tue Jan 16 02:38:37 2001
+++ phpdoc/fr/functions/aspell.xml Mon Mar 12 04:14:00 2001
@@ -18,9 +18,9 @@
nouvelles versions de Aspell.
</simpara>
</note>
- <simpara>
- Vous avez besoin de la librairie Aspell, disponible à :
- <ulink
url="http://aspell.sourceforge.net/">http://aspell.sourceforge.net/</ulink>.
+ <simpara>
+ Vous avez besoin de la librairie Aspell, disponible à :
+ <ulink
+url="http://aspell.sourceforge.net/">http://aspell.sourceforge.net/</ulink>.
</simpara>
</partintro>
<refentry id="function.aspell-new">
@@ -32,7 +32,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>int <function>aspell_new</function></funcdef>
+ <funcdef>ressource <function>aspell_new</function></funcdef>
<paramdef>string <parameter>master</parameter></paramdef>
<paramdef>string <parameter>personal</parameter></paramdef>
</funcprototype>
@@ -44,7 +44,7 @@
</simpara>
<para>
<example>
- <title>aspell_new</title>
+ <title>Exemple avec <function>aspell_new</function></title>
<programlisting role="php">
<?php
$aspell_link=aspell_new("english");
@@ -64,16 +64,18 @@
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>aspell_check</function></funcdef>
- <paramdef>int <parameter>dictionary_link</parameter></paramdef>
+ <paramdef>ressource <parameter>dictionary_link</parameter></paramdef>
<paramdef>string <parameter>word</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
- <function>aspell_check</function> vérifie l'orthographe d'un mot et
retourne <literal>TRUE</literal> si l'orthographe est correcte, et
<literal>FALSE</literal> sinon.
+ <function>aspell_check</function> vérifie l'orthographe d'un mot
+ et retourne <literal>TRUE</literal> si l'orthographe est correcte,
+ et <literal>FALSE</literal> sinon.
</simpara>
<para>
<example>
- <title>aspell_check</title>
+ <title>Exemple avec <function>aspell_check</function></title>
<programlisting role="php">
<?php
$aspell_link=aspell_new("english");
@@ -90,10 +92,10 @@
</refentry>
<refentry id="function.aspell-check-raw">
<refnamediv>
- <refname>aspell_check-raw</refname>
+ <refname>aspell_check_raw</refname>
<refpurpose>
- Vérifie un mot sans en changer la casse et sans essayer de supprimer
- les espaces aux extrémités.
+ Vérifie un mot sans en changer la casse et sans essayer de supprimer
+ les espaces aux extrémités.
</refpurpose>
</refnamediv>
<refsect1>
@@ -101,19 +103,19 @@
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>aspell_check_raw</function></funcdef>
- <paramdef>int <parameter>dictionary_link</parameter></paramdef>
+ <paramdef>ressource <parameter>dictionary_link</parameter></paramdef>
<paramdef>string <parameter>word</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
<function>aspell_check_raw</function> vérifie l'orthographe
d'un mot sans en changer la casse, et sans essayer de supprimer les
- espaces aux extrémités. Elle retourne <literal>TRUE</literal> si
l'orthographe
- est bonne, et <literal>FALSE</literal> sinon.
- </simpara>
+ espaces aux extrémités. Elle retourne <literal>TRUE</literal>
+ si l'orthographe est bonne, et <literal>FALSE</literal> sinon.
+ </simpara>
<para>
<example>
- <title>aspell_check_raw</title>
+ <title>Exemple avec <function>aspell_check_raw</function></title>
<programlisting role="php">
<?php
$aspell_link=aspell_new("french");
@@ -138,7 +140,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>array <function>aspell_suggest</function></funcdef>
- <paramdef>int <parameter>dictionary_link</parameter></paramdef>
+ <paramdef>ressource <parameter>dictionary_link</parameter></paramdef>
<paramdef>string <parameter>word</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -148,7 +150,7 @@
</simpara>
<para>
<example>
- <title>aspell_suggest</title>
+ <title>Exemple avec <function>aspell_suggest</function></title>
<programlisting role="php">
<?php
$aspell_link=aspell_new("french");