file 表示一个连接到普通文件的 stdio 对象。open 为普通文件返回该类的一个实例。
| 序号 | 方法 & 描述 |
|---|---|
| 1 | file::atime( path) 返回 path 的最后访问时间。 |
| 2 | file::basename( path[, suffix]) 返回 path 末尾的文件名。如果指定了 suffix,则它会从文件名末尾被删除。 例如:file.basename("/home/users/bin/ruby.exe") #=> "ruby.exe" |
| 3 | file::blockdev?( path) 如果 path 是一个块设备,则返回 true。 |
| 4 | file::chardev?( path) 如果 path 是一个字符设备,则返回 true。 |
| 5 | file::chmod( mode, path...) 改变指定文件的权限模式。 |
| 6 | file::chown( owner, group, path...) 改变指定文件的所有者和所属组。 |
| 7 | file::ctime( path) 返回 path 的最后一个 inode 更改时间。 |
| 8 | file::delete( path...) file::unlink( path...) 删除指定的文件。 |
| 9 | file::directory?( path) 如果 path 是一个目录,则返回 true。 |
| 10 | file::dirname( path) 返回 path 的目录部分,不包括最后的文件名。 |
| 11 | file::executable?( path) 如果 path 是可执行的,则返回 true。 |
| 12 | file::executable_real?( path) 如果 path 通过真正的用户权限是可执行的,则返回 true。 |
| 13 | file::exist?( path) 如果 path 存在,则返回 true。 |
| 1 | file::expand_path( path[, dir]) 返回 path 的绝对路径,扩展 ~ 为进程所有者的主目录,~user 为用户的主目录。相对路径是相对于 dir 指定的目录,如果 dir 被省略则相对于当前工作目录。 |
| 14 | file::file?( path) 如果 path 是一个普通文件,则返回 true。 |
| 15 | file::ftype( path) 返回下列其中一个字符串,表示文件类型:
|
| 16 | file::grpowned?( path) 如果 path 由用户的所属组所有,则返回 true。 |
| 17 | file::join( item...) 返回一个字符串,由指定的项连接在一起,并使用 file::separator 进行分隔。 例如:file::join("", "home", "usrs", "bin") # => "/home/usrs/bin" |
| 18 | file::link( old, new) 创建一个到文件 old 的硬链接。 |
| 19 | file::lstat( path) 与 stat 相同,但是它返回自身符号链接上的信息,而不是所指向的文件。 |
| 20 | file::mtime( path) 返回 path 的最后一次修改时间。 |
| 21 | file::new( path[, mode="r"]) file::open( path[, mode="r"]) file::open( path[, mode="r"]) {|f| ...} 打开文件。如果指定了块,则通过传递新文件作为参数来执行块。当块退出时,文件会自动关闭。这些方法有别于 kernel.open,即使 path 是以 | 开头,后续的字符串也不会作为命令运行。 |
| 22 | file::owned?( path) 如果 path 由有效的用户所有,则返回 true。 |
| 23 | file::pipe?( path) 如果 path 是一个管道,则返回 true。 |
| 24 | file::readable?( path) 如果 path 是可读的,则返回 true。 |
| 25 | file::readable_real?( path) 如果 path 通过真正的用户权限是可读的,则返回 true。 |
| 25 | file::readlink( path) 返回 path 所指向的文件。 |
| 26 | file::rename( old, new) 改变文件名 old 为 new。 |
| 27 | file::setgid?( path) 如果设置了 path 的 set-group-id 权限位,则返回 true。 |
| 28 | file::setuid?( path) 如果设置了 path 的 set-user-id 权限位,则返回 true。 |
| 29 | file::size( path) 返回 path 的文件大小。 |
| 30 | file::size?( path) 返回 path 的文件大小,如果为 0 则返回 nil。 |
| 31 | file::socket?( path) 如果 path 是一个 socket,则返回 true。 |
| 32 | file::split( path) 返回一个数组,包含 path 的内容,path 被分成 file::dirname(path) 和 file::basename(path)。 |
| 33 | file::stat( path) 返回 path 上带有信息的 file::stat 对象。 |
| 34 | file::sticky?( path) 如果设置了 path 的 sticky 位,则返回 true。 |
| 35 | file::symlink( old, new) 创建一个指向文件 old 的符号链接。 |
| 36 | file::symlink?( path) 如果 path 是一个符号链接,则返回 true。 |
| 37 | file::truncate( path, len) 截断指定的文件为 len 字节。 |
| 38 | file::unlink( path...) 删除 path 给定的文件。 |
| 39 | file::umask([ mask]) 如果未指定参数,则为该进程返回当前的 umask。如果指定了一个参数,则设置了 umask,并返回旧的 umask。 |
| 40 | file::utime( atime, mtime, path...) 改变指定文件的访问和修改时间。 |
| 41 | file::writable?( path) 如果 path 是可写的,则返回 true。 |
| 42 | file::writable_real?( path) 如果 path 通过真正的用户权限是可写的,则返回 true。 |
| 43 | file::zero?( path) 如果 path 的文件大小是 0,则返回 true。 |
假设 f 是 file 类的一个实例:
| 序号 | 方法 & 描述 |
|---|---|
| 1 | f.atime 返回 f 的最后访问时间。 |
| 2 | f.chmode( mode) 改变 f 的权限模式。 |
| 3 | f.chown( owner, group) 改变 f 的所有者和所属组。 |
| 4 | f.ctime 返回 f 的最后一个 inode 更改时间。 |
| 5 | f.flock( op) 调用 flock(2)。op 可以是 0 或一个逻辑值或 file 类常量 lock_ex、lock_nb、lock_sh 和 lock_un。 |
| 6 | f.lstat 与 stat 相同,但是它返回自身符号链接上的信息,而不是所指向的文件。 |
| 7 | f.mtime 返回 f 的最后修改时间。 |
| 8 | f.path 返回用于创建 f 的路径名。 |
| 9 | f.reopen( path[, mode="r"]) 重新打开文件。 |
| 10 | f.truncate( len) 截断 f 为 len 字节。 |