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 字節。