描述 DESCRIPTION
Tcl
庫自動的建立和管理下列全域性變數。除了下面專做說明的地方之外,對特定於應用的程式碼和使用者,這些變數通常應當作為只讀的來對待。
- env
- Tcl
把這個變數維護為一個數組,它的元素是這個程序的環境變數。讀取一個元素將返回相應的環境變數的值。設定這個陣列的一個元素將修改相應的環境變數,如果它不存在則建立一個新的。刪除
env
的一個元素將刪除相應的環境變數。對
env
陣列的變更將影響透過象
exec
這樣的命令傳遞給子程序的環境變數。如果刪除了整個
env 陣列,則 Tcl
將停止監視 env
訪問並且將不更新環境變數。
在 Windows
下,任何大小寫形式的環境變數
PATH 和 COMSPEC 都被自動轉換成
大寫的。例如,PATH
環境變數可以被作業系統匯出為“path”、“Path”、“PaTh”、
等,這導致其他簡單 Tcl
程式碼必須支援許多特殊的寫法。Tcl
繼承的所有其他
環境變數保持不變。
在 Macintosh 上,Tcl
把環境變數構造為非現存的全域性環境變數。為
Tcl 建立的環境變數包括:
- LOGIN
- 它持有 Macintosh 的 Chooser
名字。
- USER
- 它也持有 Macintosh 的 Chooser
名字。
- SYS_FOLDER
- 到系統目錄的路徑。
- APPLE_M_FOLDER
- 到 Apple
選單目錄的路徑。
- CP_FOLDER
- 到控制面板目錄的路徑。
- DESK_FOLDER
- 到桌面目錄的路徑。
- EXT_FOLDER
- 到系統擴充套件目錄的路徑。
- PREF_FOLDER
- 到偏好目錄的路徑。
- PRINT_MON_FOLDER
- 到列印監控器目錄的路徑。
- SHARED_TRASH_FOLDER
- 到網路垃圾箱目錄的路徑。
- TRASH_FOLDER
- 到垃圾箱目錄的路徑。
- START_UP_FOLDER
- 到啟動目錄的路徑。
- HOME
- 到應用程式的預設目錄的路徑。
你還可以為 Macintosh
建立你自己的環境變數。叫做
Tcl Environment Variables
的一個檔案將被放置到
Mac
系統資料夾中的偏好資料夾中。這個檔案中的每行的形式都是
VAR_NAME=var_data。
最後的選擇是把環境變數放置到這個應用的叫做
Tcl Environment Variables
的一個`STR#'資原始檔中。這被認為是更象“Mac
式”而不是 一個 Unix
式樣的環境變數檔案。`STR#'資源中每個條目有與上述相同的格式。源
程式碼檔案 tclMacEnv.c 包含
env
機制的實現。這個檔案包含許多
#define ,它們允許你定製 env
機制來適合你的應用的需要。
- errorCode
- 在發生了一個錯誤之後,設定這個變數為持有關於錯誤的補充資訊,它的形式易於用程式處理。errorCode
由有一個或多個元素的一個
Tcl
列表組成。這個列表的第一個元素標識錯誤的一個一般的類別,並決定列表餘下部分的格式。Tcl
核心為 errorCode
使用下列格式;個別應用可以定義補充的格式。
- ARITH code
msg
- 在發生一個算術錯誤的時候使用這個格式(例如,在
expr
命令中嘗試除以零)。Code
標識準確的錯誤而
msg
提供一個人可閱讀的對錯誤的描述。Code
將是下列之一:DIVZERO
(嘗試除以零)、DOMAIN
(如果函式的一個引數在它的作用域之外,比如
acos(-3))、IOVERFLOW (整數溢位)、
OVERFLOW (浮點數溢位)、或
UNKNOWN
(如果不能確定錯誤的原因)。
- CHILDKILLED
pid sigName msg
- 在子程序被一個訊號所終止的時候使用這個格式。errorCode
的第二個元素是這個程序的識別符號(十進位制數)。第三個元素標識導致程序終止的訊號的符號名字;它將是在檔案
signal.h
中包含的名字之一,比如
SIGPIPE。第四個元素是一個描述這個訊號的人可閱讀的短訊息,比如對
SIGPIPE是“write on pipe with no
readers”。
- CHILDSTATUS
pid code
- 在子程序以非零狀態退出的時候使用這個格式。errorCode
的第二個元素是這個程序的識別符號(十進位制數),而第三個元素是這個程序返回的退出程式碼(也是十進位制數)。
- CHILDSUSP
pid sigName msg
- 在子程序被一個訊號所掛起的時候使用這個格式。errorCode
的第二個元素是這個程序的識別符號,是一個十進位制數。第三個元素識導致程序掛起的訊號的符號名字;它將是在檔案signal.h
中包含的名字之一,比如
SIGTTIN。
第四個元素是一個描述這個訊號的人可閱讀的短訊息,比如對
SIGTTIN 是“background tty read”。
- NONE
- 對除了返回錯誤訊息之外沒有其他可獲得的補充資訊的錯誤使用這個格式。在這種情況下
errorCode
將由只有一個單一元素的一個列表組成,這個元素的內容是
NONE。
- POSIX errName
msg
- 如果 errorCode
的第一個元素是
POSIX,則錯誤發生在一個
POSIX
核心呼叫期間。這個列表的第二個元素將包含發生的錯誤的符號名字,比如
ENOENT;它將是在包含檔案
errno.h
中定義的值之一。這個列表的第三個元素是對應於
errName
的一個人可閱讀的訊息,比如對
ENOENT 是“no such file or
directory”。
要設定
errorCode,應用應當使用庫過程比如
Tcl_SetErrorCode 和
Tcl_PosixError,或者呼叫 error
命令。如果使用了這些方法之一,則
Tcl
直譯器將在下個錯誤之後重置這個變數為
NONE。
- errorInfo
- 在一個錯誤發生之後,這個字串將包含標識在最新近的錯誤發生時正在執行的
Tcl
命令和過程的一行或多行。它的內容使用棧跟蹤的形式,展示在錯誤發生時呼叫的各個巢狀的
Tcl 命令。
- tcl_library
- 這個變數持有包含系統
Tcl
指令碼庫的一個目錄的名字,比如用於自動裝載的那些目錄。info
library
命令返回這個變數的值。關於
Tcl
指令碼庫的詳情請參見
library 手冊條目。 除了
Tcl
指令碼庫之外,每個應用或包通常都有它自己的特定於應用的指令碼庫;每個應用都應該設定名字象
$app_library
這樣的一個全域性變數(這裡的
app
是這個應用的名字)來持有這個應用的庫目錄的網路檔名字。在建立直譯器的時候,透過查詢許多不同目錄直到找到包含一個適當的
Tcl
啟動指令碼的目錄,來設定
tcl_library
的最初的值。如果
TCL_LIBRARY
環境變數存在,則首先訪問它指名的目錄。如果
TCL_LIBRARY
未被設定或不參照一個適當的目錄,則
Tcl
檢查基於在其中編譯(compiled-in)的預設位置的其他一些目錄、包含應用的二進位制檔案的位置、和當前工作目錄。
- tcl_patchLevel
- 在建立直譯器的時候
Tcl
初始化這個變數來持有給出當前的
Tcl
補丁級別的一個字串,比如
7.3p2 是Tcl 7.3
的第二次官方補丁,而
7.4b4 是 Tcl 7.4 的第四次 beta
釋出。info patchlevel
命令返回這個值。
- tcl_pkgPath
- 這個變數持有一個目錄的列表,它一般指示把包安裝到哪裡。在
Windows 上不使
用它。它典型的包含一個或兩個條目;如果它包含兩個條目,第一個通常是依賴於
平臺的包的目錄(例如,共享庫的二進位制檔案)而第二個通常是平臺無關的包的目錄
(例如,指令碼檔案)。典型的把包安裝為在
$tcl_pkgPath
中的一個條目的
一個子目錄。在
$tcl_pkgPath
中的目錄預設的包含在
auto_path 變數中,所以
package require
命令期間自動的在它們和它們的直接子目
錄中查詢包。注意:
不希望應用修改
tcl_pkgPath。在啟動時它的值被新增
到 auto_path;對 tcl_pkgPath
的變動不會反映到
auto_path 中。如果你想讓
Tcl
來在額外的目錄中查詢包,你應該把這
些目錄的名字新增到
auto_path,而不是
tcl_pkgPath。
- tcl_platform
- 這是一個關聯陣列,它的元素包含關於應用在其上執行的平臺的資訊,比如作業系統的名字、它的當前發行號、和機器的指令集。總是定義下列元素,但是如果
Tcl
不能檢索到任何有關的資訊,則它們的值將是空串。除此之外,擴充套件和應用可以向這個陣列新增補充的值。預先定義的元素是:
- byteOrder
- 這個機器的本地位元組序:
littleEndian 或 bigEndian。
- debug
- 如果這個變數存在,則編譯直譯器時啟用了除錯符號。只在
Windows
上存在這個變數,擴充套件作者可以依賴於所裝載的
C
執行時庫來指定裝載哪個包。
- machine
- 這個機器執行的指令集,比如
intel、PPC、68k、或sun4m。在
UNIX 機器上,用 uname -m
返回這個值。
- os
- 在這個機器上執行的作業系統的名字,比如
Windows 95、Windows
NT、MacOS、或 SunOS。 在
UNIX 機器上,用 uname -s
返回這個值。在 Windows 95
和 Windows 98
上,返回的值將是
Windows 95 來提供更好的對
Windows 95
的反向相容;要區別二者,請檢查
osVersion。
- osVersion
- 在這個機器上執行的作業系統的版本號。在
UNIX 機器上,用 uname -r
返回這個值。在 Windows 95
上,版本將是 4.0;在
Windows 98 上,版本將是
4.10。
- platform
- windows、macintosh、或 unix
之一。它表示這個機器的一般操作環境。
- threaded
- 如果這個變數存在,則編譯這個直譯器時啟用了執行緒。
- user
- 它基於在平臺上獲得的登入資訊標識當前使用者。在
Unix 它源自 USER 或 LOGNAME
環境變數,在 Windows 和
Macintosh 上源自 GetUserName。
- tcl_precision
- 這個變數在把浮點數轉換成字串時控制生成的數字的數目。它預設的是
12。對於 IEEE 浮點數 17
位數字是“最佳的”,這樣允許雙精度值在二進位制和字串之間來回轉換而不丟失資訊。但是,使用
17
位數字將禁止任何舍入,這將生成更長,而更不直觀的值。例如,expr
1.4 在設定 tcl_precision 為 17
時返回
1.3999999999999999,而在設定
tcl_precision 為 12 時返回 1.4
。
在一個程序中的所有直譯器共享一個單一的
tcl_precision 值:
在一個直譯器中改變它將同樣影響所有其他直譯器。但是,不允許安全直譯器修改這個變數。
- tcl_rcFileName
- 在初始化期間使用這個變數來指示特定於使用者的啟動檔案的名字。如果在特定於應用的初始化中設定了它,則
Tcl
啟動程式碼將檢查這個檔案是否存在,並且如果它存在的話則
source
(載入)它。例如,對於
wish
,這個變數被設定成給
Unix 的 ~/.wishrc 和給 Windows 的
~/wishrc.tcl。
- tcl_rcRsrcName
- 這個變數只在 Macintosh
系統上使用。在初始化期間使用這個變數來指示位於應用或擴充套件資源
fork
中的一個特定於應用的
TEXT
資源的名字。如果特定於應用的初始化設定了它,則
Tcl
啟動程式碼將檢查資源是否存在,如果存在則
source 它。例如,Macintosh
wish
應用設定這個變數為
tclshrc。
- tcl_traceCompile
- 設定這個變數的值來控制在位元組碼編譯期間顯示多少跟蹤資訊。預設的,tcl_traceCompile
是零且不顯示資訊。設定
tcl_traceCompile 為
1,在編譯一個過程或頂層命令的時候在標準輸出上生成一行總結。設定它為
2,在標準輸出上詳細的列出在每次編譯期間散發(???
emit)的位元組碼指令。在跟蹤懷疑是
Tcl
編譯器的問題時很有用。在把現存程式碼轉換成
Tcl8.0 時也偶爾有用。
- tcl_traceExec
- 設定這個變數的值來控制在位元組碼執行期間顯示多少跟蹤資訊。預設的,tcl_traceExec
是零而不顯示資訊。設定
tcl_traceExec 為
1,在每次呼叫一個 Tcl
過程的時候在標準輸出上生成一行跟蹤。設定它為
2,在用命令的名字和它的引數呼叫任何Tcl
命令的時候,生成一行輸出。設定它為
3,生成一個詳細的跟蹤,展示每個位元組碼指令的執行結果。注意在
tcl_traceExec 是 2 或 3
的時候,不展示象 set
和 incr
這樣已經被整個替換為一個位元組碼指令序列的命令。在跟蹤懷疑是
Tcl
編譯器和直譯器的問題時很有用。在把現存程式碼轉換成
Tcl8.0 時也偶爾有用。
- tcl_wordchars
- 這個變數的值是一個正則表示式,設定它來控制認把什麼字元認為是“字”字
符。例如在 Tk
的文字框中用雙擊來選擇一個字。它是平臺相關的。在
Windows 上,它預設為
\S,意思是除了 Unicode
空格字元之外的任何字元。其他
平臺上預設為
\w,它是任何 Unicode
字字元(數字、字母、下劃線)。
- tcl_nonwordchars
- 這個變數的值是一個正則表示式,設定它來控制認把什麼字元認為是“非字”
字元。例如在 Tk
的文字框中用雙擊來選擇一個字。它是平臺相關的。在
Windows 上,它預設為
\s,意思是任何 Unicode
空格字元。其他平臺上缺
省為 \W,它是除了 Unicode
字字元(數字、字母、下劃線)之外的任何字元
。
- tcl_version
- 在建立直譯器的時候,Tcl
初始化這個變數來持有這個版本的
Tcl 的版本號,形式是
x.y。對 x
的變更表示可能導致不相容的較大的變化,對
y
的變更表示保持反向相容的小增強和缺陷修理,info
tclversion
命令返回這個變數的值。
關鍵字 KEYWORDS
arithmetic, bytecode, compiler, error, environment, POSIX,
precision, subprocess, variables
《中國 Linux 論壇 man
手冊頁翻譯計劃》:
http://cmpp.linuxforum.net
跋
本頁面中文版由中文
man 手冊頁計劃提供。
中文 man
手冊頁計劃:https://github.com/man-pages-zh/manpages-zh