Provided by: manpages-zh_1.5.2-1_all bug

NAME

       filename - Tcl 命令支持的檔名轉換
_________________________________________________________________

INTRODUCTION

       所有接受檔名作為參數的             Tcl             命令和             C
       過程希望檔名是依賴於當前平台的三種形式之一。在每種平台上,Tcl
       都支持這種平台上的標準形式的檔名。額外的,在所有平台上,Tcl    支持一種
       Unix
       式的語法,提供了一種方便的方式來構造簡單的檔名。但是,打算被移植的稿本不要假定特定形式的檔名。可移植的稿本必須使用
       file splitfile join 命令來操縱檔名(詳見file 的手冊條目)。

路徑類型 PATH TYPES
       基於用來指定檔案的路徑的起點,檔名被組織成三種一般類型:
       絕對,相對,相對-卷。絕對名字是完全限定的(qualified),給出的到檔案的路徑相對於一個特定的卷和在這個卷上的根目錄。相對名字是未限定的,給出的到檔案的路徑相對於當前的工作目錄。相對-卷名字是部分限定的,給出的路徑要麼相對在當前卷上的根目錄,要麼相對於在指定卷上的當前目錄。使用
       file pathtype 命令來確定一個給定路徑的類型。

路徑語法 PATH SYNTAX
       本地名字的規則依賴於在 Tcl 數組元素 tcl_platform(platform) 中報告的值:

       mac       在 Apple  Macintosh  系統上,Tcl   支持兩種形式的路徑名。常規
                 Mac
                 式樣的名字使用分號作為路徑分隔符。路徑可以是相對的或絕對的,並且檔名中可以包含除了分號之外的任何字符。一個前導的分號導致路徑的剩餘部分被解釋成相對當前目錄。如果一個路徑包含一個不在開始處的分號,則路徑被解釋成一個絕對路徑。在路徑中任何地方的兩個或多個分號的序列被用做構造相對路徑,這裏的
                 :: 參照當前目錄的父目錄,::: 參照父目錄的父目錄,以此類推。

                 除了      Macintosh      式樣的名字,Tcl      還支持     Unix
                 式名字的一個子集。如果一個路徑不包含分號,則把它按一個   Unix
                 路徑來解釋。使用斜槓作為路徑分隔符。檔名  .  參照當前目錄,而
                 ..        參照當前目錄的父目錄。但是,像         //..的一些名字沒有映射,並被作為                     Macintosh
                 名字解釋。一般的,生成檔名的命令返回                Macintosh
                 式樣的名字,而接收檔名的命令接受     Macintosh     和    Unix
                 式樣的兩種名字。

                 下列例子展示不同形式的路徑名:

                 :              到當前檔案夾(folder)的相對路徑。

                 MyFile         到在當前檔案夾中的叫
                                MyFile的一個檔案的相對路徑。

                 MyDisk:MyFile  到在叫    MyDisk    的設備上的一個叫    MyFile
                                的檔案的絕對路徑。.

                 :MyDir:MyFile  到在當前檔案夾中的一個叫
                                MyDir的檔案夾中的一個叫                 MyFile
                                的檔案的相對路徑。

                 ::MyFile       到在當前檔案夾的上層檔案夾中的一個叫    MyFile
                                的檔案的相對路徑。

                 :::MyFile      到在當前檔案夾的上兩層檔案夾中的一個叫  MyFile
                                的檔案的相對路徑。

                 /MyDisk/MyFile 在叫    MyDisk     的設備上的一個叫     MyFile
                                的檔案的絕對路徑。

                 ../MyFile      到在當前檔案夾的上層檔案夾中的一個叫    MyFile
                                的檔案的相對路徑。

       unix      在                      Unix                      平台上,Tcl
                 使用的路徑名的組成部分由斜槓來分隔。路徑名可以是相對的或絕對的,並且檔名可以包含除斜槓之外的任何字符。檔名
                 ...
                 是特殊的並且分別參照當前目錄和當前目錄的父目錄。多個毗接的(adjacent)的斜槓被解釋為一個單一的分隔符。下列例子展示不同形式的路徑名:

                 /              到根目錄的絕對路徑。

                 /etc/passwd    到在根目錄中的   etc   目錄中的一個叫   passwd
                                的檔案的絕對路徑。

                 .              到當前目錄的相對路徑。

                 foo            Relative  path  to the file foo in the current
                                directory.

                 foo/bar        到在當前目錄中的一個叫 foo 的檔案的相對路徑。

                 ../foo         到在當前目錄中的目錄  foo  目錄中的一個叫  bar
                                的檔案的相對路徑。

       windows   在   Microsoft   Windows   平台上,Tcl  支持相對驅動器和  UNC
                 式樣的名字兩者。/\
                 二者都可用在兩種類型的名字中做分隔符。相對驅動器的名字由可選的驅動器指定符(specifier)和隨後的絕對或相對的路徑組成。UNC
                 路徑依從                     \\servername\sharename\path\file
                 的一般形式。在兩種形式中,檔名         ...
                 是特殊的並且分別參照當前目錄和當前目錄的父目錄。下列例子展示不同形式的路徑名:

                 \\Host\share/file
                                到在主機       Host      上的導出點      share
                                的根目錄中的一個叫   file   的檔案的絕對   UNC
                                路徑。

                 c:foo          到在驅動器    c   上的當前目錄中的一個叫   foo
                                的檔案的相對卷的路徑。

                 c:/foo         到在當前卷上的當前目錄中 foo 目錄中一個叫  bar
                                的檔案的絕對路徑。

                 foo\bar        到在當前卷上的當前目錄中  foo 目錄中一個叫 bar
                                的檔案的相對路徑。

                 \foo           到在當前卷的根目錄中的一個叫               foo
                                的檔案的相對卷的路徑。

波浪線替換 TILDE SUBSTITUTION
       除了上述檔名規則之外,Tcl                   還支持                  csh
       式樣的波浪線替換。如果一個檔名以一個波浪線開始,則按檔名的第一個元素被給定使用者的主目錄的位置所替換來解釋。如果波浪線之後立即跟隨著一個分隔符,則用
       $HOME
       環境變量來替換。否則在波浪線和下一個分隔符之間的的字符被接受為一個使用者名,它被用來檢索用於替換的使用者的主目錄。

       Macintosh                           和                          Windows
       不支持對波浪線跟隨一個使用者名的波浪線替換。在這些平台上,使用波浪線並跟隨一個使用者名的嘗試將生成一個錯誤。有一個波浪線而沒有使用者名的檔名將像
       Unix 一樣使用 $HOME 環境變量來替換。

移植要點 PORTABILITY ISSUES
       注意所有的檔案系統都是大小寫敏感的,所以稿本應避免依賴於在檔名中的字符大小寫的代碼。額外的,在不同設備上允許的字符集可能不同,所以稿本稿本應選擇不包含特殊字符如
       <>:"/\| 的檔名。最安全的方式是只使用由字母組成的使用者名。還有  Windows
       3.1 只支持有不多於8個字符的根和不多於3個字符的擴展的檔名。

關鍵字 KEYWORDS
       current  directory,  absolute  file  name,  relative file name, volume-
       relative file name, portability

參見 SEE ALSO
       file(n), glob(n)

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

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

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