Ruby File 類和方法

File 表示一個連接到普通檔的 stdio 對象。open 為普通檔返回該類的一個實例。

類方法

序號方法 & 描述
1File::atime( path)
返回 path 的最後訪問時間。
2File::basename( path[, suffix])
返回 path 末尾的檔案名。如果指定了 suffix，則它會從檔案名末尾被刪除。
例如：File.basename("/home/users/bin/ruby.exe") #=> "ruby.exe"
3File::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"
18File::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 位元組。