57 lines
11 KiB
HTML
57 lines
11 KiB
HTML
|
<HTML><HEAD>
|
|||
|
|
<BASEFONT FACE="Times New Roman" SIZE="2" COLOR="#000000">
|
|||
|
|
</HEAD>
|
|||
|
|
<BODY>
|
|||
|
|
<div><H3><b>fconfigure Commandes Internes Tcl</b></H3></div>
|
|||
|
|
<HR ALIGN="center">
|
|||
|
|
<div><b>NOM</b></div><br>
|
|||
|
|
<div ALIGN="LEFT" style="margin-left: 51px;">fconfigure - Fixe et lit les options d'un canal
|
|||
|
|
</div><br>
|
|||
|
|
<div><b>SYNTAXE</b></div><br>
|
|||
|
|
<div ALIGN="LEFT" style="margin-left: 51px;"><b>fconfigure </b><i>channelId</i><br>
|
|||
|
|
<b>fconfigure </b><i>channelId</i> <i>name</i><br>
|
|||
|
|
<b>fconfigure </b><i>channelId</i> <i>name value </i>?<i>name value ...</i>?<br>
|
|||
|
|
<br>
|
|||
|
|
</div>
|
|||
|
|
<div><b>DESCRIPTION</b></div><br>
|
|||
|
|
<div ALIGN="LEFT" style="margin-left: 51px;">La commande <b>fconfigure</b> fixe et lit les options des canaux. <i>ChannelId</i> identifie le canal pour lequel fixer ou consulter une option. Si aucun arguments <i>name</i> ou <i>value</i> ne sont fournis, la commande retourne une liste contenant des options altern<72>es de noms et de valeurs pour le canal. Si <i>name</i> est fourni mais pas <i>value</i> alors la commande retourne la valeur courante de l 'option donn<6E>e. Si une ou plusieurs paires de <i>name</i> et <i>value</i> sont fournies, la commande fixe chacune des options d<>sign<67>es <20> la <i>value</i> correspondante; dans ce cas la valeur de retour est une cha<68>ne vide. </div>
|
|||
|
|
<div ALIGN="LEFT" style="margin-left: 51px;">Le options d<>crites ci-dessous sont support<72>es par tous les canaux. De plus, chaque type de canal peut ajouter les options qu'il est seul <20> supporter. Voir la page de manuel pour la commande qui cr<63>e chaque type de canaux pour les options que ce type de canal sp<73>cifique supporte. Par exemple, voyez la page de manuel de la commande <A HREF="162.htm"><b>socket</b></A> pour ses options suppl<70>mentaires.
|
|||
|
|
<DL>
|
|||
|
|
<DT><b>-blocking</b> <i>boolean</i><br></DT><DD>L'option <b>-blocking</b> d<>termine si les op<6F>rations I/O sur le canal peuvent provoquer le bloquage du processus. La valeur de l'option doit <20> tre une valeur bool<6F>enne correcte. Les canaux sont normalement en mode bloquant; si un canal est plac<61> en mode non bloquant ceci affectera l'op<6F>ration des commandes <A HREF="118.htm"><b>gets</b></A>, <A HREF="151.htm"><b>read</b></A>, <A HREF="148.htm"><b>puts</b></A>, <A HREF="114.htm"><b>flush</b></A>, et <A HREF="97.htm"><b>close</b></A>; voyez la documentation de ces commandes pour les d<>tails. Pour que le mode non bloquant fonctionne correctement, l'application doit utiliser la boucle d'<27>v<EFBFBD>nement Tcl (ex. en appelant <A HREF="29.htm"><b>Tcl_DoOneEvent</b></A> ou la commande<A HREF="180.htm"><b> </b><b>vwait</b></A>).
|
|||
|
|
</DD>
|
|||
|
|
<DT><b>-buffering</b> <i>newValue</i><br></DT><DD>Si <i>newValue</i> est <b>full</b> alors le syst<73>me I /O mettra la sortie en tampon jusqu'a ce que son tampon interne soit plein ou jusqu'a ce que la commande <A HREF="114.htm"><b>flush</b></A> soit appel<65>e. Si <i>newValue</i> est <b>line</b>, alors le syst<73>me I/O <i>flushera</i> automatiquement la sortie pour le canal chaque fois que un caract<63>re newline est <20>mis. Si <i>newValue</i> est <b>none</b>, le syst<73>me I/O <i>flushera</i> automatiquement apr<70>s tout op<6F>ration de sortie. La valeur par d<>faut de <b>-buffering</b> est fix<69>e <20> <b>full</b> except<70> pour les canaux qui se connectent <20> des p<>riph<70>riques terminal-like; pour ces canaux la valeur initiale est <b>line</b>. De plus, <b>stdin</b> et <b>stdout</b> sont initialement fix<69>s <20> <b>line</b>, et <b>stderr</b> est fix<69> <20> <b>none</b>.
|
|||
|
|
</DD>
|
|||
|
|
<DT><b>-buffersize</b> <i>newSize</i><br></DT><DD><i>Newvalue</i> doit <20>tre un entier; sa valeur est utilis<69>e pour fixer la taille, en octets, du tampon allou<6F> pour ce canal pour stocker l'entr<74>e ou la sortie. <i>Newvalue</i> doit <20>tre entre dix et un million, permettant des tampons d'une taille de dix <20> un million octets.
|
|||
|
|
</DD>
|
|||
|
|
<DT><b>-encoding</b> <i>name</i></DT><DD>Cette option est utilis<69>e pour specifier l'encodage du canal, ainsi les donn<6E>es peuvent <20>tre converties de et <20> partir d'Unicode pour <20>tre utilis<69>es en Tcl. Par exemple, pour permettre <20> Tcl de lire des caract<63>res d'un fichier Japonais en <b>shiftjis</b> et d'en traiter et d'afficher correctement le contenu, l'encodage devra <20>tre fix<69> <20> <b>shiftjis</b>. Ainsi, en lisant <20> partir du canal, les octets du fichier Japonais seront convertis en Unicode au fur et <20> mesure de leur lecture. L'<27>criture est aussi support<72>e <20> quand les cha<68>nes Tcl seront <20>crites dans le canal elles seront automatiquement converties en l'encodage sp<73>cifi<66> pour la sortie.
|
|||
|
|
Si un fichier contient des donn<6E>es binaires pures (par exemple, une image JPEG), l'encodage du canal sera configur<75> en <A HREF="91.htm"><b>binary</b></A>. Tcl alors n'assignera aucune interpr<70>tation aux donn<6E>es dans le fichier et simplement lira ou ecrira des octets. La commande Tcl <A HREF="91.htm"><b>binary</b></A> peut <20>tre utilis<69>e pour manipuler ces donn<6E>es orient<6E>es-octet.
|
|||
|
|
L'encodage par d<>faut pour les canaux nouvellement ouverts est le m<>me que le syst<73>me d'encodage utilis<69> pour l 'interface avec le syst<73>me d'exploitation.
|
|||
|
|
</DD>
|
|||
|
|
<DT><b>-eofchar</b> <i>char</i><br></DT><DD></DD>
|
|||
|
|
<DT><b>-eofchar</b> <b>{</b><i>inChar outChar</i><b>}</b></DT><DD>Cette option supporte le syst<73>me de fichiers DOS qui utilise Control-z (\x1a) comme marqueur de fin de fichier. Si <i>char</i> n'est pas une cha<68>ne vide, alors ce caract<63>re signale fin-de-fichier quand il est rencontr<74> pendant l'entr<74>e. Pour la sortie, le caract<63>re fin-de-fichier est <20>mis quand le canal est ferm<72>. Si <i>char</i> est la cha<68>ne vide, alors il n'y a pas de caract<63>re sp<73>cial marqueur de fin de fichier. Pour les canaux en lecture-<2D>criture, une liste <20> deux-<2D>l<EFBFBD>ment sp<73>cifie le marqueur de fin de fichier pour l'entr<74>e et la sortie, respectivement. Comme conv<6E>nience, quand vous fixez le caract<63>re de fin-de-fichier pour un canal en lecture-<2D>criture vous pouvez specifier une simple valeur qui s'appliquera <20> la fois <20> la lecture et <20> l'<27>criture. Quand vous interrogez le caract<63>re de fin-de-fichier d'un canal en lecture-<2D>criture, une liste <20> deux-<2D>l<EFBFBD>ments sera toujours renvoy<6F>e. La valeur par d<>faut de <b>-eofchar</b> est la cha<68>ne vide dans tout les cas except<70> pour les fichiers sous Windows. Dans ce cas, <b>-eofchar</b> est Control-z (\x1a) pour la lecture et la cha<68>ne vide pour l'<27>criture.
|
|||
|
|
</DD>
|
|||
|
|
<DT><b>-translation</b> <i>mode</i></DT><DD></DD>
|
|||
|
|
<DT><b>-translation</b> <b>{</b><i>inMode outMode</i><b>}</b></DT><DD>Dans les scripts Tcl la fin d'une ligne est toujours represent<6E>e en utilisant un simple caract<63>re newline (\n). N<>anmoins, dans les fichiers et p<>riph<70>riques la fin d'une ligne peut <20>tre represent<6E>e diff<66>remment sur diff<66>rentes plateformes, ou m<>me pour diff<66>rents p<>riph<70>riques sur la m<>me plateforme. Par exemple, sous UNIX les saut de lignes sont utilis<69>s dans les fichiers, alors que les s<>quences retour-chariot/linefeed sont normalement utilis<69>es dans les connections r<>seau. En entr<74>e (ex., avec <A HREF="118.htm"><b>gets</b></A> et <A HREF="151.htm"><b>read</b></A>) le syst<73>me I/O Tcl traduit automatiquement traduit la repr<70>sentation fin-de-ligne externe en caract<63>res newline. En sortie (ex., avec <A HREF="148.htm"><b>puts</b></A>), le syst<73>me I/O traduit le saut de lignes en repr<70>sentation externe fin-de-ligne. Le mode de traduction par d<>faut, <b>auto</b>, g<>re tout les cas communs automatiquement, mais l'option <b>-translation</b> fournit un contr<74>le explicite des traductions de fin de ligne.
|
|||
|
|
La valeur associ<63>e <20> <b>-translation</b> est un simple item pour les canaux lecture-seule et <20>criture-seule. La valeur est une liste <20> deux-<2D>l<EFBFBD>ment pour les canaux en lecture-<2D>criture; le mode de traduction de lecture est le premier <20>l<EFBFBD>ment de la liste, et le mode de traduction d'<27>criture est le second <20>l<EFBFBD>ment. Comme convenience, quand vous fixez le mode de traduction pour un canal en lecture-<2D>criture vous pouvez specifier une seule valeur qui s'appliquera autant <20> la lecture qu'<27> l'<27>criture. Quand vous demandez le mode de traduction d'un canal lecture-<2D>criture, une liste <20> deux-<2D>l<EFBFBD>ments sera toujours renvoy<6F>e. Les valeurs suivantes sont couramment support<72>es:
|
|||
|
|
<DL>
|
|||
|
|
<DT><b>auto</b><br></DT><DD>Comme mode traduction d'entr<74>e, <b>auto</b> traite newline (<b>lf</b>), retour chariot (<b>cr</b>), ou retour chariot suivi par une newline (<b>crlf</b>) comme la repr<70>sentation de fin de ligne. La repr<70>sentation de fin de ligne peut m<>me changer d'une ligne <20> l'autre, et tout les cas sont traduits en <i>newline</i>. Comme mode de traduction de sortie, <b>auto</b> choisit une repr<70>sentation sp<73>cifique <20> la plateforme; pour les sockets sur toutes les plateformes Tcl choisit <b>crlf</b>, pour tous les Unix, il choisit <b>lf</b>, pour la plateforme Macintosh il choisit <b>cr</b> et pour les diff<66>rentes versions de Windows il choisit <b>crlf</b>. La valeur par d<>faut de <b>-translation</b> est <b>auto</b> pour l'entr<74>e et la sortie.
|
|||
|
|
</DD>
|
|||
|
|
<DT><b>binary</b> <br></DT><DD>Aucunes traductions fin de ligne ne sont effectu<74>es. Ceci est presque identique au mode <b>lf</b>, except<70> qu'en plus le mode <A HREF="91.htm"><b>binary</b></A> fixe aussi le caract<63>re fin-de-fichier <20> la cha<68>ne vide (qui le d<>sactive) et fixe l'encodage <20> <A HREF="91.htm"><b>binary</b></A> (qui d<>sactive le fitrage par l'encodage). Voir la description de <b>-eofchar</b> et <b>-</b><A HREF="101.htm"><b>encoding</b></A> pour plus d'information.
|
|||
|
|
</DD>
|
|||
|
|
<DT><b>cr</b></DT><DD>La fin d'une ligne dans le fichier ou p<>riph<70>rique sous-jacent est represent<6E>e par un simple caract<63>re retour chariot. Comme mode de traduction d'entr<74>e, le mode <b>cr</b> convertit les retours chariot en caract<63>res newline. Comme le mode de traduction de sortie, le mode <b>cr</b> traduit les caract<63>res newline en retour chariot. Ce mode est typiquement utilis<69> sur les plateformes Macintosh.
|
|||
|
|
</DD>
|
|||
|
|
<DT><b>crlf</b></DT><DD>La fin d'une ligne dans le fichier ou p<>riph<70>rique sous-jacent est represent<6E>e par un caract<63>re retour chariot suivi par un caract<63>re linefeed. Comme mode de traduction d'entr<74>e,le mode <b>crlf</b> convertit le s<>quences retour chariot /linefeed en caract<63>res newline. Comme mode de traduction de sortie, le mode <b>crlf</b> traduit caract<63>res newline en s<>quences retour chariot /linefeed. Ce mode est principalement utilis<69> sur les plateformes Windows et pour les connections r<>seau.
|
|||
|
|
</DD>
|
|||
|
|
<DT><b>lf</b></DT><DD>la fin d'une ligne dans le fichier ou p<>riph<70>rique sous-jacent est repr<70>sent<6E>e par un seul caract<63>re newline; Dans ce mode, aucune traduction ne se fait pendant soit l'entr<74>e soit la sortie. Ce mode est utilis<69> principalement sur les plateformes UNIX.</DD>
|
|||
|
|
</DL>
|
|||
|
|
</DD>
|
|||
|
|
</DL>
|
|||
|
|
</div>
|
|||
|
|
<div><b>VOIR EGALEMENT</b></div><br>
|
|||
|
|
<div ALIGN="LEFT" style="margin-left: 51px;"><A HREF="97.htm">close</A>(n), <A HREF="114.htm">flush</A>(n), <A HREF="118.htm">gets</A>(n), <A HREF="148.htm">puts</A>(n), <A HREF="151.htm">read</A>(n), <A HREF="162.htm">socket</A>(n) </div><br>
|
|||
|
|
<div>Derni<EFBFBD>re r<>vision: 8.1</div>
|
|||
|
|
<br>
|
|||
|
|
<br><div ALIGN="CENTER"><A HREF="index.htm"><b>Index</b></A> <A HREF="108.htm"><b>Pr<EFBFBD>c<EFBFBD>dent</b></A> <A HREF="110.htm"><b>Suivant</b></A>
|
|||
|
|
</div>
|
|||
|
|
</BODY></HTML>
|