file

NAME

總覽 SYNOPSIS

描述 DESCRIPTION

file atime name ?time?

返回一個十進位制字串，給出檔案 name 上次被訪問的時間。如果指定了 time，它是這個檔案要設定成的訪問時間。這個時間是用標準的 POSIX 方式(fashion)度量的，即從一個固定的開始時間至今的秒數(通常是1970年1月1日)。如果檔案不存在或它的訪問時間不可查詢或設定則生成一個錯誤。在 Windows 上，FAT 檔案系統不支援訪問時間。

file attributes name

 

file attributes name ?option?

 

file attributes name ?option value option value...?

file channels ?pattern?

如果沒有指定 pattern，則返回所有在這個直譯器中註冊的開啟通道的一個列表。如果指定了 pattern，則只返回匹配pattern 的名字。確定匹配使用與 string match 相同的規則。

file copy ?-force? ?--? source target

 

file copy ?-force? ?--? source ?source ...? targetDir

file delete ?-force? ?--? pathname ? pathname ... ?

刪除由每個 pathname 引數所指定的檔案或目錄。只有指定 -force選項才刪除非空目錄。嘗試刪除一個不存在檔案將導致不作為一個錯誤來考慮。即使沒有指定 -force 項，嘗試刪除一個只讀檔案將導致檔案被刪除。引數按指定的次序被處理，如果有錯誤的話，在第一個錯誤處停止(halt)。一個 -- 標記選項的結束；在 -- 之後的引數即使以 - 開始將仍被作為一個 pathname來對待。

file dirname name

返回一個名字，由在 name 中除了最後一個之外的所有路徑組成部分(component)組成。如果 name 是一個相對的檔名並且只包含一個路徑元素(element)，則返回“ .” (在 Macintosh 上為“:”)。如果 name 參照一個根目錄，則返回根目錄。例如，

file dirname c:/

file dirname ~/src/foo.c

file dirname ~

file executable name

如果檔案對當前使用者是可執行的則返回 1，否則返回0。

file exists name

如果檔案 name 存在並且當前的使用者對找到(lead to)它(所途徑)的目錄有查詢的權利(privilege)則返回 1，否則返回 0。

file extension name

返回在 name 最後那個元素的最後一個點號之後幷包括點號的所有在 name中字元。如果在 name 的最後的那個元素中沒有點號則返回空串。

file isdirectory name

如果檔案 name 是一個目錄則返回 1，否則返回 0。

file isfile name

如果檔案 name 是一個普通檔案則返回 1，否則返回 0。

file join name ?name ...?

接受一個或多個檔名並使用對當前平臺正確的路徑分隔符來組合它們。如果特定的 name是相對的，則它會被連線到前面的檔名引數上。否則，丟棄所有以前的引數，從當前的引數開始進行連線。例如

file join a b /foo bar

file lstat name varName

除了使用 lstat 呼叫而不使用 stat 之外，與 stat 選項(見後)相同。這意味著如果 name 參照一個符號連線，在 varName 中返回的資訊是針對這個連線而不是它所引用的那個檔案。在不支援符號連線的系統上這個選項的行為與 stat選項完全一致。

file mkdir dir ?dir ...?

建立每個指定的目錄。對於每個指定的路徑名 dir ，象 dir 自身一樣，這個命令將建立所有不存在的父目錄。如果指定了一個現存的目錄，不做動作並不返回錯誤。嘗試用一個目錄覆寫一個現存的檔案將導致一個錯誤。引數按指定的次序被處理，如果有錯誤的話，在第一個錯誤處停止(halt)。

file mtime name ?time?

返回一個十進位制字串，給出檔案 name上次被修改的時間。如果指定了time ，它是這個檔案要設定成的修改時間。(等價與 Unix 的 touch)。這個時間是用標準的 POSIX 方式(fashion)度量的，即從一個固定的開始時間至今的秒數(通常是1970年1月1日)。如果檔案不存在或它的修改時間不可查詢或設定則生成一個錯誤。

file nativename name

返回檔案的特定於平臺的名字。如果這個檔名需要傳遞給特定於系統的呼叫，比如對在 Windows 下的 exec 或在 Macintosh 上的 AppleScript 將會有用。

file owned name

如果檔案 name 由當前使用者所有則返回 1，否則返回 0。

file pathtype name

返回 absolute、relative、 volumerelative 中的一個。如果 name 參照一個在指定捲上的指定檔案，路徑型別將是 absolute。如果 name 參照一個相對當前工作目錄的一個檔案，則路徑型別將是 relative。如果 name 參照在指定捲上的相對於當前工作目錄的一個檔案，或者在當前工作捲上的指定檔案，則路徑型別是 volumerelative。

file readable name

如果檔案 name 對當前使用者是可讀的則返回 1，否則返回0。

file readlink name

返回由 name 給出的符號連線的值(比如，它指向的檔案的名字)。如果 name 不是符號連線或它的值不可讀，則返回一個錯誤。在不支援符號連線的系統上這個選項未定義。

file rename ?-force? ?--? source target

file rename ?-force? ?--? source ? source ...? targetDir

file rootname name

返回 name 的最後一個組成部分的最後一個“.”之前但不包括這個“.”的 name中的所有字元。如果 name 的最後的組成部分不包含點號，則返回 name。

file size name

返回給出檔案 name 的大小的以位元組為單位的一個十進位制字串。如果檔案不存在或它的大小不可查詢則生成一個錯誤。

file split name

返回一個列表，它的元素是在 name 中的路徑的組成部分。列表的第一個元素將與 name 有相同的路徑型別。所有其他元素將是相對的。除了需要確保一個元素是相對的而無歧義之外，丟棄路徑分隔符。例如，在 Unix 下

file split /foo/~bar/baz

file stat name varName

在 name 上呼叫 stat 核心呼叫，並且使用由 varName 給出的變數來持有從核心呼叫返回的資訊。 VarName 被作為一個數組變數來對待，並且給這個變數設定下列元素: atime、ctime、dev、gid、ino、mode、mtime、nlink、size、type、uid。除了 type之外的每個元素都是一個十進位制字串，它們的值來自從 stat 返回的結構中相應的欄位。這些值的意義詳見 stat 的手冊條目。type 元素給出的檔案型別與命令 file type 返回的有相同的形式。這個命令返回一個空串。

file tail name

返回在最後一個目錄分隔符之後的在 name中的所有字元。如果 name 不包含分隔符則返回 name。

file type name

返回給出檔案 name 的型別的一個字串，它將是 file、directory、characterSpecial、 blockSpecial、fifo、link、或 socket 中的一個。

file volume

返回一個適當的 Tcl 列表，給出到掛裝在系統上的卷的絕對路徑。在Macintosh上，將是掛裝驅動器的一個列表，包括本地的和網路的二者。N.B.(?)如果兩個驅動器有相同的名字，它們都將出現在卷列表上，但當前沒有辦法從Tcl 來訪問除了第一個之外的任何驅動器。在 UNIX 上，命令將總是返回 "/"，因為所有檔案系統都是本地掛裝的。在 Windows 上，它將返回可獲得的本地驅動器的一個列表(比如，{a:/ c:/})。

file writable name

如果檔案 name 對當前使用者是可寫的則返回 1，否則返回 0。

移植要點 PORTABILITY ISSUES

Unix       

這些命令總是使用真實使用者和組標識而不使用有效使用者和組標識。

參見 SEE ALSO

關鍵字 KEYWORDS

[中文版維護人]

[中文版最新更新]

《中國 Linux 論壇 man 手冊頁翻譯計劃》:

跋