'\"
'\" Copyright (c) 1995-1996 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: filename.n,v 1.2 2003/11/24 05:09:59 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: filename.n,v 1.2 2003/11/24 05:09:59 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 filename 3tcl 7.5 Tcl "Tcl Built-In Commands"
.BS
'\" Note:  do not modify the .SH NAME line immediately below!
.SH NAME
filename \- Tcl 命令支持的文件名轉換
.BE
.SH INTRODUCTION
.PP
所有接受文件名作爲參數的 Tcl 命令和 C 過程希望文件名是依賴於當前平臺的三種形式之一。在每種平臺上，Tcl 都支持這種平臺上的標準形式的文件名。額外的，在所有平臺上，Tcl 支持一種 Unix 式的語法，提供了一種方便的方式來構造簡單的文件名。但是，打算被移植的腳本不要假定特定形式的文件名。可移植的腳本必須使用 \fBfile split\fR 和 \fBfile join\fR 命令來操縱文件名(詳見\fBfile\fR 的手冊條目)。


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

.SH "路徑語法 PATH SYNTAX"
.PP
本地名字的規則依賴於在 Tcl 數組元素 \fBtcl_platform(platform) \fR中報告的值:
.TP 10
\fBmac\fR
在 Apple Macintosh 系統上，Tcl  支持兩種形式的路徑名。常規 Mac 式樣的名字使用分號作爲路徑分隔符。路徑可以是相對的或絕對的，並且文件名中可以包含除了分號之外的任何字符。一個前導的分號導致路徑的剩餘部分被解釋成相對當前目錄。如果一個路徑包含一個不在開始處的分號，則路徑被解釋成一個絕對路徑。在路徑中任何地方的兩個或多個分號的序列被用做構造相對路徑，這裏的 \fB::\fR 參照當前目錄的父目錄，\fB:::\fR 參照父目錄的父目錄，以此類推。
.RS
.PP
除了 Macintosh 式樣的名字，Tcl 還支持 Unix 式名字的一個子集。如果一個路徑不包含分號，則把它按一個  Unix 路徑來解釋。使用斜槓作爲路徑分隔符。文件名 \fB\&.\fR 參照當前目錄，而 \fB\&..\fR 參照當前目錄的父目錄。但是，象 \fB/\fR 或 \fB/..\fR的一些名字沒有映射，並被作爲 Macintosh 名字解釋。一般的，生成文件名的命令返回 Macintosh 式樣的名字，而接收文件名的命令接受 Macintosh 和 Unix 式樣的兩種名字。
.PP
下列例子展示不同形式的路徑名:
.TP 15
\fB:\fR
到當前文件夾(folder)的相對路徑。
.TP 15
\fBMyFile\fR
到在當前文件夾中的叫 \fBMyFile\fR的一個文件的相對路徑。
.TP 15
\fBMyDisk:MyFile\fR
到在叫 \fBMyDisk \fR的設備上的一個叫 \fBMyFile\fR 的文件的絕對路徑。.
.TP 15
\fB:MyDir:MyFile\fR
到在當前文件夾中的一個叫 \fBMyDir\fR的文件夾中的一個叫 \fBMyFile\fR 的文件的相對路徑。
.TP 15
\fB::MyFile\fR
到在當前文件夾的上層文件夾中的一個叫 \fBMyFile\fR 的文件的相對路徑。
.TP 15
\fB:::MyFile\fR
到在當前文件夾的上兩層文件夾中的一個叫 \fBMyFile\fR 的文件的相對路徑。
.TP 15
\fB/MyDisk/MyFile\fR
在叫 \fBMyDisk \fR的設備上的一個叫 \fBMyFile\fR 的文件的絕對路徑。
.TP 15
\fB\&../MyFile\fR
到在當前文件夾的上層文件夾中的一個叫 \fBMyFile\fR 的文件的相對路徑。
.RE
.TP
\fBunix\fR
在 Unix 平臺上，Tcl 使用的路徑名的組成部分由斜槓來分隔。路徑名可以是相對的或絕對的，並且文件名可以包含除斜槓之外的任何字符。文件名 \fB\&.\fR 和 \fB\&..\fR  是特殊的並且分別參照當前目錄和當前目錄的父目錄。多個毗接的(adjacent)的斜槓被解釋爲一個單一的分隔符。下列例子展示不同形式的路徑名:
.RS
.TP 15
\fB/\fR
到根目錄的絕對路徑。
.TP 15
\fB/etc/passwd\fR
到在根目錄中的 \fBetc\fR 目錄中的一個叫 \fBpasswd\fR 的文件的絕對路徑。
.TP 15
\fB\&.\fR
到當前目錄的相對路徑。
.TP 15
\fBfoo\fR
Relative path to the file \fBfoo\fR in the current directory.
.TP 15
\fBfoo/bar\fR
到在當前目錄中的一個叫 \fBfoo\fR 的文件的相對路徑。
.TP 15
\fB\&../foo\fR
到在當前目錄中的目錄 \fBfoo\fR 目錄中的一個叫 \fBbar\fR 的文件的相對路徑。
.RE
.TP
\fBwindows\fR
在 Microsoft Windows 平臺上，Tcl 支持相對驅動器和 UNC 式樣的名字兩者。\fB/\fR 和 \fB\e\fR 二者都可用在兩種類型的名字中做分隔符。相對驅動器的名字由可選的驅動器指定符(specifier)和隨後的絕對或相對的路徑組成。UNC 路徑依從 \fB\e\eservername\esharename\epath\efile\fR 的一般形式。在兩種形式中，文件名 \fB.\fR 和 \fB..\fR 是特殊的並且分別參照當前目錄和當前目錄的父目錄。下列例子展示不同形式的路徑名:
.RS
.TP 15
\fB\&\e\eHost\eshare/file\fR
到在主機 \fBHost \fR上的導出點 \fBshare\fR 的根目錄中的一個叫 \fBfile\fR 的文件的絕對 UNC 路徑。
.TP 15
\fBc:foo\fR
到在驅動器 \fBc \fR上的當前目錄中的一個叫 \fBfoo\fR 的文件的相對卷的路徑。
.TP 15
\fBc:/foo\fR
到在當前捲上的當前目錄中 \fBfoo\fR 目錄中一個叫 \fBbar\fR 的文件的絕對路徑。
.TP 15
\fBfoo\ebar\fR
到在當前捲上的當前目錄中 \fBfoo\fR 目錄中一個叫 \fBbar\fR 的文件的相對路徑。
.TP 15
\fB\&\efoo\fR
到在當前卷的根目錄中的一個叫 \fBfoo\fR 的文件的相對卷的路徑。
.RE

.SH "波浪線替換 TILDE SUBSTITUTION"
.PP
除了上述文件名規則之外，Tcl 還支持 csh 式樣的波浪線替換。如果一個文件名以一個波浪線開始，則按文件名的第一個元素被給定用戶的主目錄的位置所替換來解釋。如果波浪線之後立即跟隨着一個分隔符，則用 \fB$HOME\fR 環境變量來替換。否則在波浪線和下一個分隔符之間的的字符被接受爲一個用戶名，它被用來檢索用於替換的用戶的主目錄。
.PP
Macintosh 和 Windows 不支持對波浪線跟隨一個用戶名的波浪線替換。在這些平臺上，使用波浪線並跟隨一個用戶名的嘗試將生成一個錯誤。有一個波浪線而沒有用戶名的文件名將象 Unix 一樣使用 \fB$HOME\fR 環境變量來替換。

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

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

.SH "參見 SEE ALSO"
file(n), glob(n)

.SH "[中文版維護人]"
.B 寒蟬退士
.SH "[中文版最新更新]"
.B 2001/08/28
.SH "《中國 Linux 論壇 man 手冊頁翻譯計劃》:"
.BI http://cmpp.linuxforum.net
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR