package(3tcl)

NAME
package - 裝載包和版本控制的設施

總覽 SYNOPSIS
package forget ?package package ...?
package ifneeded package version ?script?
package names
package present ?-exact? package ?version?
package provide package ?version?
package require ?-exact? package ?version?
package unknown ?command?
package vcompare version1 version2
package versions package
package vsatisfies version1 version2

描述 DESCRIPTION

這個命令維持由當前直譯器使用的可獲得的包以及如何把它們裝載到直譯器中的一個簡單的資料庫。它支援每個包的多個版本，並基於應用的需要安排裝載一個包的正確的版本。這個命令還檢測並報告版本衝突。典型的，在通常的 Tcl 指令碼中只調用 package require 和 package provide 命令；其他命令主要被系統指令碼用來維護包資料庫。

package 命令的行為由它的第一個引數確定。允許下列形式:

package forget ?package package ...?
    從這個直譯器中刪除關於每個指定的包的所有資訊，包括由 package ifneeded 和 package provide 提供的資訊。

package ifneeded package version ?script?
    這個命令典型的只出現在系統配置指令碼中，被用來設定包資料庫。若需要一個特定的包的一個特定的版本，它指示如果這個包的這個版本是可獲得的，可通過執行 script 來把這個包來增加到直譯器上。指令碼儲存在一個數據庫中，由隨後的 package require 命令使用；典型的，script 為在包中的命令設定自動裝載(或直接呼叫 load 和/或 source)，接著呼叫package provide 來指示這個包已經存在。在資料庫中可以有一個單一的包的多個版本的資訊。如果資料庫已經包含了對 package 和 version 的資訊，則新 script 替換現存的指令碼。如果省略了 script 引數，返回包 package 的版本 version 的當前指令碼，如果未對這個 package 和 version 呼叫 package ifneeded 命令則返回一個空串。

package names
    返回在這個直譯器中所有包的名字，為這些包提供了一個版本(通過 package provide)或可獲得給它們的 package ifneeded 指令碼。在列表中的元素的次序是任意的。

package present ?-exact? package ?version?
    除了在包沒有裝載時它不嘗試並裝載它之外，這個命令等價於 package require。

package provide package ?version?
    呼叫這個命令來指示在這個直譯器中包 package 的這個版本 version 現在已經存在。它典型的被作為一個 ifneeded指令碼的一部分而呼叫一次，並在包最終裝載時被包自身再次呼叫。如果以前的 package provide 命令已經提供的 package 的一個不同的版本則生成一個錯誤。如果省略了 version 引數，則命令返回當前提供包的版本號，如果在這個直譯器中對 package 沒有呼叫 package provide 命令則返回一個空串。

package require ?-exact? package ?version?
    這個命令典型的被想要使用特定包的特定版本的 Tcl 指令碼呼叫。引數指示想要哪個包，和確保把包的合適版本裝載到直譯器中的命令。如果命令成功執行，它返回裝載的包的版本號；否則生成一個錯誤。如果同時指定了 -exact 開關和 version 選項，則只接受給定版本。如果省略了 -exact 但指定了 version ，則主版本號與 version 相同但晚於 version 的版本也可以接受。如果省略了 -exact 和 version二者則任何版本都可接受。如果已經提供了 package 的一個版本(通過呼叫 package provide 命令)，則它的版本號必須滿足由-exact 和 version 給出的條件並且命令立即返回。否則，命令查詢由以前的package ifneeded 命令提供的資訊的資料庫，看是否能獲得一個可接受的版本。如果有，則呼叫最可接受的版本號的指令碼；它必須做所有裝載這個包所必須的工作，包括呼叫為這個包呼叫 package provide。如果 package ifneeded資料庫不包含這個包的可接受的版本並且為這個直譯器指定了一個 package unknown 命令則呼叫這個命令；當它完成的時候，Tcl 再次檢查是否現在提供了這個包或是否有一個給它的 package ifneeded指令碼。如果所有這些步驟不能提供這個包的一個可接受的版本，則命令返回一個錯誤。

package unknown ?command?
    這個命令提供在一個“最後一搏”(``last resort'') 命令，在 package require 期間如果 package ifneeded 資料庫中沒有一個包的合適的版本可呼叫這個命令。如果提供了 command 引數，它包含一個命令的第一部分，在一次 package require 命令期間呼叫這個命令的時候，Tcl 新增給出所須的包的名字和版本的兩個附加引數。例如，如果 command是 foo bar 並且後來呼叫了命令 package require test 2.4，則 Tcl 將執行命令 foo bar test 2.4 來裝載這個包。如果未給 package require 命令提供版本號，則給這個被呼叫的命令的版本引數是一個空串。如果 package unknown命令但不加 command 引數，則返回當前的 package unknown 指令碼，如果沒有就返回一個空串。如果指定 command 為一個空串，若當前有 package unknown 指令碼則刪除它。

package vcompare version1 version2
    比較由 version1和 version2 給出的兩個版本。如果 version1 比 version2 早就返回 -1，如果相同則返回0，如果 version1 比 version2 晚則返回 1。

package versions package
    返回 package 的所有版本號，通過 package ifneeded 命令為它們提供了資訊。

package vsatisfies version1 version2
    如果為 version2 寫的指令碼不須更改就可為 version1 工作則返回 1(例如，version1 大於等於 version2 並且有相同的主版本號)，否則返回 0。

版本號 VERSION NUMBERS

版本號由一個或多個用點號分隔的十進位制陣列成，比如 2 或 1.162 或 3.1.13.1。第一個數叫做主版本號。越大的數對應一個包的越晚的版本，最左邊的數有更大的權重(significance). 例如，版本 2.1 比 1.3 晚而版本 3.4.6 比 3.3.5 晚。遺漏的欄位等價於零: 版本 1.3 於版本 1.3.0 和 1.3.0.0 相同，所以它比 1.3.1 和 1.3.0.2 早。假定一個晚期版本向上(upward)相容有相同主版本號的早期版本。 例如，為一個包的版本 2.3 寫的 Tcl 指令碼應當在版本 2.3.2、2.4、和 2.5.1 下不須更改就能工作。主版本號的變更表示有不相容的變更: 如果程式碼是使用了一個包的版本 2.1 寫成的，不保證在版本 1.7.3 或版本 3.1 下不須更改就能工作。

包索引 PACKAGE INDICES

推薦的在 Tcl 中使用包的方式是在指令碼中呼叫 package require 和 package provide 命令，並使用過程 pkg_mkIndex 來建立包索引檔案。一旦你已經這樣做了，將自動的裝載包來響應 package require 命令。詳情請參見 pkg_mkIndex 的文件。

參見 SEE ALSO
msgcat(n), packagens(n), pkgMkIndex(n)

關鍵字 KEYWORDS
package, version

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

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

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

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