【Ruby学习笔记】14.Ruby File 类和方法及Dir 类和方法

前言

本章介绍Ruby的File 类和方法及Dir 类和方法。

Ruby File 类和方法

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) 返回下列其中一个字符串，表示文件类型： file - 普通文件 directory - 目录 characterSpecial - 字符特殊文件 blockSpecial - 块特殊文件 fifo - 命名管道（FIFO） link - 符号链接 socket - Socket unknown - 未知的文件类型
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 字节。

Ruby Dir 类和方法

Dir 是一个表示用于给出操作系统中目录中的文件名的目录流。Dir 类也拥有与目录相关的操作，比如通配符文件名匹配、改变工作目录等。

类方法

序号	方法 & 描述
1	Dir[pat] Dir::glob( pat) 返回一个数组，包含与指定的通配符模式 pat 匹配的文件名： * - 匹配包含 null 字符串的任意字符串 ** - 递归地匹配任意字符串 ? - 匹配任意单个字符 […] - 匹配封闭字符中的任意一个 {a,b…} - 匹配字符串中的任意一个 Dir[“foo.*”] # 匹配 “foo.c”、 “foo.rb” 等等 Dir[“foo.?”] # 匹配 “foo.c”、 “foo.h” 等等
2	Dir::chdir( path) 改变当前目录。
3	Dir::chroot( path) 改变根目录（只允许超级用户）。并不是在所有的平台上都可用。
4	Dir::delete( path) 删除 path 指定的目录。目录必须是空的。
5	Dir::entries( path) 返回一个数组，包含目录 path 中的文件名。
6	Dir::foreach( path) {| f| …} 为 path 指定的目录中的每个文件执行一次块。
7	Dir::getwd Dir::pwd 返回当前目录。
8	Dir::mkdir( path[, mode=0777]) 创建 path 指定的目录。权限模式可被 File::umask 的值修改，在 Win32 的平台上会被忽略。
9	Dir::new( path) Dir::open( path) Dir::open( path) {| dir| …} 返回 path 的新目录对象。如果 open 给出一个块，则新目录对象会传到该块，块会在终止前关闭目录对象。
10	Dir::pwd 参见 Dir::getwd。
11	Dir::rmdir( path) Dir::unlink( path) Dir::delete( path) 删除 path 指定的目录。目录必须是空的。

实例方法
假设 d 是 Dir 类的一个实例：

序号	方法 & 描述
1	d.close 关闭目录流。
2	d.each {| f| …} 为 d 中的每一个条目执行一次块。
3	d.pos d.tell 返回 d 中的当前位置。
4	d.pos= offset 设置目录流中的位置。
5	d.pos= pos d.seek(pos) 移动到 d 中的某个位置。pos 必须是一个由 d.pos 返回的值或 0。
6	d.read 返回 d 的下一个条目。
7	d.rewind 移动 d 中的位置到第一个条目。
8	d.seek(po s) 参见 d.pos=pos。
9	d.tell 参见 d.pos。