Ruby File 類和方法

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 位元組。