cvs: phpdoc-fr /chapters streams.common.xml

From: Date: Mon, 03 Feb 2003 04:11:11 +0000
Subject: cvs: phpdoc-fr /chapters streams.common.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-187@lists.php.net to get a copy of this message
nicos Sun Feb 2 23:11:11 2003 EDT Modified files: /phpdoc-fr/chapters streams.common.xml Log: fixing traduction + SGML characters + some unusefull things

Index: phpdoc-fr/chapters/streams.common.xml diff -u phpdoc-fr/chapters/streams.common.xml:1.1 phpdoc-fr/chapters/streams.common.xml:1.2 --- phpdoc-fr/chapters/streams.common.xml:1.1 Thu Jan 30 08:44:44 2003 +++ phpdoc-fr/chapters/streams.common.xml Sun Feb 2 23:11:11 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- Author: Wez Furlong <wez@thebrainroom.com> Please contact me before making any major amendments to the content of this section. Splitting/Merging are fine if they are @@ -72,12 +72,13 @@ </methodsynopsis> <para> <function>php_stream_open_wrapper</function> ouvre un fichier, une URL ou - n'importe quelle ressource g&eacute;r&eacute;, sp&eacute;cifi&eacute;e par <parameter>path</parameter>. + n'importe quelle ressource g&eacute;r&eacute;, sp&eacute;cifi&eacute;e par + <parameter>path</parameter>. Suivant la valeur de <parameter>mode</parameter>, le fl&ocirc;t peut &ecirc;tre ouvert en lecture, &eacute;criture, ajout ou une combinaison des trois. Voyez la table ci-dessous pour conna&icirc;tres les modes utilis&eacute;es. De plus vous pouvez - aussi int&eacute;grer le caract&egrave;re 'b' comme deuxi&egrave;me ou derni&egrave;re option. Sa - pr&eacute;sence indiquera que le fl&ocirc;t fonctionnera en mode binaire. + aussi int&eacute;grer le caract&egrave;re 'b' comme deuxi&egrave;me ou derni&egrave;re option. + Sa pr&eacute;sence indiquera que le fl&ocirc;t fonctionnera en mode binaire. </para> <para> L'option 'b' est ignor&eacute;e sur les syst&egrave;mes POSIX, qui traitent les @@ -164,8 +165,9 @@ </term> <listitem> <simpara> - Ouvre le fichier en mode d'&eacute;criture et lecture. Le fichier est cr&eacute;&eacute; si il n'existe - pas. Le pointeur de fl&ocirc;t est positionn&eacute; &agrave; la fin du fichier. + Ouvre le fichier en mode d'&eacute;criture et lecture. Le fichier est cr&eacute;&eacute; + si il n'existe pas. Le pointeur de fl&ocirc;t est positionn&eacute; &agrave; la fin du + fichier. </simpara> </listitem> </varlistentry> @@ -180,18 +182,20 @@ </para> <para> Si <parameter>opened</parameter> est non NULL, il sera assign&eacute; avec le nom - du fichier ou de la ressource qui aura &eacute;t&eacute; r&eacute;ellement ouverte. C'est important lorsque - l'option inclus <constant>USE_PATH</constant>, qui permet de fouiller l'include_path - pour rechercher le fichier. Vous, l'appelant, &ecirc;tes responsable de l'appel de - <function>efree</function> sur le nom de fichier retourn&eacute; par ce param&egrave;tre. + du fichier ou de la ressource qui aura &eacute;t&eacute; r&eacute;ellement ouverte. + C'est important lorsque l'option inclus <constant>USE_PATH</constant>, qui permet de fouiller + l'include_path pour rechercher le fichier. Vous, l'appelant, &ecirc;tes responsable de + l'appel de <function>efree</function> sur le nom de fichier retourn&eacute; par ce + param&egrave;tre. </para> <note> <simpara> - Si vous avez sp&eacute;cifi&eacute; l'option <constant>STREAM_MUST_SEEK</constant> dans <parameter>options</parameter>, - le chemin retourn&eacute; dans <parameter>opened</parameter> peut ne pas &ecirc;tre le m&ecirc;me - que celui qui vous a &eacute;t&eacute; r&eacute;ellemetn retourn&eacute;. Toutes fois, ce sera le nom - de la ressource originale &agrave; partir de laquelle un fl&ocirc;t &agrave; pointeur variable - a &eacute;t&eacute; cr&eacute;&eacute;. + Si vous avez sp&eacute;cifi&eacute; l'option <constant>STREAM_MUST_SEEK</constant> dans + <parameter>options</parameter>, le chemin retourn&eacute; dans <parameter>opened</parameter> + peut ne pas &ecirc;tre le m&ecirc;me que celui qui vous a &eacute;t&eacute; + r&eacute;ellemetn retourn&eacute;. Toutes fois, ce sera le nom de la ressource originale + &agrave; partir de laquelle un fl&ocirc;t &agrave; pointeur variable a &eacute;t&eacute; + cr&eacute;&eacute;. </simpara> </note> </refsect1> @@ -223,14 +227,14 @@ </para> <para> Le pointeur de position dans le fl&ocirc;t est avanc&eacute; d'autant d'octets que le nombre - qui en a &eacute;t&eacute; lu. Par cons&eacute;quent, la prochaine lecture reprendra l&agrave; ou la - lecture pr&eacute;c&eacute;dente s'est arr&ecirc;t&eacute;e. + qui en a &eacute;t&eacute; lu. Par cons&eacute;quent, la prochaine lecture reprendra l&agrave; + ou la lecture pr&eacute;c&eacute;dente s'est arr&ecirc;t&eacute;e. </para> <para> Si moins de <parameter>count</parameter> octets ont &eacute;t&eacute; lus, cet appel bloquera l'application jusqu'&agrave; ce que le nombre d'octets n&eacute;cessaire soit atteint, en fonction - de la configuration du fl&ocirc;t (bloquant, non bloquant). Par d&eacute;faut, un fl&ocirc;t est ouvert - en mode bloquant. Lorsque vous lisez dans des fichiers classiques, le mode bloquant + de la configuration du fl&ocirc;t (bloquant, non bloquant). Par d&eacute;faut, un fl&ocirc;t est + ouvert en mode bloquant. Lorsque vous lisez dans des fichiers classiques, le mode bloquant ne vous g&egrave;nera pas. Lors que le fl&ocirc;t atteint <constant>EOF</constant> <function>php_stream_read</function> retournera un nombre d'octets lus inf&eacute;rieur &agrave; <parameter>count</parameter>, puis il retournera 0 aux prochaines lectures. @@ -241,7 +245,7 @@ <refentry id="streams.php-stream-write"> <refnamediv> <refname>php_stream_write</refname> - <refpurpose>ƒcrit des octets depuis un buffer vers un fl&ocirc;t</refpurpose> + <refpurpose>&eacute;ƒcrit des octets depuis un buffer vers un fl&ocirc;t</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -257,13 +261,13 @@ </para> <para> <function>php_stream_write</function> retourne le nombre d'octets qui ont - &eacute;t&eacute; &eacute;crit. Si il y a eu une erreur, le nombre d'octets &eacute;crit sera inf&eacute;rieur - au param&egrave;tre <parameter>count</parameter>. + &eacute;t&eacute; &eacute;crit. Si il y a eu une erreur, le nombre d'octets &eacute;crit sera + inf&eacute;rieur au param&egrave;tre <parameter>count</parameter>. </para> <para> Le pointeur de position dans le fl&ocirc;t est avanc&eacute; d'autant d'octets que le nombre - qui en a &eacute;t&eacute; &eacute;crit. Par cons&eacute;quent, la prochaine &eacute;criture reprendra l&agrave; ou la - lecture pr&eacute;c&eacute;dente s'est arr&eacute;t&eacute;. + qui en a &eacute;t&eacute; &eacute;crit. Par cons&eacute;quent, la prochaine &eacute;criture + reprendra l&agrave; ou la lecture pr&eacute;c&eacute;dente s'est arr&eacute;t&eacute;. </para> </refsect1> </refentry> @@ -285,7 +289,8 @@ </para> <para> <function>php_stream_read</function> retourne 1 pour indiquer la fin du fl&ocirc;t - (<constant>EOF</constant>), 0 si il n'y a pas de fin de fl&ocirc;t, et -1 pour indiquer une erreur. + (<constant>EOF</constant>), 0 si il n'y a pas de fin de fl&ocirc;t, et -1 pour indiquer une + erreur. </para> </refsect1> </refentry> @@ -336,8 +341,8 @@ le buffer <parameter>buf</parameter>. La lecture s'arr&ecirc;te apr&egrave;s la rencontre de la fin du fichier (<constant>EOF</constant>) ou une nouvelle ligne. Si la nouvelle ligne est lue, elle est stock&eacute;e dans <parameter>buf</parameter> dans les - donn&eacute;es retourn&eacute;es. Un caract&egrave;re NUL de fin de cha&icirc;ne est stock&eacute; comme dernier - caract&egrave;re dans le buffer. + donn&eacute;es retourn&eacute;es. Un caract&egrave;re NUL de fin de cha&icirc;ne est + stock&eacute; comme dernier caract&egrave;re dans le buffer. </para> <para> <function>php_stream_read</function> retourne <parameter>buf</parameter> @@ -365,16 +370,16 @@ <methodparam><type>php_stream *</type><parameter>stream</parameter></methodparam> </methodsynopsis> <para> - <function>php_stream_close</function> ferme correctement le fl&ocirc;t <parameter>stream</parameter> - et lib&egrave;re les ressources qui lui sont associ&eacute;es. Apr&agrave;s la fermeture de - <parameter>stream</parameter>, il prend une valeur ind&eacute;finie, et ne devrait plus &ecirc;tre - utilis&eacute;. + <function>php_stream_close</function> ferme correctement le fl&ocirc;t + <parameter>stream</parameter> et lib&egrave;re les ressources qui lui sont associ&eacute;es. + Apr&agrave;s la fermeture de <parameter>stream</parameter>, il prend une valeur + ind&eacute;finie, et ne devrait plus &ecirc;tre utilis&eacute;. </para> <para> - <function>php_stream_close</function> retourne 0 si le fl&ocirc;t a &eacute;t&eacute; ferm&eacute;, ou bien - <constant>EOF</constant> pour indiquer une erreur. Ind&eacute;pendamment du succ&egrave;s de l'op&eacute;ration, - <parameter>stream</parameter> prend une valeur ind&eacute;finie, et ne devrait plus &ecirc;tre - utilis&eacute;. + <function>php_stream_close</function> retourne 0 si le fl&ocirc;t a &eacute;t&eacute; + ferm&eacute;, ou bien <constant>EOF</constant> pour indiquer une erreur. + Ind&eacute;pendamment du succ&egrave;s de l'op&eacute;ration, <parameter>stream</parameter> + prend une valeur ind&eacute;finie, et ne devrait plus &ecirc;tre utilis&eacute;. </para> </refsect1> </refentry> @@ -395,9 +400,9 @@ les buffers d'&eacute;criture du fl&ocirc;t <parameter>stream</parameter> et force leur stockage. </para> <para> - <function>php_stream_flush</function> retourne 0 si les buffers ont &eacute;t&eacute; vid&eacute;s, - ou si les buffers n'ont pas besoin d'&ecirc;tre vid&eacute;, mais retourne <constant>EOF</constant> - pour indiquer une erreur. + <function>php_stream_flush</function> retourne 0 si les buffers ont &eacute;t&eacute; + vid&eacute;s, ou si les buffers n'ont pas besoin d'&ecirc;tre vid&eacute;, mais retourne + <constant>EOF</constant> pour indiquer une erreur. </para> </refsect1> </refentry> @@ -422,7 +427,8 @@ &agrave; la position indiqu&eacute;e par <parameter>whence</parameter>. Si <parameter>whence</parameter> vaut <constant>SEEK_SET</constant>, <constant>SEEK_CUR</constant> ou <constant>SEEK_END</constant> l'offset sera - relativ au d&eacute;but du fl&ocirc;t, &agrave; la position courante ou &agrave; la fin du fl&ocirc;t, respectivement. + relativ au d&eacute;but du fl&ocirc;t, &agrave; la position courante ou &agrave; la fin du + fl&ocirc;t, respectivement. </para> <para> <function>php_stream_seek</function> retourne 0 en cas de succ&egrave;s, et -1 en cas d'erreur. @@ -436,10 +442,11 @@ <parameter>offset</parameter> octets. </para> <para> - L'&eacute;mulation est uniquement appliqu&eacute;e si l'impl&eacute;mentation du gestionnaire de fl&ocirc;t - suporte le pointeur de position. Si le fl&ocirc;t est (par exemple) bas&eacute; sur des fichiers - qui travaille avec des fl&ocirc;t de pipes, l'API de fl&ocirc;t ne pourra pas appliquer une telle - &eacute;mulation. Le positionnement du pointeur de fl&ocirc;t &eacute;chouera et une erreur sera retourn&eacute;e. + L'&eacute;mulation est uniquement appliqu&eacute;e si l'impl&eacute;mentation du gestionnaire + de fl&ocirc;t suporte le pointeur de position. Si le fl&ocirc;t est (par exemple) + bas&eacute; sur des fichiers qui travaille avec des fl&ocirc;t de pipes, l'API de fl&ocirc;t + ne pourra pas appliquer une telle &eacute;mulation. Le positionnement du pointeur de + fl&ocirc;t &eacute;chouera et une erreur sera retourn&eacute;e. </para> </note> </refsect1> @@ -513,15 +520,16 @@ <methodparam><type>int</type><parameter>persistent</parameter></methodparam> </methodsynopsis> <para> - <function>php_stream_copy_to_mem</function> alloue un buffer de taille <parameter>maxlen</parameter>+1 - en utilisant la fonction <function>pemalloc</function> (en passant <parameter>persistent</parameter>). - Puis, elle lit <parameter>maxlen</parameter> octets depuis le fl&ocirc;t from <parameter>src</parameter> and stores - them in the allocated buffer. + <function>php_stream_copy_to_mem</function> alloue un buffer de taille + <parameter>maxlen</parameter>+1 en utilisant la fonction <function>pemalloc</function> (en + passant <parameter>persistent</parameter>). Puis, elle lit <parameter>maxlen</parameter> + octets depuis le fl&ocirc;t from <parameter>src</parameter> and stores them in the allocated + buffer. </para> <para> - The allocated buffer is returned in <parameter>buf</parameter>, and the number of bytes successfully - read. You, the caller, are responsible for freeing the buffer by passing it and <parameter>persistent</parameter> - to <function>pefree</function>. + The allocated buffer is returned in <parameter>buf</parameter>, and the number of bytes + successfully read. You, the caller, are responsible for freeing the buffer by passing it and + <parameter>persistent</parameter> to <function>pefree</function>. </para> <para> If you want to copy all remaining data from the <parameter>src</parameter> stream, pass the @@ -585,8 +593,8 @@ <row> <entry>PHP_STREAM_RELEASED</entry> - <entry>Le fl&ocirc;t originl n'avait pas pointeur de position, et il a &eacute;t&eacute; d&eacute;truit. - Vous n'avez plus acc&egrave;s &agrave; <parameter>origstream</parameter>. + <entry>Le fl&ocirc;t originl n'avait pas pointeur de position, et il a &eacute;t&eacute; + d&eacute;truit. Vous n'avez plus acc&egrave;s &agrave; <parameter>origstream</parameter>. </entry> </row> @@ -601,8 +609,9 @@ <row> <entry>PHP_STREAM_CRITICAL</entry> <entry>Une erreur est survenue lors de la conversion de <parameter>origstream</parameter>, - qui est maintenant dans un &eacute;tat ind&eacute;termin&eacute;. <parameter>newstream</parameter> vaut - NULL et il est tr&egrave;s recommand&eacute; que vous vous fermiez <parameter>origstream</parameter>. + qui est maintenant dans un &eacute;tat ind&eacute;termin&eacute;. + <parameter>newstream</parameter> vaut NULL et il est tr&egrave;s recommand&eacute; que + vous vous fermiez <parameter>origstream</parameter>. </entry> </row> @@ -612,9 +621,9 @@ </para> <note> <simpara> - Si vous devez d&eacute;placer le pointeur et &eacute;crire dans le fl&ocirc;t, n'utilisez pas cette - fonction, car le fl&ocirc;t retourn&eacute; est un fl&ocirc;t mis en cache. Il n'est pas garantit - qu'il soit li&eacute; &agrave; la ressource originale. + Si vous devez d&eacute;placer le pointeur et &eacute;crire dans le fl&ocirc;t, n'utilisez + pas cette fonction, car le fl&ocirc;t retourn&eacute; est un fl&ocirc;t mis en cache. Il + n'est pas garantit qu'il soit li&eacute; &agrave; la ressource originale. </simpara> </note> <note> @@ -633,19 +642,21 @@ </note> <note> <simpara> - NE JAMAIS appeler cette fonction avec un fl&ocirc;t <parameter>origstream</parameter> qui - est une r&eacute;f&eacute;rence &agrave; un pointeur de fichier dans un script PHP. Cette fonction pourrait alors - fermer le fichier, ce qui conduira &agrave; un crash au prochain acc&egrave;s au pointeur. + Ne JAMAIS appeler cette fonction avec un fl&ocirc;t <parameter>origstream</parameter> qui + est une r&eacute;f&eacute;rence &agrave; un pointeur de fichier dans un script PHP. Cette + fonction pourrait alors fermer le fichier, ce qui conduira &agrave; un crash au prochain + acc&egrave;s au pointeur. </simpara> </note> <note> <simpara> Dans de nombreux cas, cette fontion ne peut r&eacute;ussir que si - <parameter>origstream</parameter> vient d'&ecirc;tre tout juste ouvert, et qu'aucune donn&eacute;es - n'ont &eacute;t&eacute; mises dans les caches de la couche de fl&ocirc;t. Pour cette raison, et parceque - cette fonction est compliqu&eacute;e &agrave; utiliser correctement, il est recommand&eacute; que vous - utilisiez la fonction <function>php_stream_open_wrapper</function> en lui passant la - constante <constant>PHP_STREAM_MUST_SEEK</constant> dans vos options, au lieu d'appeler + <parameter>origstream</parameter> vient d'&ecirc;tre tout juste ouvert, et qu'aucune + donn&eacute;es n'ont &eacute;t&eacute; mises dans les caches de la couche de fl&ocirc;t. Pour + cette raison, et parceque cette fonction est compliqu&eacute;e &agrave; utiliser + correctement, il est recommand&eacute; que vous utilisiez la fonction + <function>php_stream_open_wrapper</function> en lui passant la constante + <constant>PHP_STREAM_MUST_SEEK</constant> dans vos options, au lieu d'appeler cette fonction directement. </simpara> </note> @@ -682,8 +693,8 @@ <constant>FAILURE</constant> en cas d'&eacute;chec. Soyez pr&eacute;venu que vous devez faire une comparaison explicite avec <constant>SUCCESS</constant> ou <constant>FAILURE</constant> &agrave; cause des valeurs sous jacentes de ces - constantes. Une simple comparaison d'expression bool&eacute;enne ne sera pas interpr&eacute;t&eacute;e - comme vous le souhaitez. + constantes. Une simple comparaison d'expression bool&eacute;enne ne sera pas + interpr&eacute;t&eacute;e comme vous le souhaitez. </para> </note> <para> @@ -737,8 +748,9 @@ <entry>PHP_STREAM_CAST_RELEASE</entry> <entry>Informque l'API de fl&ocirc;t que d'autre code (possible une librairie tierce partie) sera responsable de la gestion des ressources de bas niveau. Cela fait que - le fl&ocirc;t <parameter>stream</parameter> sera ferm&eacute; de telle fa&ccedil;on &agrave; ce que le - gestionnaire soit pr&eacute;serv&eacute; et retourn&eacute; dans le param&egrave;tre <parameter>ret</parameter>. + le fl&ocirc;t <parameter>stream</parameter> sera ferm&eacute; de telle fa&ccedil;on &agrave; + ce que le gestionnaire soit pr&eacute;serv&eacute; et retourn&eacute; dans le + param&egrave;tre <parameter>ret</parameter>. Si la fonction r&eacute;ussit, le param&egrave;tre <parameter>stream</parameter> doit &ecirc;tre consid&eacute;r&eacute; comme ferm&eacute;, et inutilisable en l'&eacute;tat. </entry> @@ -752,21 +764,21 @@ Si votre syst&egrave;me supporte la fonction <function>fopencookie</function> (les syst&egrave;mes utilisant la librairie glibc 2 ou plus r&eacute;cent), l'API de fl&ocirc;t sera toujours capable de cr&eacute;er des pointeurs de fichiers de type ANSI FILE* pour tous les fl&ocirc;ts. - M&ecirc;me si c'est extr&ecirc;mement utile pour passer des fl&ocirc;ts PHP &agrave; des librairie tierce - partie, un tel syst&egrave;me n'est pas portable. Il est demand&eacute; que vous consid&eacute;riez la - portabilit&eacute; e vos fonctions avant de diffuser votre extension. Si l'utilisation - de fopencookie() n'est pas d&eacute;sirable, il est recommand&eacute; d'interroger le fl&ocirc;t pour - voir si il supporte naturellement la conversion en FILE* en utilisant la fonction - <function>php_stream_is</function> + M&ecirc;me si c'est extr&ecirc;mement utile pour passer des fl&ocirc;ts PHP &agrave; des + librairie tierce partie, un tel syst&egrave;me n'est pas portable. Il est demand&eacute; que + vous consid&eacute;riez la portabilit&eacute; e vos fonctions avant de diffuser votre + extension. Si l'utilisation de fopencookie() n'est pas d&eacute;sirable, il est + recommand&eacute; d'interroger le fl&ocirc;t pour voir si il supporte naturellement la + conversion en FILE* en utilisant la fonction <function>php_stream_is</function> </simpara> </note> <note> <simpara> Si vous demandez une socket r&eacute;seau &agrave; la place d'un FILE*, l'API de fl&ocirc;ts va utiliser la fonction <function>fdopen</function> pour la cr&eacute;er pour vous. - Soyez pr&eacute;venu que faire cela risque de perdre les donn&eacute;es qui ont &eacute;t&eacute; mises - en buffer dans le fl&ocirc;t, si vous m&eacute;langer des appels de l'API de fl&ocirc;t et les - appels standard ANSI. + Soyez pr&eacute;venu que faire cela risque de perdre les donn&eacute;es qui ont + &eacute;t&eacute; mises en buffer dans le fl&ocirc;t, si vous m&eacute;langer des appels de + l'API de fl&ocirc;t et les appels standards ANSI. </simpara> </note> <para>
« previous php.doc.fr (#187) next »