fconfigure(3tcl)

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

總覽 SYNOPSIS
fconfigure channelId
fconfigure channelId name
fconfigure channelId name value ?name value ...?

描述 DESCRIPTION

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

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

-blocking boolean
    -blocking 選項決定在通道上的 I/O 操作是否可以導致程序無限的阻塞。選項的值必須是一個正確的 boolean 值。通道通常在阻塞模式中；如果把一個通道轉換到非阻塞模式中，它將影響 gets、read、puts、flush、和 close 命令的操作；詳見這些命令的文件。要使非阻塞模式正常工作，應用必須使用 Tcl 事件迴圈(例如，透過呼叫 Tcl_DoOneEvent 或呼叫 vwait 命令)。

-buffering newValue
    如果 newValue 是 full，則 I/O 系統直到它的內部緩衝變滿或呼叫 flush 命令之後才將緩衝輸出。如果 newValue 是 line，則 I/O 系統將在輸出一個換行符的時候自動的重新整理此通道的輸出。如果 newValue 是 none，則 I/O 系統將在每次輸出操作之後自動重新整理。除了連線到終端類裝置的通道被初始設定成 line 之外，-buffering 的預設被設定成 full。補充一下，stdin 和 stdout 被初始設定成 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)序列。在輸入上 (例如，使用 gets 和 read)，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 平臺上使用。

參見 SEE ALSO
close(n), flush(n), gets(n), puts(n), read(n), socket(n)

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

[中文版維護人]
寒蟬退士

[中文版最新更新]
2001/08/02

《中國 Linux 論壇 man 手冊頁翻譯計劃》:
http://cmpp.linuxforum.net

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