当先锋百科网

首页 1 2 3 4 5 6 7

前言

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

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。

实例方法
假设 fFile 类的一个实例:

序号方法 & 描述
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 字节。

Ruby Dir 类和方法

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

类方法

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

实例方法
假设 dDir 类的一个实例:

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