Ruby File 類別和方法


File 表示一個連接到普通檔案的 stdio 物件。 open 為普通檔案傳回該類別的一個實例。

類別方法

#序號#方法& 描述
1File::atime( path)
傳回path 的最後存取時間。
2File::basename( path[, suffix])
傳回path 結尾的文件名。如果指定了 suffix，則它會從檔案名稱末尾被刪除。
例如：File.basename("/home/users/bin/ruby.exe") #=> "ruby.exe"
3 File::blockdev?( path)
如果path 是區塊設備，則傳回true。
4File::chardev?( path)
如果 path 是字元設備，則傳回 true。
5File::chmod( mode, path...)
改變指定檔案的權限模式。
6File::chown( owner, group, path...)
改變指定檔案的擁有者和所屬組。
7File::ctime( path)
傳回 path 的最後一個 inode 變更時間。
8File::delete( path...)
File::unlink( path...)
#刪除指定的檔案。
9File::directory?( path)
如果 path 是目錄，則傳回 true。
10File::dirname( path)
傳回 path 的目錄部分，不包含最後的檔案名稱。
11File::executable?( path)
如果 path 是可執行的，則傳回 true。
12File::executable_real?( path)
#如果path 透過真正的使用者權限是可執行的，則傳回true。
13File::exist?( path)
如果 path 存在，則傳回 true。
1File::expand_path( path[, dir])
傳回path 的絕對路徑，擴充~ 為進程所有者的主目錄，~user 為使用者的主目錄。相對路徑是相對於 dir 指定的目錄，如果 dir 被省略則相對於目前工作目錄。
14File::file?( path)
如果 path 是一個普通文件，則傳回 true。
15File::ftype( path)
傳回下列其中一個字串，表示檔案類型：

  • file - 普通檔案

  • directory - 目錄

  • characterSpecial - 字元特殊檔案

  • blockSpecial - 區塊特殊檔案

  • fifo - 命名管道（FIFO）

  • link - 符號連結

  • socket - Socket

  • #unknown - 未知的檔案類型

16File::grpowned?( path)
如果path 由使用者的所屬群組擁有，則傳回true。
17File::join( item...)
傳回字串，由指定的項目連接在一起，並使用File::Separator 進行分隔。
例如：File::join("", "home", "usrs", "bin") # => "/home/usrs/bin"
18 File::link( old, new)
建立一個到檔案old 的硬連結。
19File::lstat( path)
與stat 相同，但是它傳回自身符號連結上的信息，而不是所指的文件。
20File::mtime( path)
傳回 path 的最後一次修改時間。
21File::new( path[, mode="r"])
File::open( path[, mode= "r"])
File::open( path[, mode="r"]) {|f| ...}
開啟檔案。如果指定了區塊，則透過傳遞新檔案作為參數來執行區塊。當區塊退出時，檔案會自動關閉。這些方法有別於 Kernel.open，即使 path 是以 | 開頭，後續的字串也不會作為指令運行。
22File::owned?( path)
如果 path 由有效的使用者擁有，則傳回 true。
23File::pipe?( path)
如果 path 是管道，則傳回 true。
24File::readable?( path)
如果 path 是可讀取的，則傳回 true。
25File::readable_real?( path)
如果path 透過真正的使用者權限是可讀的，則傳回true。
25File::readlink( path)
傳回 path 所指向的檔案。
26File::rename( old, new)
改變檔案名稱 old 為 new。
27File::setgid?( path)
如果設定了path 的set-group-id 權限位，則傳回true。
28File::setuid?( path)
如果設定了path 的set-user-id 權限位，則傳回true。
29File::size( path)
傳回 path 的檔案大小。
30File::size?( path)
傳回 path 的檔案大小，如果為 0 則傳回 nil。
31File::socket?( path)
如果 path 是 socket，則傳回 true。
32File::split( path)
傳回一個數組，包含path 的內容，path 被分成File:: dirname(path) 和File::basename(path)。
33File::stat( path)
傳回 path 上帶有資訊的 File::Stat 物件。
34File::sticky?( path)
如果設定了 path 的 sticky 位，則傳回 true。
35File::symlink( old, new)
建立一個指向檔案 old 的符號連結。
36File::symlink?( path)
如果 path 是符號鏈接，則傳回 true。
37File::truncate( path, len)
#截斷指定的檔案為 len 位元組。
38File::unlink( path...)
刪除 path 給定的檔案。
39File::umask([ mask])
如果未指定參數，則為該進程傳回目前的umask 。如果指定了一個參數，則設定了 umask，並傳回舊的 umask。
40File::utime( atime, mtime, path...)
改變指定檔案的存取和修改時間。
41File::writable?( path)
如果 path 是可寫的，則傳回 true。
42File::writable_real?( path)
#如果path 透過真正的使用者權限是可寫的，則傳回true。
43File::zero?( path)
如果 path 的檔案大小是 0，則傳回 true。

實例方法

假設f 是File 類別的一個實例：

序號方法& 描述
#1f.atime
返回f 的最後造訪時間。
2f.chmode( mode)
改變 f 的權限模式。
3f.chown( owner, group)
改變 f 的擁有者和所屬群組。
4f.ctime
#返回 f 的最後一個 inode 更改時間。
5f.flock( op)
呼叫 flock(2)。 op 可以是 0 或一個邏輯值或 File 類別常數 LOCK_EX、LOCK_NB、LOCK_SH 和 LOCK_UN。
6f.lstat
與stat 相同，但是它會傳回自身符號連結上的訊息，而不是所指向的文件。
7f.mtime
#傳回 f 的最後修改時間。
8f.path
傳回用於建立 f 的路徑名。
9f.reopen( path[, mode="r"])
重新開啟檔案。
10f.truncate( len)
截斷 f 為 len 位元組。
#