'\"
'\" Copyright (c) 1993 The Regents of the University of California.
'\" Copyright (c) 1994-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: glob.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: glob.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 glob 3tcl 8.3 Tcl "Tcl Built-In Commands"
.BS
'\" Note:  do not modify the .SH NAME line immediately below!
.SH NAME
glob \- 返回匹配模式的檔名
.SH "總覽 SYNOPSIS"
\fBglob \fR?\fIswitches\fR? \fIpattern \fR?\fIpattern ...\fR?
.BE

.SH "描述 DESCRIPTION"
.PP
這個命令用與 csh shell 類似的方式進行檔名的“萬用字元匹配”。它返回檔名匹配 \fIpattern\fR (模式)引數中的所有檔案的一個列表。
.LP
如果給 \fBglob\fR 的初始引數以 \fB\-\fR 開始，則它們將被作為選項來對待。當前支援下列選項開關: 
.VS 8.3
.TP
\fB\-directory\fR \fIdirectory\fR
在這個給定的 \fIdirectory \fR(目錄)中開始查詢匹配給定模式的檔案。這允許查詢名字中包含萬用字元敏感字元的目錄而不需要顯式的引用這些字元。這個選項不能與\fB\-path\fR 聯合使用。
.TP
\fB\-join\fR
把透過剩餘的模式引數用目錄分隔符連線起來作為一個單一的模式來對待。  
.VE 8.3
.TP
\fB\-nocomplain\fR
允許返回一個空列表而不是返回一個錯誤；要是沒有這個開關的話，如果結果列表為空則返回一個錯誤。
.VS 8.3
.TP
\fB\-path\fR \fIpathPrefix\fR
查詢有給定的 \fIpathPrefix\fR  (路徑字首)的檔案，名字中餘下的部分匹配給定模式。這個選項允許查詢與一個給定檔案有類似的名字的檔案，包括名字中包含萬用字元敏感的字元的情況。這個選項不能與\fB-directory\fR 聯合使用。
.TP
\fB\-types\fR \fItypeList\fR
只列出匹配 \fItypeList \fR(型別列表)的檔案或目錄，在這個列表中的元素有兩種形式。第一種形式類似 Unix find 命令的 -type 選項:     
\fIb\fR (塊特殊檔案 block special file),
\fIc\fR (字元特殊檔案 character special file),
\fId\fR (目錄 directory),
\fIf\fR (單純檔案 plain file),
\fIl\fR (符號連線 symbolic link),
\fIp\fR (命名管道 named pipe),
or \fIs\fR (套介面 socket), 
在這個列表中可以指定多個型別。\fBGlob\fR 返回至少匹配一個型別的所有檔案。
.RS
.PP
對於第二種形式指定的型別，所有給出的型別都必須匹配。它們是作為檔案許可權的 \fIr\fR、\fIw\fR、\fIx\fR和作為特殊許可權的例項的 \fIreadonly\fR、\fIhidden\fR。在 Macintosh 上，還支援 MacOS 型別和建立者，假定任何四個字元長的專案都是一個 MacOS  型別(例如 \fBTEXT\fR)。有\fI{macintosh type XXXX}\fR 或 \fI{macintosh creator XXXX} \fR形式的專案將分別的匹配型別或建立者。不可識別的型別，或多個 MacOS 型別/建立者指定將導致錯誤。
.PP
以混合兩種型別，所以 \fB-types {d f r w}\fR 將找到有讀\fB和\fR寫許可權的正規檔案\fB或\fR目錄。下列命令等價:    
.RS
.CS
\fBglob \-type d *\fR
\fBglob */\fR
.CE
.RE
但第一種情況不返回尾部的 ``/'' 並且更加不依賴平臺。
.RE
.VE 8.3
.TP
\fB\-\|\-\fR
標誌著選項的結束。此後的引數即使以 \fB- \fR開始仍將被作為\fIpattern\fR  對待。         
.PP
\fIpattern\fR  引數可以包含任意下列特殊字元:  
.TP 10
\fB?\fR
匹配任何單一字元。
.TP 10
\fB*\fR
匹配零個或多個字元的任何序列。
.TP 10
\fB[\fIchars\fB]\fR
匹配在 \fIchars \fR中的任何單一字元。如果 \fIchars\fR 包含 \fIa\fR\fB-\fR\fIb\fR  形式的一個序列則匹配在 \fIa\fR 和 \fIb\fR  之間(包括它們在內)的任何字元。        
.TP 10
\fB\e\fIx\fR
匹配字元 \fIx\fR。
.TP 10
\fB{\fIa\fB,\fIb\fB,\fI...\fR}
匹配字串 \fIa\fR、\fIb\fR\fI \fR等中的任何一個。  
.LP
與 csh 一樣， 在一個檔案的名字的開始處或緊隨“/”之後的那個“.”必須被顯式的(explicit)匹配或與一個 {}  構造(construct)相匹配。額外的，所有“/”字元必須顯式的匹配。
.LP
如果在一個 \fIpattern\fR中的第一個是“~”，則它參照一個使用者的主目錄，這個使用者的名字緊隨在“~”之後。如果 “~”的後面緊隨著一個“/”，則使用 HOME 環境變數的值。
.LP
\fBglob\fR與 csh globbing 在兩個方面有區別。首先，它不排序它的結果列表(如果你想排序的話使用 \fBlsort\fR 命令)。其次，\fBglob\fR  只返回實際存在的檔案的名字；在 csh  中除非一個模式包含一個 ?、*、或 [] 構造，否則不檢查檔案是否存在。

.SH "移植要點 PORTABILITY ISSUES"
.PP
不象其他 Tcl 命令那樣接受網路和本地式樣的兩種名字(關於如何指定本地和網路名字的詳情參見 \fBfilename\fR手冊條目)，而 \fBglob\fR  命令只接受本地名字。

.TP
\fBWindows\fR
.
對於 Windows UNC 名字，路徑組成部分中的伺服器名和共享名不能包含?、*、或 [] 構造。在 Windows NT 上，如果 \fIpattern\fR  有 ``\fB~\fIusername\fB@\fIdomain\fR'' 的形式，則它參照一個使用者的主目錄，這個使用者的帳號資訊駐留在指定 NT  域控制器上。否則，從本地計算機獲取使用者帳號資訊。在 Windows 95  和 98 上，\fBglob\fR  接受象“.../” 和 “..../”這樣的模式，用於連續的更上層的父目錄。 

.TP 
\fBMacintosh\fR 
. 
在使用了選項 \fB\-dir\fR、\fB\-join\fR 或 \fB\-path \fR的時候，glob 假定給整個模式的目錄分隔符是標準的“:”。在不使用這些選項的時候，glob  檢查每個模式引數，除非這個模式包含一個“:”，否則使用“/”。

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

.SH "關鍵字 KEYWORDS"
exist, file, glob, pattern

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