'\" '\" Copyright (c) 1993 The Regents of the University of California. '\" Copyright (c) 1994-1997 Sun Microsystems, Inc. '\" '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" '\" RCS: @(#) $Id: tclvars.n,v 1.2 2003/11/24 05:10:00 bbbush Exp $ '\" '\" The definitions below are for supplemental macros used in Tcl/Tk '\" manual entries. '\" '\" .AP type name in/out ?indent? '\" Start paragraph describing an argument to a library procedure. '\" type is type of argument (int, etc.), in/out is either "in", "out", '\" or "in/out" to describe whether procedure reads or modifies arg, '\" and indent is equivalent to second arg of .IP (shouldn't ever be '\" needed; use .AS below instead) '\" '\" .AS ?type? ?name? '\" Give maximum sizes of arguments for setting tab stops. Type and '\" name are examples of largest possible arguments that will be passed '\" to .AP later. If args are omitted, default tab stops are used. '\" '\" .BS '\" Start box enclosure. From here until next .BE, everything will be '\" enclosed in one large box. '\" '\" .BE '\" End of box enclosure. '\" '\" .CS '\" Begin code excerpt. '\" '\" .CE '\" End code excerpt. '\" '\" .VS ?version? ?br? '\" Begin vertical sidebar, for use in marking newly-changed parts '\" of man pages. The first argument is ignored and used for recording '\" the version when the .VS was added, so that the sidebars can be '\" found and removed when they reach a certain age. If another argument '\" is present, then a line break is forced before starting the sidebar. '\" '\" .VE '\" End of vertical sidebar. '\" '\" .DS '\" Begin an indented unfilled display. '\" '\" .DE '\" End of indented unfilled display. '\" '\" .SO '\" Start of list of standard options for a Tk widget. The '\" options follow on successive lines, in four columns separated '\" by tabs. '\" '\" .SE '\" End of list of standard options for a Tk widget. '\" '\" .OP cmdName dbName dbClass '\" Start of description of a specific option. cmdName gives the '\" option's name as specified in the class command, dbName gives '\" the option's name in the option database, and dbClass gives '\" the option's class in the option database. '\" '\" .UL arg1 arg2 '\" Print arg1 underlined, then print arg2 normally. '\" '\" RCS: @(#) $Id: tclvars.n,v 1.2 2003/11/24 05:10:00 bbbush Exp $ '\" '\" # Set up traps and other miscellaneous stuff for Tcl/Tk man pages. .if t .wh -1.3i ^B .nr ^l \n(.l .ad b '\" # Start an argument description .de AP .ie !"\\$4"" .TP \\$4 .el \{\ . ie !"\\$2"" .TP \\n()Cu . el .TP 15 .\} .ta \\n()Au \\n()Bu .ie !"\\$3"" \{\ \&\\$1 \\fI\\$2\\fP (\\$3) .\".b .\} .el \{\ .br .ie !"\\$2"" \{\ \&\\$1 \\fI\\$2\\fP .\} .el \{\ \&\\fI\\$1\\fP .\} .\} .. '\" # define tabbing values for .AP .de AS .nr )A 10n .if !"\\$1"" .nr )A \\w'\\$1'u+3n .nr )B \\n()Au+15n .\" .if !"\\$2"" .nr )B \\w'\\$2'u+\\n()Au+3n .nr )C \\n()Bu+\\w'(in/out)'u+2n .. .AS Tcl_Interp Tcl_CreateInterp in/out '\" # BS - start boxed text '\" # ^y = starting y location '\" # ^b = 1 .de BS .br .mk ^y .nr ^b 1u .if n .nf .if n .ti 0 .if n \l'\\n(.lu\(ul' .if n .fi .. '\" # BE - end boxed text (draw box now) .de BE .nf .ti 0 .mk ^t .ie n \l'\\n(^lu\(ul' .el \{\ .\" Draw four-sided box normally, but don't draw top of .\" box if the box started on an earlier page. .ie !\\n(^b-1 \{\ \h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul' .\} .el \}\ \h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul' .\} .\} .fi .br .nr ^b 0 .. '\" # VS - start vertical sidebar '\" # ^Y = starting y location '\" # ^v = 1 (for troff; for nroff this doesn't matter) .de VS .if !"\\$2"" .br .mk ^Y .ie n 'mc \s12\(br\s0 .el .nr ^v 1u .. '\" # VE - end of vertical sidebar .de VE .ie n 'mc .el \{\ .ev 2 .nf .ti 0 .mk ^t \h'|\\n(^lu+3n'\L'|\\n(^Yu-1v\(bv'\v'\\n(^tu+1v-\\n(^Yu'\h'-|\\n(^lu+3n' .sp -1 .fi .ev .\} .nr ^v 0 .. '\" # Special macro to handle page bottom: finish off current '\" # box/sidebar if in box/sidebar mode, then invoked standard '\" # page bottom macro. .de ^B .ev 2 'ti 0 'nf .mk ^t .if \\n(^b \{\ .\" Draw three-sided box if this is the box's first page, .\" draw two sides but no top otherwise. .ie !\\n(^b-1 \h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c .el \h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c .\} .if \\n(^v \{\ .nr ^x \\n(^tu+1v-\\n(^Yu \kx\h'-\\nxu'\h'|\\n(^lu+3n'\ky\L'-\\n(^xu'\v'\\n(^xu'\h'|0u'\c .\} .bp 'fi .ev .if \\n(^b \{\ .mk ^y .nr ^b 2 .\} .if \\n(^v \{\ .mk ^Y .\} .. '\" # DS - begin display .de DS .RS .nf .sp .. '\" # DE - end display .de DE .fi .RE .sp .. '\" # SO - start of list of standard options .de SO .SH "STANDARD OPTIONS" .LP .nf .ta 5.5c 11c .ft B .. '\" # SE - end of list of standard options .de SE .fi .ft R .LP See the \\fBoptions\\fR manual entry for details on the standard options. .. '\" # OP - start of full description for a single option .de OP .LP .nf .ta 4c Command-Line Name: \\fB\\$1\\fR Database Name: \\fB\\$2\\fR Database Class: \\fB\\$3\\fR .fi .IP .. '\" # CS - begin code excerpt .de CS .RS .nf .ta .25i .5i .75i 1i .. '\" # CE - end code excerpt .de CE .fi .RE .. .de UL \\$1\l'|0\(ul'\\$2 .. .TH tclvars 3tcl 8.0 Tcl "Tcl Built-In Commands" .SH NAME tclvars \- Tcl 使用的變數 .SH "描述 DESCRIPTION" .PP Tcl 庫自動的建立和管理下列全域性變數。除了下面專做說明的地方之外，對特定於應用的程式碼和使用者，這些變數通常應當作為只讀的來對待。 .TP \fBenv\fR Tcl 把這個變數維護為一個數組，它的元素是這個程序的環境變數。讀取一個元素將返回相應的環境變數的值。設定這個陣列的一個元素將修改相應的環境變數，如果它不存在則建立一個新的。刪除 \fBenv\fR 的一個元素將刪除相應的環境變數。對 \fBenv\fR 陣列的變更將影響透過象 \fBexec \fR這樣的命令傳遞給子程序的環境變數。如果刪除了整個 \fBenv\fR 陣列，則 Tcl 將停止監視 \fBenv\fR 訪問並且將不更新環境變數。 .RS .VS 8.0 在 Windows 下，任何大小寫形式的環境變數 PATH 和 COMSPEC 都被自動轉換成 大寫的。例如，PATH 環境變數可以被作業系統匯出為\(lqpath\(rq、\(lqPath\(rq、\(lqPaTh\(rq、 等，這導致其他簡單 Tcl 程式碼必須支援許多特殊的寫法。Tcl 繼承的所有其他 環境變數保持不變。 .VE .RE .RS 在 Macintosh 上，Tcl 把環境變數構造為非現存的全域性環境變數。為 Tcl 建立的環境變數包括: .TP \fBLOGIN\fR 它持有 Macintosh 的 Chooser 名字。 .TP \fBUSER\fR 它也持有 Macintosh 的 Chooser 名字。 .TP \fBSYS_FOLDER\fR 到系統目錄的路徑。 .TP \fBAPPLE_M_FOLDER\fR 到 Apple 選單目錄的路徑。 .TP \fBCP_FOLDER\fR 到控制面板目錄的路徑。 .TP \fBDESK_FOLDER\fR 到桌面目錄的路徑。 .TP \fBEXT_FOLDER\fR 到系統擴充套件目錄的路徑。 .TP \fBPREF_FOLDER\fR 到偏好目錄的路徑。 .TP \fBPRINT_MON_FOLDER\fR 到列印監控器目錄的路徑。 .TP \fBSHARED_TRASH_FOLDER\fR 到網路垃圾箱目錄的路徑。 .TP \fBTRASH_FOLDER\fR 到垃圾箱目錄的路徑。 .TP \fBSTART_UP_FOLDER\fR 到啟動目錄的路徑。 .TP \fBHOME\fR 到應用程式的預設目錄的路徑。 .PP 你還可以為 Macintosh 建立你自己的環境變數。叫做 \fBTcl Environment Variables\fR 的一個檔案將被放置到 Mac 系統資料夾中的偏好資料夾中。這個檔案中的每行的形式都是 \fIVAR_NAME=var_data\fR。 .PP 最後的選擇是把環境變數放置到這個應用的叫做 \fBTcl Environment Variables\fR 的一個`STR#'資原始檔中。這被認為是更象\(lqMac 式\(rq而不是 一個 Unix 式樣的環境變數檔案。`STR#'資源中每個條目有與上述相同的格式。源 程式碼檔案 \fItclMacEnv.c\fR 包含 env 機制的實現。這個檔案包含許多 #define ，它們允許你定製 env 機制來適合你的應用的需要。 .RE .TP \fBerrorCode\fR 在發生了一個錯誤之後，設定這個變數為持有關於錯誤的補充資訊，它的形式易於用程式處理。\fBerrorCode\fR 由有一個或多個元素的一個 Tcl 列表組成。這個列表的第一個元素標識錯誤的一個一般的類別，並決定列表餘下部分的格式。Tcl 核心為 \fBerrorCode\fR 使用下列格式；個別應用可以定義補充的格式。 .RS .TP \fBARITH\fI code msg\fR 在發生一個算術錯誤的時候使用這個格式(例如，在 \fBexpr\fR 命令中嘗試除以零)。\fICode\fR 標識準確的錯誤而 \fImsg\fR 提供一個人可閱讀的對錯誤的描述。\fICode\fR 將是下列之一：DIVZERO (嘗試除以零)、DOMAIN (如果函式的一個引數在它的作用域之外，比如 acos(-3))、IOVERFLOW (整數溢位)、 OVERFLOW (浮點數溢位)、或 UNKNOWN (如果不能確定錯誤的原因)。 .TP \fBCHILDKILLED\fI pid sigName msg\fR 在子程序被一個訊號所終止的時候使用這個格式。\fBerrorCode\fR 的第二個元素是這個程序的識別符號(十進位制數)。第三個元素標識導致程序終止的訊號的符號名字；它將是在檔案 signal.h 中包含的名字之一，比如 \fBSIGPIPE\fR。第四個元素是一個描述這個訊號的人可閱讀的短訊息，比如對 \fBSIGPIPE\fR是\(lqwrite on pipe with no readers\(rq。 .TP \fBCHILDSTATUS\fI pid code\fR 在子程序以非零狀態退出的時候使用這個格式。\fBerrorCode \fR的第二個元素是這個程序的識別符號(十進位制數)，而第三個元素是這個程序返回的退出程式碼(也是十進位制數)。 .TP \fBCHILDSUSP\fI pid sigName msg\fR 在子程序被一個訊號所掛起的時候使用這個格式。\fBerrorCode\fR 的第二個元素是這個程序的識別符號，是一個十進位制數。第三個元素識導致程序掛起的訊號的符號名字；它將是在檔案signal.h 中包含的名字之一，比如 \fBSIGTTIN\fR。 第四個元素是一個描述這個訊號的人可閱讀的短訊息，比如對 \fBSIGTTIN \fR是\(lqbackground tty read\(rq。 .TP \fBNONE\fR 對除了返回錯誤訊息之外沒有其他可獲得的補充資訊的錯誤使用這個格式。在這種情況下 \fBerrorCode\fR 將由只有一個單一元素的一個列表組成，這個元素的內容是 \fBNONE\fR。 .TP \fBPOSIX \fIerrName msg\fR 如果 \fBerrorCode\fR 的第一個元素是 \fBPOSIX\fR，則錯誤發生在一個 POSIX 核心呼叫期間。這個列表的第二個元素將包含發生的錯誤的符號名字，比如 \fBENOENT\fR；它將是在包含檔案 errno.h 中定義的值之一。這個列表的第三個元素是對應於 \fIerrName\fR 的一個人可閱讀的訊息，比如對 \fBENOENT\fR 是\(lqno such file or directory\(rq。 .PP 要設定 \fBerrorCode\fR，應用應當使用庫過程比如 \fBTcl_SetErrorCode\fR 和 \fBTcl_PosixError\fR，或者呼叫 \fBerror\fR 命令。如果使用了這些方法之一，則 Tcl 直譯器將在下個錯誤之後重置這個變數為 \fBNONE\fR。 .RE .TP \fBerrorInfo\fR 在一個錯誤發生之後，這個字串將包含標識在最新近的錯誤發生時正在執行的 Tcl 命令和過程的一行或多行。它的內容使用棧跟蹤的形式，展示在錯誤發生時呼叫的各個巢狀的 Tcl 命令。 .TP \fBtcl_library\fR 這個變數持有包含系統 Tcl 指令碼庫的一個目錄的名字，比如用於自動裝載的那些目錄。\fBinfo library\fR 命令返回這個變數的值。關於 Tcl 指令碼庫的詳情請參見 \fBlibrary\fR 手冊條目。 除了 Tcl 指令碼庫之外，每個應用或包通常都有它自己的特定於應用的指令碼庫；每個應用都應該設定名字象 \fB$\fR\fIapp\fR\fB_library\fR 這樣的一個全域性變數(這裡的 \fIapp\fR 是這個應用的名字)來持有這個應用的庫目錄的網路檔名字。在建立直譯器的時候，透過查詢許多不同目錄直到找到包含一個適當的 Tcl 啟動指令碼的目錄，來設定 \fBtcl_library\fR 的最初的值。如果 \fBTCL_LIBRARY\fR 環境變數存在，則首先訪問它指名的目錄。如果 \fBTCL_LIBRARY\fR 未被設定或不參照一個適當的目錄，則 Tcl 檢查基於在其中編譯(compiled-in)的預設位置的其他一些目錄、包含應用的二進位制檔案的位置、和當前工作目錄。 .TP \fBtcl_patchLevel\fR 在建立直譯器的時候 Tcl 初始化這個變數來持有給出當前的 Tcl 補丁級別的一個字串，比如 \fB7.3p2 \fR是Tcl 7.3 的第二次官方補丁，而 \fB7.4b4\fR 是 Tcl 7.4 的第四次 beta 釋出。\fBinfo patchlevel\fR 命令返回這個值。 .VS 8.0 br .TP \fBtcl_pkgPath\fR 這個變數持有一個目錄的列表，它一般指示把包安裝到哪裡。在 Windows 上不使 用它。它典型的包含一個或兩個條目；如果它包含兩個條目，第一個通常是依賴於 平臺的包的目錄(例如，共享庫的二進位制檔案)而第二個通常是平臺無關的包的目錄 (例如，指令碼檔案)。典型的把包安裝為在 \fB$tcl_pkgPath\fR 中的一個條目的 一個子目錄。在 \fB$tcl_pkgPath\fR 中的目錄預設的包含在 \fBauto_path\fR 變數中，所以 \fBpackage require\fR 命令期間自動的在它們和它們的直接子目 錄中查詢包。注意: 不希望應用修改 \fBtcl_pkgPath\fR。在啟動時它的值被新增 到 \fBauto_path\fR；對 \fBtcl_pkgPath\fR 的變動不會反映到 \fBauto_path\fR 中。如果你想讓 Tcl 來在額外的目錄中查詢包，你應該把這 些目錄的名字新增到 \fBauto_path\fR，而不是 \fBtcl_pkgPath\fR。 .VE .TP \fBtcl_platform\fR 這是一個關聯陣列，它的元素包含關於應用在其上執行的平臺的資訊，比如作業系統的名字、它的當前發行號、和機器的指令集。總是定義下列元素，但是如果 Tcl 不能檢索到任何有關的資訊，則它們的值將是空串。除此之外，擴充套件和應用可以向這個陣列新增補充的值。預先定義的元素是: .RS .VS .TP \fBbyteOrder\fR 這個機器的本地位元組序: \fBlittleEndian\fR 或 \fBbigEndian\fR。 .VE .TP \fBdebug\fR 如果這個變數存在，則編譯直譯器時啟用了除錯符號。只在 Windows 上存在這個變數，擴充套件作者可以依賴於所裝載的 C 執行時庫來指定裝載哪個包。 .TP \fBmachine\fR 這個機器執行的指令集，比如 \fBintel\fR、\fBPPC\fR、\fB68k\fR、或\fBsun4m\fR。在 UNIX 機器上，用 \fBuname -m\fR 返回這個值。 .TP \fBos\fR 在這個機器上執行的作業系統的名字，比如 \fBWindows 95\fR、\fBWindows NT\fR、\fBMacOS\fR、或 \fBSunOS\fR。 在 UNIX 機器上，用 \fBuname -s\fR 返回這個值。在 Windows 95 和 Windows 98 上，返回的值將是 \fBWindows 95\fR 來提供更好的對 Windows 95 的反向相容；要區別二者，請檢查 \fBosVersion\fR。 .TP \fBosVersion\fR 在這個機器上執行的作業系統的版本號。在 UNIX 機器上，用 \fBuname -r\fR 返回這個值。在 Windows 95 上，版本將是 4.0；在 Windows 98 上，版本將是 4.10。 .TP \fBplatform\fR \fBwindows\fR、\fBmacintosh\fR、或 \fBunix \fR之一。它表示這個機器的一般操作環境。 .TP \fBthreaded\fR 如果這個變數存在，則編譯這個直譯器時啟用了執行緒。 .TP \fBuser\fR 它基於在平臺上獲得的登入資訊標識當前使用者。在 Unix 它源自 USER 或 LOGNAME 環境變數，在 Windows 和 Macintosh 上源自 GetUserName。 .RE .TP \fBtcl_precision\fR .VS 這個變數在把浮點數轉換成字串時控制生成的數字的數目。它預設的是 12。對於 IEEE 浮點數 17 位數字是\(lq最佳的\(rq，這樣允許雙精度值在二進位制和字串之間來回轉換而不丟失資訊。但是，使用 17 位數字將禁止任何舍入，這將生成更長，而更不直觀的值。例如，\fBexpr 1.4\fR 在設定 \fBtcl_precision\fR 為 17 時返回 1.3999999999999999，而在設定 \fBtcl_precision\fR 為 12 時返回 1.4 。 .RS 在一個程序中的所有直譯器共享一個單一的 \fBtcl_precision\fR 值: 在一個直譯器中改變它將同樣影響所有其他直譯器。但是，不允許安全直譯器修改這個變數。 .RE .VE .TP \fBtcl_rcFileName\fR 在初始化期間使用這個變數來指示特定於使用者的啟動檔案的名字。如果在特定於應用的初始化中設定了它，則 Tcl 啟動程式碼將檢查這個檔案是否存在，並且如果它存在的話則 \fBsource\fR (載入)它。例如，對於 \fBwish\fR ，這個變數被設定成給 Unix 的 \fB~/.wishrc\fR 和給 Windows 的 \fB~/wishrc.tcl\fR。 .TP \fBtcl_rcRsrcName\fR 這個變數只在 Macintosh 系統上使用。在初始化期間使用這個變數來指示位於應用或擴充套件資源 fork 中的一個特定於應用的 \fBTEXT\fR 資源的名字。如果特定於應用的初始化設定了它，則 Tcl 啟動程式碼將檢查資源是否存在，如果存在則 \fBsource\fR 它。例如，Macintosh \fBwish\fR 應用設定這個變數為 \fBtclshrc\fR。 .TP \fBtcl_traceCompile\fR 設定這個變數的值來控制在位元組碼編譯期間顯示多少跟蹤資訊。預設的，tcl_traceCompile 是零且不顯示資訊。設定 tcl_traceCompile 為 1，在編譯一個過程或頂層命令的時候在標準輸出上生成一行總結。設定它為 2，在標準輸出上詳細的列出在每次編譯期間散發(??? emit)的位元組碼指令。在跟蹤懷疑是 Tcl 編譯器的問題時很有用。在把現存程式碼轉換成 Tcl8.0 時也偶爾有用。 .TP \fBtcl_traceExec\fR 設定這個變數的值來控制在位元組碼執行期間顯示多少跟蹤資訊。預設的，tcl_traceExec 是零而不顯示資訊。設定 tcl_traceExec 為 1，在每次呼叫一個 Tcl 過程的時候在標準輸出上生成一行跟蹤。設定它為 2，在用命令的名字和它的引數呼叫任何Tcl 命令的時候，生成一行輸出。設定它為 3，生成一個詳細的跟蹤，展示每個位元組碼指令的執行結果。注意在 tcl_traceExec 是 2 或 3 的時候，不展示象 set 和 incr 這樣已經被整個替換為一個位元組碼指令序列的命令。在跟蹤懷疑是 Tcl 編譯器和直譯器的問題時很有用。在把現存程式碼轉換成 Tcl8.0 時也偶爾有用。 .TP \fBtcl_wordchars\fR 這個變數的值是一個正則表示式，設定它來控制認把什麼字元認為是\(lq字\(rq字 符。例如在 Tk 的文字框中用雙擊來選擇一個字。它是平臺相關的。在 Windows 上，它預設為 \fB\\S\fR，意思是除了 Unicode 空格字元之外的任何字元。其他 平臺上預設為 \fB\\w\fR，它是任何 Unicode 字字元(數字、字母、下劃線)。 .TP \fBtcl_nonwordchars\fR 這個變數的值是一個正則表示式，設定它來控制認把什麼字元認為是\(lq非字\(rq 字元。例如在 Tk 的文字框中用雙擊來選擇一個字。它是平臺相關的。在 Windows 上，它預設為 \fB\\s\fR，意思是任何 Unicode 空格字元。其他平臺上缺 省為 \fB\\W\fR，它是除了 Unicode 字字元(數字、字母、下劃線)之外的任何字元 。 .TP \fBtcl_version\fR 在建立直譯器的時候，Tcl 初始化這個變數來持有這個版本的 Tcl 的版本號，形式是 \fIx.y\fR。對 \fIx\fR 的變更表示可能導致不相容的較大的變化，對 \fIy\fR 的變更表示保持反向相容的小增強和缺陷修理，\fBinfo tclversion\fR 命令返回這個變數的值。 .SH "參見 SEE ALSO" eval(n) .SH "關鍵字 KEYWORDS" arithmetic, bytecode, compiler, error, environment, POSIX, precision, subprocess, variables .SH "[中文版維護人]" .B 寒蟬退士 .SH "[中文版最新更新]" .B 2001/12/10 .SH "《中國 Linux 論壇 man 手冊頁翻譯計劃》:" .BI http://cmpp.linuxforum.net .SH "跋" .br 本頁面中文版由中文 man 手冊頁計劃提供。 .br 中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR