File

前 - 上 - 次 - 目次

File

ファイルアクセスのためのクラス．通常 open を使ってオープンされます．このクラスには FileTest で定義されているのと同じ特異メソッドが定義されています．

スーパークラス:

IO

クラスメソッド:

atime(filename)

ファイルの最終アクセス時刻を返します．

basename(filename[, suffix])

filenameの一番後ろのスラッシュに続く要素を返します．もし，引数suffixが与えられて，かつそれが filenameの末尾に一致するなら，それを取り除いたものを返します．

例:

basename("ruby/ruby.c")
	=> "ruby.c"
basename("ruby/ruby.c", ".c")
  => "ruby"

ctime(filename)

ファイルの状態が最後に変更された時刻を返します．

chmod(mode, path...)

ファイルのモードをmodeに変更します．モードを変更したファイルの数を返します．

chown(owner, group, filename...)

ファイルのオーナーとグループを変更します．スーパーユーザだけがファイルのオーナーとグループを変更できます．変更を行ったファイルの数を返します．

nil または -1 を指定することでオーナーやグループを現在のままにすることができます．

dirname(filename)

filenameの一番後ろのスラッシュに続く要素以外を文字列として返します．スラッシュを含まないファイル名に対しては "."(カレントディレクトリ)を返します．

expand_path(path[,default_dir])

pathを絶対パスに展開します．パスが相対パスであればdefault_dirを基準にします． default_dirがnilかまたは与えられなかった時にはカレントディレクトリが使われます．先頭の`~'はホームディレクトリに，`~USER' はそのユーザのホームディレクトリに展開されます．

expand_path("..")
       => "/home/matz/work"
expand_path("~")
       => "/home/matz"
expand_path("~matz")
       => "/home/matz"

join(items...)

File::Separatorを間に入れて，文字列を連結します．


[items,..].join(File::Separator)

も同じ動作をします．

ftype(filename)

ファイルのタイプを表す文字列を返します．文字列は以下のうちのいずれかです．

"file"
"directory"
"characterSpecial"
"blockSpecial"
"fifo"
"link"
"socket"

link(old, new)

oldを指すnewという名前のハードリンクを生成します．oldはすでに存在している必要があります．

lstat(filename)

statと同様にファイルの状態を返しますが，シンボリックリンクに関してリンクそのものの情報を返します．

mtime(filename)

ファイルの最終更新時刻を返します．

open(path[, mode])

new(path[, mode [, perm]])

pathで指定されるファイルをオープンし，ファイルオブジェクトを返します．

modeが文字列の場合、fopen(3)のように"r", "r+", "w", "w+", "a", "a+"のいずれかでファイルのモードを指定します．permは無視されます．modeが省略された時のデフォルトは "r"です．

modeが整数の場合、open(2)の第2引数と同様にRDONLY, WRONLY, RDWRのいずれかでファイルのモードを指定します．さらにAPPEND, CREAT, EXCL, NONBLOCK, TRUNC, NOCTTY, BINARYを一つ以上|でOR結合することで属性を指定することができます． permは open(2)の第3引数と同じく、CREAT時のファイルのアクセス権を整数で指定します．これらの定数はFileクラスで定義されています．

ブロックを指定して呼び出した場合は、ファイルオブジェクトを与えられてブロックが実行されます．ブロックの実行が終了すると、ファイルは自動的にクローズされます．

readlink(path)

シンボリックリンクのリンク先を文字列で返します．

rename(from, to)

ファイルの名前を変更します．ディレクトリが異なる場合には移動も行います．rename(2)を参照してください．移動先のファイルが存在する時には上書きされます．

size(pathname)

pathnameで指定したファイルの大きさ(バイト数)を返します．

split(pathname)

pathnameをdirnameと basenameに分割して，2要素の配列を返します．

stat(filename)

filenameの情報を含むStat構造体を返します． Stat構造体のメンバは以下の通りです．

dev	 	# デバイス番号(ファイルシステム)
ino		# i-node番号
mode		# ファイルモード
nlink		# ハードリンクの数
uid		# オーナーのユーザID
gid		# オーナーのグループID
rdev		# デバイスタイプ(スペシャルファイルのみ)
size		# ファイルサイズ(バイト単位)
blksize		# 望ましいI/Oのブロックサイズ
blocks		# 割り当てられているブロック数
atime		# 最終アクセス時刻
mtime		# 最終更新時刻
ctime		# 最終i-node変更時刻

より詳細はstat(2)してください．システムによってサポートされていないメンバには0が入っています．

symlink(old, new)