cvs: phpdoc-fr /chapters streams.common.xml
| From: | CHAILLAN Nicolas | 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éré, spécifiée par <parameter>path</parameter>. + n'importe quelle ressource géré, spécifiée par + <parameter>path</parameter>. Suivant la valeur de <parameter>mode</parameter>, le flôt peut être ouvert en lecture, écriture, ajout ou une combinaison des trois. Voyez la table ci-dessous pour connaîtres les modes utilisées. De plus vous pouvez - aussi intégrer le caractère 'b' comme deuxième ou dernière option. Sa - présence indiquera que le flôt fonctionnera en mode binaire. + aussi intégrer le caractère 'b' comme deuxième ou dernière option. + Sa présence indiquera que le flôt fonctionnera en mode binaire. </para> <para> L'option 'b' est ignorée sur les systèmes POSIX, qui traitent les @@ -164,8 +165,9 @@ </term> <listitem> <simpara> - Ouvre le fichier en mode d'écriture et lecture. Le fichier est créé si il n'existe - pas. Le pointeur de flôt est positionné à la fin du fichier. + Ouvre le fichier en mode d'écriture et lecture. Le fichier est créé + si il n'existe pas. Le pointeur de flôt est positionné à la fin du + fichier. </simpara> </listitem> </varlistentry> @@ -180,18 +182,20 @@ </para> <para> Si <parameter>opened</parameter> est non NULL, il sera assigné avec le nom - du fichier ou de la ressource qui aura été ré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, êtes responsable de l'appel de - <function>efree</function> sur le nom de fichier retourné par ce paramètre. + du fichier ou de la ressource qui aura été ré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, êtes responsable de + l'appel de <function>efree</function> sur le nom de fichier retourné par ce + paramètre. </para> <note> <simpara> - Si vous avez spécifié l'option <constant>STREAM_MUST_SEEK</constant> dans <parameter>options</parameter>, - le chemin retourné dans <parameter>opened</parameter> peut ne pas être le même - que celui qui vous a été réellemetn retourné. Toutes fois, ce sera le nom - de la ressource originale à partir de laquelle un flôt à pointeur variable - a été créé. + Si vous avez spécifié l'option <constant>STREAM_MUST_SEEK</constant> dans + <parameter>options</parameter>, le chemin retourné dans <parameter>opened</parameter> + peut ne pas être le même que celui qui vous a été + réellemetn retourné. Toutes fois, ce sera le nom de la ressource originale + à partir de laquelle un flôt à pointeur variable a été + créé. </simpara> </note> </refsect1> @@ -223,14 +227,14 @@ </para> <para> Le pointeur de position dans le flôt est avancé d'autant d'octets que le nombre - qui en a été lu. Par conséquent, la prochaine lecture reprendra là ou la - lecture précédente s'est arrêtée. + qui en a été lu. Par conséquent, la prochaine lecture reprendra là + ou la lecture précédente s'est arrêtée. </para> <para> Si moins de <parameter>count</parameter> octets ont été lus, cet appel bloquera l'application jusqu'à ce que le nombre d'octets nécessaire soit atteint, en fonction - de la configuration du flôt (bloquant, non bloquant). Par défaut, un flôt est ouvert - en mode bloquant. Lorsque vous lisez dans des fichiers classiques, le mode bloquant + de la configuration du flôt (bloquant, non bloquant). Par défaut, un flôt est + ouvert en mode bloquant. Lorsque vous lisez dans des fichiers classiques, le mode bloquant ne vous gènera pas. Lors que le flôt atteint <constant>EOF</constant> <function>php_stream_read</function> retournera un nombre d'octets lus inférieur à <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ôt</refpurpose> + <refpurpose>écrit des octets depuis un buffer vers un flô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 - été écrit. Si il y a eu une erreur, le nombre d'octets écrit sera inférieur - au paramètre <parameter>count</parameter>. + été écrit. Si il y a eu une erreur, le nombre d'octets écrit sera + inférieur au paramètre <parameter>count</parameter>. </para> <para> Le pointeur de position dans le flôt est avancé d'autant d'octets que le nombre - qui en a été écrit. Par conséquent, la prochaine écriture reprendra là ou la - lecture précédente s'est arrété. + qui en a été écrit. Par conséquent, la prochaine écriture + reprendra là ou la lecture précédente s'est arrété. </para> </refsect1> </refentry> @@ -285,7 +289,8 @@ </para> <para> <function>php_stream_read</function> retourne 1 pour indiquer la fin du flôt - (<constant>EOF</constant>), 0 si il n'y a pas de fin de flôt, et -1 pour indiquer une erreur. + (<constant>EOF</constant>), 0 si il n'y a pas de fin de flôt, et -1 pour indiquer une + erreur. </para> </refsect1> </refentry> @@ -336,8 +341,8 @@ le buffer <parameter>buf</parameter>. La lecture s'arrête après la rencontre de la fin du fichier (<constant>EOF</constant>) ou une nouvelle ligne. Si la nouvelle ligne est lue, elle est stockée dans <parameter>buf</parameter> dans les - données retournées. Un caractère NUL de fin de chaîne est stocké comme dernier - caractère dans le buffer. + données retournées. Un caractère NUL de fin de chaîne est + stocké comme dernier caractè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ôt <parameter>stream</parameter> - et libère les ressources qui lui sont associées. Apràs la fermeture de - <parameter>stream</parameter>, il prend une valeur indéfinie, et ne devrait plus être - utilisé. + <function>php_stream_close</function> ferme correctement le flôt + <parameter>stream</parameter> et libère les ressources qui lui sont associées. + Apràs la fermeture de <parameter>stream</parameter>, il prend une valeur + indéfinie, et ne devrait plus être utilisé. </para> <para> - <function>php_stream_close</function> retourne 0 si le flôt a été fermé, ou bien - <constant>EOF</constant> pour indiquer une erreur. Indépendamment du succès de l'opération, - <parameter>stream</parameter> prend une valeur indéfinie, et ne devrait plus être - utilisé. + <function>php_stream_close</function> retourne 0 si le flôt a été + fermé, ou bien <constant>EOF</constant> pour indiquer une erreur. + Indépendamment du succès de l'opération, <parameter>stream</parameter> + prend une valeur indéfinie, et ne devrait plus être utilisé. </para> </refsect1> </refentry> @@ -395,9 +400,9 @@ les buffers d'écriture du flôt <parameter>stream</parameter> et force leur stockage. </para> <para> - <function>php_stream_flush</function> retourne 0 si les buffers ont été vidés, - ou si les buffers n'ont pas besoin d'être vidé, mais retourne <constant>EOF</constant> - pour indiquer une erreur. + <function>php_stream_flush</function> retourne 0 si les buffers ont été + vidés, ou si les buffers n'ont pas besoin d'être vidé, mais retourne + <constant>EOF</constant> pour indiquer une erreur. </para> </refsect1> </refentry> @@ -422,7 +427,8 @@ à la position indiqué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ébut du flôt, à la position courante ou à la fin du flôt, respectivement. + relativ au début du flôt, à la position courante ou à la fin du + flôt, respectivement. </para> <para> <function>php_stream_seek</function> retourne 0 en cas de succès, et -1 en cas d'erreur. @@ -436,10 +442,11 @@ <parameter>offset</parameter> octets. </para> <para> - L'émulation est uniquement appliquée si l'implémentation du gestionnaire de flôt - suporte le pointeur de position. Si le flôt est (par exemple) basé sur des fichiers - qui travaille avec des flôt de pipes, l'API de flôt ne pourra pas appliquer une telle - émulation. Le positionnement du pointeur de flôt échouera et une erreur sera retournée. + L'émulation est uniquement appliquée si l'implémentation du gestionnaire + de flôt suporte le pointeur de position. Si le flôt est (par exemple) + basé sur des fichiers qui travaille avec des flôt de pipes, l'API de flôt + ne pourra pas appliquer une telle émulation. Le positionnement du pointeur de + flôt échouera et une erreur sera retourné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ô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ô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ôt originl n'avait pas pointeur de position, et il a été détruit. - Vous n'avez plus accès à <parameter>origstream</parameter>. + <entry>Le flôt originl n'avait pas pointeur de position, et il a été + détruit. Vous n'avez plus accès à <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 état indéterminé. <parameter>newstream</parameter> vaut - NULL et il est très recommandé que vous vous fermiez <parameter>origstream</parameter>. + qui est maintenant dans un état indéterminé. + <parameter>newstream</parameter> vaut NULL et il est très recommandé que + vous vous fermiez <parameter>origstream</parameter>. </entry> </row> @@ -612,9 +621,9 @@ </para> <note> <simpara> - Si vous devez déplacer le pointeur et écrire dans le flôt, n'utilisez pas cette - fonction, car le flôt retourné est un flôt mis en cache. Il n'est pas garantit - qu'il soit lié à la ressource originale. + Si vous devez déplacer le pointeur et écrire dans le flôt, n'utilisez + pas cette fonction, car le flôt retourné est un flôt mis en cache. Il + n'est pas garantit qu'il soit lié à la ressource originale. </simpara> </note> <note> @@ -633,19 +642,21 @@ </note> <note> <simpara> - NE JAMAIS appeler cette fonction avec un flôt <parameter>origstream</parameter> qui - est une référence à un pointeur de fichier dans un script PHP. Cette fonction pourrait alors - fermer le fichier, ce qui conduira à un crash au prochain accès au pointeur. + Ne JAMAIS appeler cette fonction avec un flôt <parameter>origstream</parameter> qui + est une référence à un pointeur de fichier dans un script PHP. Cette + fonction pourrait alors fermer le fichier, ce qui conduira à un crash au prochain + accès au pointeur. </simpara> </note> <note> <simpara> Dans de nombreux cas, cette fontion ne peut réussir que si - <parameter>origstream</parameter> vient d'être tout juste ouvert, et qu'aucune données - n'ont été mises dans les caches de la couche de flôt. Pour cette raison, et parceque - cette fonction est compliquée à utiliser correctement, il est recommandé 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'être tout juste ouvert, et qu'aucune + données n'ont été mises dans les caches de la couche de flôt. Pour + cette raison, et parceque cette fonction est compliquée à utiliser + correctement, il est recommandé 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'échec. Soyez prévenu que vous devez faire une comparaison explicite avec <constant>SUCCESS</constant> ou <constant>FAILURE</constant> à cause des valeurs sous jacentes de ces - constantes. Une simple comparaison d'expression booléenne ne sera pas interprétée - comme vous le souhaitez. + constantes. Une simple comparaison d'expression booléenne ne sera pas + interprétée comme vous le souhaitez. </para> </note> <para> @@ -737,8 +748,9 @@ <entry>PHP_STREAM_CAST_RELEASE</entry> <entry>Informque l'API de flô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ôt <parameter>stream</parameter> sera fermé de telle façon à ce que le - gestionnaire soit préservé et retourné dans le paramètre <parameter>ret</parameter>. + le flôt <parameter>stream</parameter> sera fermé de telle façon à + ce que le gestionnaire soit préservé et retourné dans le + paramètre <parameter>ret</parameter>. Si la fonction réussit, le paramètre <parameter>stream</parameter> doit être considéré comme fermé, et inutilisable en l'état. </entry> @@ -752,21 +764,21 @@ Si votre système supporte la fonction <function>fopencookie</function> (les systèmes utilisant la librairie glibc 2 ou plus récent), l'API de flôt sera toujours capable de créer des pointeurs de fichiers de type ANSI FILE* pour tous les flôts. - Même si c'est extrêmement utile pour passer des flôts PHP à des librairie tierce - partie, un tel système n'est pas portable. Il est demandé que vous considériez la - portabilité e vos fonctions avant de diffuser votre extension. Si l'utilisation - de fopencookie() n'est pas désirable, il est recommandé d'interroger le flôt pour - voir si il supporte naturellement la conversion en FILE* en utilisant la fonction - <function>php_stream_is</function> + Même si c'est extrêmement utile pour passer des flôts PHP à des + librairie tierce partie, un tel système n'est pas portable. Il est demandé que + vous considériez la portabilité e vos fonctions avant de diffuser votre + extension. Si l'utilisation de fopencookie() n'est pas désirable, il est + recommandé d'interroger le flô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éseau à la place d'un FILE*, l'API de flôts va utiliser la fonction <function>fdopen</function> pour la créer pour vous. - Soyez prévenu que faire cela risque de perdre les données qui ont été mises - en buffer dans le flôt, si vous mélanger des appels de l'API de flôt et les - appels standard ANSI. + Soyez prévenu que faire cela risque de perdre les données qui ont + été mises en buffer dans le flôt, si vous mélanger des appels de + l'API de flôt et les appels standards ANSI. </simpara> </note> <para>
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éré, spécifiée par <parameter>path</parameter>. + n'importe quelle ressource géré, spécifiée par + <parameter>path</parameter>. Suivant la valeur de <parameter>mode</parameter>, le flôt peut être ouvert en lecture, écriture, ajout ou une combinaison des trois. Voyez la table ci-dessous pour connaîtres les modes utilisées. De plus vous pouvez - aussi intégrer le caractère 'b' comme deuxième ou dernière option. Sa - présence indiquera que le flôt fonctionnera en mode binaire. + aussi intégrer le caractère 'b' comme deuxième ou dernière option. + Sa présence indiquera que le flôt fonctionnera en mode binaire. </para> <para> L'option 'b' est ignorée sur les systèmes POSIX, qui traitent les @@ -164,8 +165,9 @@ </term> <listitem> <simpara> - Ouvre le fichier en mode d'écriture et lecture. Le fichier est créé si il n'existe - pas. Le pointeur de flôt est positionné à la fin du fichier. + Ouvre le fichier en mode d'écriture et lecture. Le fichier est créé + si il n'existe pas. Le pointeur de flôt est positionné à la fin du + fichier. </simpara> </listitem> </varlistentry> @@ -180,18 +182,20 @@ </para> <para> Si <parameter>opened</parameter> est non NULL, il sera assigné avec le nom - du fichier ou de la ressource qui aura été ré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, êtes responsable de l'appel de - <function>efree</function> sur le nom de fichier retourné par ce paramètre. + du fichier ou de la ressource qui aura été ré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, êtes responsable de + l'appel de <function>efree</function> sur le nom de fichier retourné par ce + paramètre. </para> <note> <simpara> - Si vous avez spécifié l'option <constant>STREAM_MUST_SEEK</constant> dans <parameter>options</parameter>, - le chemin retourné dans <parameter>opened</parameter> peut ne pas être le même - que celui qui vous a été réellemetn retourné. Toutes fois, ce sera le nom - de la ressource originale à partir de laquelle un flôt à pointeur variable - a été créé. + Si vous avez spécifié l'option <constant>STREAM_MUST_SEEK</constant> dans + <parameter>options</parameter>, le chemin retourné dans <parameter>opened</parameter> + peut ne pas être le même que celui qui vous a été + réellemetn retourné. Toutes fois, ce sera le nom de la ressource originale + à partir de laquelle un flôt à pointeur variable a été + créé. </simpara> </note> </refsect1> @@ -223,14 +227,14 @@ </para> <para> Le pointeur de position dans le flôt est avancé d'autant d'octets que le nombre - qui en a été lu. Par conséquent, la prochaine lecture reprendra là ou la - lecture précédente s'est arrêtée. + qui en a été lu. Par conséquent, la prochaine lecture reprendra là + ou la lecture précédente s'est arrêtée. </para> <para> Si moins de <parameter>count</parameter> octets ont été lus, cet appel bloquera l'application jusqu'à ce que le nombre d'octets nécessaire soit atteint, en fonction - de la configuration du flôt (bloquant, non bloquant). Par défaut, un flôt est ouvert - en mode bloquant. Lorsque vous lisez dans des fichiers classiques, le mode bloquant + de la configuration du flôt (bloquant, non bloquant). Par défaut, un flôt est + ouvert en mode bloquant. Lorsque vous lisez dans des fichiers classiques, le mode bloquant ne vous gènera pas. Lors que le flôt atteint <constant>EOF</constant> <function>php_stream_read</function> retournera un nombre d'octets lus inférieur à <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ôt</refpurpose> + <refpurpose>écrit des octets depuis un buffer vers un flô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 - été écrit. Si il y a eu une erreur, le nombre d'octets écrit sera inférieur - au paramètre <parameter>count</parameter>. + été écrit. Si il y a eu une erreur, le nombre d'octets écrit sera + inférieur au paramètre <parameter>count</parameter>. </para> <para> Le pointeur de position dans le flôt est avancé d'autant d'octets que le nombre - qui en a été écrit. Par conséquent, la prochaine écriture reprendra là ou la - lecture précédente s'est arrété. + qui en a été écrit. Par conséquent, la prochaine écriture + reprendra là ou la lecture précédente s'est arrété. </para> </refsect1> </refentry> @@ -285,7 +289,8 @@ </para> <para> <function>php_stream_read</function> retourne 1 pour indiquer la fin du flôt - (<constant>EOF</constant>), 0 si il n'y a pas de fin de flôt, et -1 pour indiquer une erreur. + (<constant>EOF</constant>), 0 si il n'y a pas de fin de flôt, et -1 pour indiquer une + erreur. </para> </refsect1> </refentry> @@ -336,8 +341,8 @@ le buffer <parameter>buf</parameter>. La lecture s'arrête après la rencontre de la fin du fichier (<constant>EOF</constant>) ou une nouvelle ligne. Si la nouvelle ligne est lue, elle est stockée dans <parameter>buf</parameter> dans les - données retournées. Un caractère NUL de fin de chaîne est stocké comme dernier - caractère dans le buffer. + données retournées. Un caractère NUL de fin de chaîne est + stocké comme dernier caractè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ôt <parameter>stream</parameter> - et libère les ressources qui lui sont associées. Apràs la fermeture de - <parameter>stream</parameter>, il prend une valeur indéfinie, et ne devrait plus être - utilisé. + <function>php_stream_close</function> ferme correctement le flôt + <parameter>stream</parameter> et libère les ressources qui lui sont associées. + Apràs la fermeture de <parameter>stream</parameter>, il prend une valeur + indéfinie, et ne devrait plus être utilisé. </para> <para> - <function>php_stream_close</function> retourne 0 si le flôt a été fermé, ou bien - <constant>EOF</constant> pour indiquer une erreur. Indépendamment du succès de l'opération, - <parameter>stream</parameter> prend une valeur indéfinie, et ne devrait plus être - utilisé. + <function>php_stream_close</function> retourne 0 si le flôt a été + fermé, ou bien <constant>EOF</constant> pour indiquer une erreur. + Indépendamment du succès de l'opération, <parameter>stream</parameter> + prend une valeur indéfinie, et ne devrait plus être utilisé. </para> </refsect1> </refentry> @@ -395,9 +400,9 @@ les buffers d'écriture du flôt <parameter>stream</parameter> et force leur stockage. </para> <para> - <function>php_stream_flush</function> retourne 0 si les buffers ont été vidés, - ou si les buffers n'ont pas besoin d'être vidé, mais retourne <constant>EOF</constant> - pour indiquer une erreur. + <function>php_stream_flush</function> retourne 0 si les buffers ont été + vidés, ou si les buffers n'ont pas besoin d'être vidé, mais retourne + <constant>EOF</constant> pour indiquer une erreur. </para> </refsect1> </refentry> @@ -422,7 +427,8 @@ à la position indiqué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ébut du flôt, à la position courante ou à la fin du flôt, respectivement. + relativ au début du flôt, à la position courante ou à la fin du + flôt, respectivement. </para> <para> <function>php_stream_seek</function> retourne 0 en cas de succès, et -1 en cas d'erreur. @@ -436,10 +442,11 @@ <parameter>offset</parameter> octets. </para> <para> - L'émulation est uniquement appliquée si l'implémentation du gestionnaire de flôt - suporte le pointeur de position. Si le flôt est (par exemple) basé sur des fichiers - qui travaille avec des flôt de pipes, l'API de flôt ne pourra pas appliquer une telle - émulation. Le positionnement du pointeur de flôt échouera et une erreur sera retournée. + L'émulation est uniquement appliquée si l'implémentation du gestionnaire + de flôt suporte le pointeur de position. Si le flôt est (par exemple) + basé sur des fichiers qui travaille avec des flôt de pipes, l'API de flôt + ne pourra pas appliquer une telle émulation. Le positionnement du pointeur de + flôt échouera et une erreur sera retourné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ô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ô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ôt originl n'avait pas pointeur de position, et il a été détruit. - Vous n'avez plus accès à <parameter>origstream</parameter>. + <entry>Le flôt originl n'avait pas pointeur de position, et il a été + détruit. Vous n'avez plus accès à <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 état indéterminé. <parameter>newstream</parameter> vaut - NULL et il est très recommandé que vous vous fermiez <parameter>origstream</parameter>. + qui est maintenant dans un état indéterminé. + <parameter>newstream</parameter> vaut NULL et il est très recommandé que + vous vous fermiez <parameter>origstream</parameter>. </entry> </row> @@ -612,9 +621,9 @@ </para> <note> <simpara> - Si vous devez déplacer le pointeur et écrire dans le flôt, n'utilisez pas cette - fonction, car le flôt retourné est un flôt mis en cache. Il n'est pas garantit - qu'il soit lié à la ressource originale. + Si vous devez déplacer le pointeur et écrire dans le flôt, n'utilisez + pas cette fonction, car le flôt retourné est un flôt mis en cache. Il + n'est pas garantit qu'il soit lié à la ressource originale. </simpara> </note> <note> @@ -633,19 +642,21 @@ </note> <note> <simpara> - NE JAMAIS appeler cette fonction avec un flôt <parameter>origstream</parameter> qui - est une référence à un pointeur de fichier dans un script PHP. Cette fonction pourrait alors - fermer le fichier, ce qui conduira à un crash au prochain accès au pointeur. + Ne JAMAIS appeler cette fonction avec un flôt <parameter>origstream</parameter> qui + est une référence à un pointeur de fichier dans un script PHP. Cette + fonction pourrait alors fermer le fichier, ce qui conduira à un crash au prochain + accès au pointeur. </simpara> </note> <note> <simpara> Dans de nombreux cas, cette fontion ne peut réussir que si - <parameter>origstream</parameter> vient d'être tout juste ouvert, et qu'aucune données - n'ont été mises dans les caches de la couche de flôt. Pour cette raison, et parceque - cette fonction est compliquée à utiliser correctement, il est recommandé 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'être tout juste ouvert, et qu'aucune + données n'ont été mises dans les caches de la couche de flôt. Pour + cette raison, et parceque cette fonction est compliquée à utiliser + correctement, il est recommandé 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'échec. Soyez prévenu que vous devez faire une comparaison explicite avec <constant>SUCCESS</constant> ou <constant>FAILURE</constant> à cause des valeurs sous jacentes de ces - constantes. Une simple comparaison d'expression booléenne ne sera pas interprétée - comme vous le souhaitez. + constantes. Une simple comparaison d'expression booléenne ne sera pas + interprétée comme vous le souhaitez. </para> </note> <para> @@ -737,8 +748,9 @@ <entry>PHP_STREAM_CAST_RELEASE</entry> <entry>Informque l'API de flô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ôt <parameter>stream</parameter> sera fermé de telle façon à ce que le - gestionnaire soit préservé et retourné dans le paramètre <parameter>ret</parameter>. + le flôt <parameter>stream</parameter> sera fermé de telle façon à + ce que le gestionnaire soit préservé et retourné dans le + paramètre <parameter>ret</parameter>. Si la fonction réussit, le paramètre <parameter>stream</parameter> doit être considéré comme fermé, et inutilisable en l'état. </entry> @@ -752,21 +764,21 @@ Si votre système supporte la fonction <function>fopencookie</function> (les systèmes utilisant la librairie glibc 2 ou plus récent), l'API de flôt sera toujours capable de créer des pointeurs de fichiers de type ANSI FILE* pour tous les flôts. - Même si c'est extrêmement utile pour passer des flôts PHP à des librairie tierce - partie, un tel système n'est pas portable. Il est demandé que vous considériez la - portabilité e vos fonctions avant de diffuser votre extension. Si l'utilisation - de fopencookie() n'est pas désirable, il est recommandé d'interroger le flôt pour - voir si il supporte naturellement la conversion en FILE* en utilisant la fonction - <function>php_stream_is</function> + Même si c'est extrêmement utile pour passer des flôts PHP à des + librairie tierce partie, un tel système n'est pas portable. Il est demandé que + vous considériez la portabilité e vos fonctions avant de diffuser votre + extension. Si l'utilisation de fopencookie() n'est pas désirable, il est + recommandé d'interroger le flô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éseau à la place d'un FILE*, l'API de flôts va utiliser la fonction <function>fdopen</function> pour la créer pour vous. - Soyez prévenu que faire cela risque de perdre les données qui ont été mises - en buffer dans le flôt, si vous mélanger des appels de l'API de flôt et les - appels standard ANSI. + Soyez prévenu que faire cela risque de perdre les données qui ont + été mises en buffer dans le flôt, si vous mélanger des appels de + l'API de flôt et les appels standards ANSI. </simpara> </note> <para>