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