Arch manual pages

fconfigure(3tcl) Tcl Built-In Commands fconfigure(3tcl)


fconfigure - 設置和獲得一個通道上的選項

fconfigure channelId
fconfigure channelId name
fconfigure channelId name value ?name value ...?

fconfigure 命令設置和檢索一個通道的選項。ChannelId 標識要設置或查詢某個選項的那個通道。如果沒有提供 namevalue 參數,命令返回一個列表,它包含着這個通道上可變更的選項名字和值。如果提供了 name 而沒有 value 則命令返回給定選項的當前值。如果提供一對或多對 namevalue,命令把每個指名的選項設置成相應的 value ;在這種情況下返回值是一個空串。

所有通道都支持下面描述的選項。額外的,每個通道類型都可以增加只有它自己支持的選項。參見建立各種類型通道的命令的手冊條目來得到這個特定類型的通道所支持的選項。例如,參見 socket命令的手冊條目來得到增補的選項。

-blocking boolean
-blocking 選項決定在通道上的 I/O 操作是否可以導致進程無限的阻塞。選項的值必須是一個正確的 boolean 值。通道通常在阻塞模式中;如果把一個通道轉換到非阻塞模式中,它將影響 getsreadputsflush、和 close 命令的操作;詳見這些命令的文檔。要使非阻塞模式正常工作,應用必須使用 Tcl 事件循環(例如,通過調用 Tcl_DoOneEvent 或調用 vwait 命令)。
-buffering newValue
如果 newValuefull,則 I/O 系統直到它的內部緩衝變滿或調用 flush 命令之後纔將緩衝輸出。如果 newValueline,則 I/O 系統將在輸出一個換行符的時候自動的刷新此通道的輸出。如果 newValuenone,則 I/O 系統將在每次輸出操作之後自動刷新。除了連接到終端類設備的通道被初始設置成 line 之外,-buffering 的缺省被設置成 full。補充一下,stdinstdout 被初始設置成 line,而 stderr 被設置成 none
-buffersize newSize
Newvalue必須是一個整數;使用它的值來設置隨後分配給這個通道用來存儲輸入和輸出的緩衝區的大小,以字節爲單位。Newvalue 必須在十到一百萬之間,即允許十到一百萬字節大小的緩衝區。
-encoding name
用這個選項來指定通道的編碼,爲了在 Tcl 中使用數據,數據可以轉換成 Unicode 或從 Unicode 轉換過來。例如,要使 Tcl 從用 shiftjis 編碼的日文文件中讀取字符並正確的處理和顯示其中的內容,編碼就應該設置成 shiftjis。此後,當從一個通道讀取的時候,在這個日文文件中的字節如其所讀的將被轉換成 Unicode。同樣也支持寫入 - 即把要寫到通道中的 Tcl 字符串自動的轉換成輸出上的特定編碼。

如果一個文件包含純二進制數據(例如,一個 JPEG 圖象),這種通道應當被配置成 binary。Tcl 將對這種文件中的數據不賦予任何解釋,而是簡單的讀或寫原始(raw)的字節。使用Tcl binary 命令操縱這種原始字節數據。

給新打開的通道的缺省編碼與同操作系統交互時使用的依賴於平臺或本地的編碼是一樣的。

-eofchar char
-eofchar {inChar outChar}
這個選項支持 DOS 文件系統,它使用 Control-z (\x1a)作爲文件結束的標記符(marker)。如果 char 不是一個空串,則在輸入期間遇到這個字符時指示(signal)文件結束。對於輸出,在關閉通道的時候輸出文件結束字符。如果 char 是一個空串,則沒有特定的文件結束字符標記符。對於讀寫通道,一個有兩個元素的列表分別指定給輸入和輸出的文件結束標記符。作爲一種約定,在給讀寫通道設置文件結束符的時候,你可以指定一個單一的值,同時提供給讀和寫。在查詢一個讀寫通道的文件結束符時,將返回一個兩個元素的列表。除了在 Windows 下的文件之外的情況下,-eofchar 缺省值是一個空串。在Windows 的情況下,對於讀 -eofchar 是 Control-z (\x1a),對於寫是空串。
-translation mode
-translation {inMode outMode}
在 Tcl 腳本中總是使用一個單一的換行符(\n)來表示一行的結束。但是在實際的文件和設備中的行結束在不同的平臺上可能有不同的表示,甚至在相同的平臺的不同的設備上也可能有不同的表示。例如,在 UNIX 下在文件中是換行符,而在網絡連接中通常使用回車-換行(carriage-return-linefeed)序列。在輸入上 (例如,使用 getsread),Tcl I/O 系統自動的把外部的行結束表示轉換成換行符。在輸出上(例如,使用 puts),I/O 系統把換行符轉換成外部的行結束表示。缺省的轉換模式是 auto,即自動的處理所有一般情況,而 -translation 選項在提供顯式的對行結束轉換的控制。

對於只讀和只寫通道,與 -translation 相關聯的值是一個單一的項目。對於讀寫通道這個值是一個兩個元素的列表;列表的第一個元素是讀轉換模式,第二個元素是寫轉換模式。作爲一種約定,在給讀寫通道設置行結束符的時候,你可以指定一個單一的值,同時提供給讀和寫。在查詢一個讀寫通道的行結束符時,將返回一個兩個元素的列表。當前支持下列值:

auto
作爲輸入轉換模式,auto 把所有的換行(lf)、回車(cr)、或一個回車並跟隨一個換行(crlf) 作爲行結束表示。行結束表示甚至可以從行到行的改變,並且所有的情況都被轉換成一個換行符。作爲輸出轉換模式,auto 選擇一個特定於平臺的表示;對於套接口,Tcl 在所有平臺上均選擇 crlf,對於所有 Unix 版本(flavor),它選擇 lf,對Macintosh 平臺它選擇 cr,對於各種版本的Windows 它選擇 crlf。對於輸入和輸出二者,-translation的缺省設置是 auto
binary
不進行行結束轉換。除了 binary模式額外的把文件結束符設置成空串(禁用文件結束符),並且把編碼設置成 binary (禁用編碼過濾)之外,它與lf 模式基本一致。詳細信息參見 -eofchar-encoding
cr
在底層文件或設備中的行結束被表示爲一個單一的回車符。作爲輸入轉換模式,cr模式把回車符轉換成換行符。作爲輸出轉換模式,cr模式把換行符轉換成回車符。這種模式典型的在 Macintosh 平臺上使用。
crlf
在底層文件或設備中的行結束被表示一個回車符並跟隨一個換行符。作爲輸入轉換模式,crlf模式把回車換行序列轉換成換行符。作爲輸出模式,crlf 模式把換行符轉換成回車換行序列。這種模式典型的在 Windows 平臺和網絡連接上使用。
lf
在底層文件或設備中的行結束被表示爲一個單一的換行符。在這種模式下在輸入或輸出期間沒有轉換髮生。這種模式典型的在UNIX 平臺上使用。

close(n), flush(n), gets(n), puts(n), read(n), socket(n)

blocking, buffering, carriage return, end of line, flushing, linemode, newline, nonblocking, platform, translation, encoding, filter, byte array, binary

寒蟬退士

2001/08/02

http://cmpp.linuxforum.net

本頁面中文版由中文 man 手冊頁計劃提供。
中文 man 手冊頁計劃:https://github.com/man-pages-zh/manpages-zh
8.1 Tcl