検索結果

ARGF.class#file -> IO (78424.0)

• 3.1

• インスタンスメソッド

現在開いている処理対象の File オブジェクト(または IO オブジェ クト)を返します。

現在開いている処理対象の File オブジェクト(または IO オブジェ
クト)を返します。

$ echo "foo" > foo
$ echo "bar" > bar

$ ruby argf.rb foo bar

ARGF.file # => #<File:foo>
ARGF.read(5) # => "foo\nb"
ARGF.file # => #<File:bar>

ARGFが現在開いている処理対象が標準入力の場合、$stdin を返します。

• ARGF.class
• File
• IO

File.file?(path) -> bool (69352.0)

• 3.1

• 特異メソッド

FileTest.#file? と同じです。

FileTest.#file? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.lstat(filename) -> File::Stat (51838.0)

• 3.1

• 特異メソッド

File.statと同様ですが、シンボリックリンクに関してリンクそのものの 情報を File::Stat として返します。lstat(2) を実装していないシステムでは、File.stat と同じです。

File.statと同様ですが、シンボリックリンクに関してリンクそのものの
情報を File::Stat として返します。lstat(2) を実装していないシステムでは、File.stat と同じです。

@param filename ファイル名を表す文字列を指定します。

@raise Errno::EXXX 情報の取得に失敗した場合に発生します。

//emlist[例][ruby]{
# link.rb は t.rb のシンボリックリンク
File.lstat("link.rb") == File.stat("t.rb") # => false
File.stat("link.rb...

• File

File.stat(filename) -> File::Stat (51724.0)

• 3.1

• 特異メソッド

filename の情報を含む File::Stat オブジェクトを生成し て返します。

filename の情報を含む File::Stat オブジェクトを生成し
て返します。

@param filename ファイル名を表す文字列を指定します。

@raise Errno::EXXX 情報の取得に失敗した場合に発生します。

//emlist[例][ruby]{
File.stat("testfile").class # => File::Stat
File.stat("testfile").mtime # => 2017-12-10 01:13:56 +0900
//}

@see IO#stat, File#lstat

• File
• File::Stat

FileTest.#file?(file) -> bool (51715.0)

• 3.1

• モジュール関数

ファイルが通常ファイルである時に真を返します。そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

ファイルが通常ファイルである時に真を返します。そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

@param file ファイル名を表す文字列か IO オブジェクトを指定します。

@raise IOError 指定された IO オブジェクト file が既に close されていた場合に発生します。

例:
FileTest.file?('/bin/bash') # => true
FileTest.file?('/bin') # => false
FileTest.file?('/no_such_file') ...

• FileTest

絞り込み条件を変える

File.fnmatch(pattern, path, flags = 0) -> bool (51613.0)

• 3.1

• 特異メソッド

ファイル名のパターンマッチ fnmatch(3) を行います。 path が pattern にマッチすれば真を返します。そうでない場合には false を返します。

ファイル名のパターンマッチ fnmatch(3) を行います。
path が pattern にマッチすれば真を返します。そうでない場合には false を返します。

@param pattern パターンを文字列で指定します。ワイルドカードとして `*',
`**`, `?', `[]', `{}' が使用できます。
//emlist[例][ruby]{
%w(foo foobar bar).each {|f|
p File.fnmatch("foo*", f)
}
# => true
# true
# false
//}

@param p...

• File
• File::Constants

File.fnmatch?(pattern, path, flags = 0) -> bool (51613.0)

• 3.1

• 特異メソッド

ファイル名のパターンマッチ fnmatch(3) を行います。 path が pattern にマッチすれば真を返します。そうでない場合には false を返します。

ファイル名のパターンマッチ fnmatch(3) を行います。
path が pattern にマッチすれば真を返します。そうでない場合には false を返します。

@param pattern パターンを文字列で指定します。ワイルドカードとして `*',
`**`, `?', `[]', `{}' が使用できます。
//emlist[例][ruby]{
%w(foo foobar bar).each {|f|
p File.fnmatch("foo*", f)
}
# => true
# true
# false
//}

@param p...

• File
• File::Constants

File.identical?(filename1, filename2) -> bool (51601.0)

• 3.1

• 特異メソッド

FileTest.#identical? と同じです。

FileTest.#identical? と同じです。

@param filename1 パスを表す文字列か IO オブジェクトを指定します。

@param filename2 パスを表す文字列か IO オブジェクトを指定します。

• File

File.new(path, mode = "r", perm = 0666) -> File (51556.0)

• 3.1

• 特異メソッド

path で指定されるファイルをオープンし、File オブジェクトを生成して 返します。

path で指定されるファイルをオープンし、File オブジェクトを生成して
返します。

path が整数の場合はファイルディスクリプタとして扱い、それに対応する
File オブジェクトを生成して返します。IO.open と同じです。
ブロックを指定して呼び出した場合は、File オブジェクトを引数として
ブロックを実行します。ブロックの実行が終了すると、ファイルは自動的に
クローズされます。ブロックの実行結果を返します。

@param path ファイルを文字列で指定します。整数を指定した場合はファイルディスクリプタとして扱います。

@param mode モードを文字列か定数の論理...

• File

File.open(path, mode = "r", perm = 0666) -> File (51556.0)

• 3.1

• 特異メソッド

path で指定されるファイルをオープンし、File オブジェクトを生成して 返します。

path で指定されるファイルをオープンし、File オブジェクトを生成して
返します。

path が整数の場合はファイルディスクリプタとして扱い、それに対応する
File オブジェクトを生成して返します。IO.open と同じです。
ブロックを指定して呼び出した場合は、File オブジェクトを引数として
ブロックを実行します。ブロックの実行が終了すると、ファイルは自動的に
クローズされます。ブロックの実行結果を返します。

@param path ファイルを文字列で指定します。整数を指定した場合はファイルディスクリプタとして扱います。

@param mode モードを文字列か定数の論理...

• File

絞り込み条件を変える

File.open(path, mode = "r", perm = 0666) {|file| ... } -> object (51556.0)

• 3.1

• 特異メソッド

path で指定されるファイルをオープンし、File オブジェクトを生成して 返します。

path で指定されるファイルをオープンし、File オブジェクトを生成して
返します。

path が整数の場合はファイルディスクリプタとして扱い、それに対応する
File オブジェクトを生成して返します。IO.open と同じです。
ブロックを指定して呼び出した場合は、File オブジェクトを引数として
ブロックを実行します。ブロックの実行が終了すると、ファイルは自動的に
クローズされます。ブロックの実行結果を返します。

@param path ファイルを文字列で指定します。整数を指定した場合はファイルディスクリプタとして扱います。

@param mode モードを文字列か定数の論理...

• File

File.dirname(filename, level=1) -> String (51499.0)

• 3.1

• 特異メソッド

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

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

//emlist[例][ruby]{
p File.dirname("dir/file.ext") # => "dir"
p File.dirname("file.ext") # => "."
//}

File.dirname の動作は dirname(3)
に従います。
//emlist[例][ruby]{
p File.dirname("foo/bar/") # => "foo"
p File.di...

• File

File.absolute_path?(file_name) -> bool (51496.0)

• 3.1

• 特異メソッド

file_name が絶対パスなら true を、そうでなければ false を返します。

file_name が絶対パスなら true を、そうでなければ false を返します。

@param file_name ファイル名を表す文字列を指定します。文字列でない場合は、to_path メソッド、to_str メソッドの順で暗黙の型変換が試みられます。

@raise TypeError 引数に文字列以外の（暗黙の型変換が行えない）オブジェクトを指定した場合に発生します。

//emlist[例][ruby]{
File.absolute_path?("//foo/bar\\baz") # => true
File.absolute_path?("C:foo\\bar") ...

• File

File.extname(filename) -> String (51481.0)

• 3.1

• 特異メソッド

ファイル名 filename の拡張子部分(最後の "." に続く文字列)を 返します。ディレクトリ名に含まれる "." や、ファイル名先頭の "." は拡張子の一部としては見なされません。filename に拡張子が含 まれない場合は空文字列を返します。

ファイル名 filename の拡張子部分(最後の "." に続く文字列)を
返します。ディレクトリ名に含まれる "." や、ファイル名先頭の "."
は拡張子の一部としては見なされません。filename に拡張子が含
まれない場合は空文字列を返します。

//emlist[例][ruby]{
p File.extname("foo/foo.txt") # => ".txt"
p File.extname("foo/foo.tar.gz") # => ".gz"
p File.extname("foo/bar") # => ""
p File.extname("f...

• File

File.absolute_path(file_name, dir_string=nil) -> String (51478.0)

• 3.1

• 特異メソッド

file_name を絶対パスに変換した文字列を返します。

file_name を絶対パスに変換した文字列を返します。

相対パスの場合はカレントディレクトリを基準とします。
dir_string を渡した場合はそのディレクトリを基準とします。

File.expand_path と異なり、 file_name 先頭が "~" である場合
それは展開されません。普通のディレクトリ名として処理されます。

//emlist[例][ruby]{
p Dir.getwd #=> "/home/matz/work/bar"
p ENV["HOME"] #=> "/home/mat...

• File

絞り込み条件を変える

File.utime(atime, mtime, *filename) -> Integer (51475.0)

• 3.1

• 特異メソッド

ファイルの最終アクセス時刻と更新時刻を変更します。 シンボリックリンクに対しては File.lutime　と違って、 シンボリックのリンク先を変更します。

ファイルの最終アクセス時刻と更新時刻を変更します。
シンボリックリンクに対しては File.lutime　と違って、
シンボリックのリンク先を変更します。

@param atime 最終アクセス時刻を Time か、起算時からの経過秒数を数値で指定します。

@param mtime 更新時刻を Time か、起算時からの経過秒数を数値で指定します。

@param filename ファイル名を表す文字列を指定します。複数指定できます。

@return 変更したファイルの数を返します。

@raise Errno::EXXX 変更に失敗した場合に発生します。

//emlist[例: ...

• File
• Time

File.basename(filename, suffix = "") -> String (51463.0)

• 3.1

• 特異メソッド

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

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

//emlist[例][ruby]{
p File.basename("ruby/ruby.c") #=> "ruby.c"
p File.basename("ruby/ruby.c", ".c") #=> "ruby"
p File.basename("ruby/ruby.c", ".*") #=> "ruby"
p File.basename("ruby/ruby.e...

• File

File.lchown(owner, group, *filename) -> Integer (51457.0)

• 3.1

• 特異メソッド

File#chown と同様ですが、 シンボリックリンクに関してリンクそのもののオーナー、 グループを変更します。

File#chown と同様ですが、
シンボリックリンクに関してリンクそのもののオーナー、
グループを変更します。

@param filename ファイル名を表す文字列を指定します。

@param owner chown(2) と同様に数値で指定します。nil または -1 を指定することで、オーナーを現在のままにすることができます。

@param group chown(2) と同様に数値で指定します。nil または -1 を指定することで、グループを現在のままにすることができます。

@raise NotImplementedError lchown(2) を実装していないシステ...

• File

File#lstat -> File::Stat (51442.0)

• 3.1

• インスタンスメソッド

ファイルの状態を含む File::Stat オブジェクトを生成して返します。 シンボリックリンクに関してリンクそのものの情報を返します。 lstat(2) を実装していないシステムでは、IO#statと同じです。

ファイルの状態を含む File::Stat オブジェクトを生成して返します。
シンボリックリンクに関してリンクそのものの情報を返します。
lstat(2) を実装していないシステムでは、IO#statと同じです。

@raise Errno::EXXX 失敗した場合に発生します。

@raise IOError 自身が close されている場合に発生します。

//emlist[例][ruby]{
# testlink は testfile のシンボリックリンク
File.open("testlink") do |f|
p f.lstat == File.stat("testfil...

• File
• File::Stat

File.lchmod(mode, *filename) -> Integer (51439.0)

• 3.1

• 特異メソッド

File.chmod と同様ですが、シンボリックリンクに関してリンクそのものの モードを変更します。

File.chmod と同様ですが、シンボリックリンクに関してリンクそのものの
モードを変更します。

@param filename ファイル名を表す文字列を指定します。

@param mode chmod(2) と同様に整数で指定します。

@raise NotImplementedError lchmod(2) を実装していないシステムでこのメソッドを呼び出すと発生します。

@raise Errno::EXXX モードの変更に失敗した場合に発生します。

//emlist[例][ruby]{
IO.write("testfile", "test")
File.symlink("te...

• File

絞り込み条件を変える

File.ftype(filename) -> String (51409.0)

• 3.1

• 特異メソッド

ファイルのタイプを表す文字列を返します。

ファイルのタイプを表す文字列を返します。

文字列は以下のうちのいずれかです。File.lstat(filename).ftype と同じです。
シンボリックリンクに対して "link" を返します。

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

@param filename ファイル名を表す文字列を指定します。

@raise Errno::EXXX 情報の取得に失敗した場合に発生します。

//emlist[...

• File

File.mkfifo(file_name, mode = 0666) -> 0 (51406.0)

• 3.1

• 特異メソッド

引数 file_name で指定した名前の FIFO スペシャルファイルを作成します。

引数 file_name で指定した名前の FIFO スペシャルファイルを作成します。

@param file_name ファイル名を指定します。

@param mode FIFO の許可モードを数値で指定します。指定したモードは通常の
ファイル作成と同様にプロセスの umask によって変更されます。
作成されたファイルの許可モードは (mode & ~umask) になります。

//emlist[例][ruby]{
File.mkfifo("testfile", 0666)
File.ftype("testfile") ...

• File

File.delete(*filename) -> Integer (51391.0)

• 3.1

• 特異メソッド

ファイルを削除します。削除したファイルの数を返します。 削除に失敗した場合は例外 Errno::EXXX が発生します。

ファイルを削除します。削除したファイルの数を返します。
削除に失敗した場合は例外 Errno::EXXX が発生します。

このメソッドは通常ファイルの削除用で、ディレクトリの削除には
Dir.rmdir を使います。

@param filename ファイル名を表す文字列を指定します。

@raise Errno::EXXX 失敗した場合に発生します。

//emlist[例][ruby]{
IO.write("test.txt", "test")
p File.exist?("test.txt") # => true
p File.delete("test.txt") # => ...

• Errno::EXXX
• File

File.unlink(*filename) -> Integer (51391.0)

• 3.1

• 特異メソッド

ファイルを削除します。削除したファイルの数を返します。 削除に失敗した場合は例外 Errno::EXXX が発生します。

ファイルを削除します。削除したファイルの数を返します。
削除に失敗した場合は例外 Errno::EXXX が発生します。

このメソッドは通常ファイルの削除用で、ディレクトリの削除には
Dir.rmdir を使います。

@param filename ファイル名を表す文字列を指定します。

@raise Errno::EXXX 失敗した場合に発生します。

//emlist[例][ruby]{
IO.write("test.txt", "test")
p File.exist?("test.txt") # => true
p File.delete("test.txt") # => ...

• Errno::EXXX
• File

File.path(filename) -> String (51373.0)

• 3.1

• 特異メソッド

指定されたファイル名を文字列で返します。filename が文字列でない場合は、to_path メソッドを呼びます。

指定されたファイル名を文字列で返します。filename が文字列でない場合は、to_path メソッドを呼びます。

@param filename ファイル名を表す文字列か to_path メソッドが定義されたオブジェクトを指定します。

//emlist[例][ruby]{
require 'pathname'

class MyPath
def initialize(path)
@path = path
end
def to_path
File.absolute_path(@path)
end
end

File.path("/dev/null") ...

• File

絞り込み条件を変える

File.lutime(atime, mtime, *filename) -> Integer (51367.0)

• 3.1

• 特異メソッド

ファイルの最終アクセス時刻と更新時刻を変更します。 シンボリックリンクに対しては File.utime　と違って、 シンボリックそのものを変更します。

ファイルの最終アクセス時刻と更新時刻を変更します。
シンボリックリンクに対しては File.utime　と違って、
シンボリックそのものを変更します。

@param atime 最終アクセス時刻を Time か、起算時からの経過秒数を数値で指定します。

@param mtime 更新時刻を Time か、起算時からの経過秒数を数値で指定します。

@param filename ファイル名を表す文字列を指定します。複数指定できます。

@return 変更したファイルの数を返します。

@raise Errno::EXXX 変更に失敗した場合に発生します。

@see File.utim...

• File
• Time

File#flock(operation) -> 0 | false (51361.0)

• 3.1

• インスタンスメソッド

ファイルをロックします。

ファイルをロックします。

ロックを取得するまでブロックされます。
ロックの取得に成功した場合は 0 を返します。
File::LOCK_NB (ノンブロッキング) を指定すると、本来ならブロックされる場合に
ブロックされずに false を返すようになります。

@param operation ロックに対する操作の種類を示す定数を指定します。
どのような定数が利用可能かは以下を参照して下さい。

@raise IOError 自身が close されている場合に発生します。

@raise Errno::EXXX operation に不正な整数を与えた...

• Errno::EXXX
• File
• File::Constants

File.chown(owner, group, *filename) -> Integer (51355.0)

• 3.1

• 特異メソッド

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

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

@param filename ファイル名を表す文字列を指定します。

@param owner chown(2) と同様に数値で指定します。nil または -1 を指定することで、オーナーを現在のままにすることができます。

@param group chown(2) と同様に数値で指定します。nil または -1 を指定することで、グループを現在のままにすることができます。

@raise Errno::EXXX 変更に失敗した場合に発生し...

• File

File.ctime(filename) -> Time (51355.0)

• 3.1

• 特異メソッド

状態が最後に変更された時刻を返します。 状態の変更とは chmod などによるものです。

状態が最後に変更された時刻を返します。
状態の変更とは chmod などによるものです。

@param filename ファイル名を表す文字列か IO オブジェクトを指定します。

@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。

//emlist[例:][ruby]{
IO.write("testfile", "test")
File.ctime("testfile") # => 2017-11-30 22:40:49 +0900
File.chmod(0755, "testfile")
File.ctime("testfile") # => 2...

• File

File::Constants::TMPFILE -> Integer (51349.0)

• 3.1

• 定数

名前なしの一時ファイルを作成します。 open(2) で O_TMPFILE が指定できる場合に使えます。 File.openで使用します。

名前なしの一時ファイルを作成します。
open(2) で O_TMPFILE が指定できる場合に使えます。
File.openで使用します。

• File::Constants

絞り込み条件を変える

File::Stat#file? -> bool (51340.0)

• 3.1

• インスタンスメソッド

通常ファイルの時に真を返します。

通常ファイルの時に真を返します。

//emlist[][ruby]{
p File::Stat.new($0).file? #=> true
//}

• File::Stat

File.atime(filename) -> Time (51337.0)

• 3.1

• 特異メソッド

最終アクセス時刻を返します。

最終アクセス時刻を返します。

@param filename ファイル名を表す文字列か IO オブジェクトを指定します。

@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。

//emlist[例][ruby]{
File.atime(__FILE__) # => 2017-11-28 22:38:44 +0900
//}

• File

File.mtime(filename) -> Time (51337.0)

• 3.1

• 特異メソッド

最終更新時刻を返します。

最終更新時刻を返します。

@param filename ファイル名を表す文字列か IO オブジェクトを指定します。

@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。

//emlist[例][ruby]{
File.mtime(__FILE__) # => 2017-12-03 03:16:22 +0900
//}

• File

File.birthtime(filename) -> Time (51319.0)

• 3.1

• 特異メソッド

作成された時刻を返します。

作成された時刻を返します。

@param filename ファイル名を表す文字列か IO オブジェクトを指定します。

@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。

@raise NotImplementedError Windows のような birthtime のない環境で発生します。

//emlist[例][ruby]{
File.birthtime("testfile") #=> Wed Apr 09 08:53:13 CDT 2003
//}

• File

File.chmod(mode, *filename) -> Integer (51301.0)

• 3.1

• 特異メソッド

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

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

@param filename ファイル名を表す文字列を指定します。

@param mode chmod(2) と同様に整数で指定します。

@raise Errno::EXXX モードの変更に失敗した場合に発生します。

• File

絞り込み条件を変える

File.join(*item) -> String (51229.0)

• 3.1

• 特異メソッド

File::SEPARATORを間に入れて文字列を連結します。platform/DOSISH-supportで環境依存になる予定です。

File::SEPARATORを間に入れて文字列を連結します。platform/DOSISH-supportで環境依存になる予定です。

@param item 連結したいディレクトリ名やファイル名を文字列（もしくは文字列を要素に持つ配列）で与えます。
文字列AとBを連結する際に、Aの末尾の文字とBの先頭の文字がFile::SEPARATORであった場合には、
まずこれらを削除した上で改めてFile::SEPARATORを間に入れて連結します。
引数の中に配列がある場合は配列要素を再帰的に展開します。空の配列は空文字列に...

• File
• platform/DOSISH-support

File#path -> String (51127.0)

• 3.1

• インスタンスメソッド

オープン時に使用したパスを文字列で返します。

オープン時に使用したパスを文字列で返します。

パスは self に対応するファイルを指しているとは限りません。
たとえば、ファイルが移動されていたり、削除されていたりする場合です。

@raise IOError TMPFILE File::Constants::TMPFILEオプション付きで作成されている場合に発生します。

//emlist[例][ruby]{
File.open("testfile") {|f| f.path } #=> "testfile"
File.open("/tmp/../tmp/xxx", "w") {|f| f...

• File

File#to_path -> String (51127.0)

• 3.1

• インスタンスメソッド

オープン時に使用したパスを文字列で返します。

オープン時に使用したパスを文字列で返します。

パスは self に対応するファイルを指しているとは限りません。
たとえば、ファイルが移動されていたり、削除されていたりする場合です。

@raise IOError TMPFILE File::Constants::TMPFILEオプション付きで作成されている場合に発生します。

//emlist[例][ruby]{
File.open("testfile") {|f| f.path } #=> "testfile"
File.open("/tmp/../tmp/xxx", "w") {|f| f...

• File

File#atime -> Time (51091.0)

• 3.1

• インスタンスメソッド

最終アクセス時刻を Time オブジェクトとして返します。

最終アクセス時刻を Time オブジェクトとして返します。

@raise IOError 自身が close されている場合に発生します。

@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。

//emlist[例:][ruby]{
IO.write("testfile", "test")
File.open("testfile") { |f| f.atime } # => 2017-12-21 22:58:17 +0900
//}

@see File#lstat, File#ctime, File#mtime, File#birthtime

• File

File#birthtime -> Time (51091.0)

• 3.1

• インスタンスメソッド

作成された時刻を Time オブジェクトとして返します。

作成された時刻を Time オブジェクトとして返します。

@raise IOError 自身が close されている場合に発生します。

@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。

@raise NotImplementedError Windows のような birthtime のない環境で発生します。

File.new("testfile").birthtime #=> Wed Apr 09 08:53:14 CDT 2003

@see File#lstat, File#atime, File#ctime, File#mti...

• File

絞り込み条件を変える

File#ctime -> Time (51091.0)

• 3.1

• インスタンスメソッド

状態が最後に変更された時刻を Time オブジェクトとして返します。状態の変更とは chmod などによるものです。

状態が最後に変更された時刻を Time オブジェクトとして返します。状態の変更とは chmod などによるものです。

@raise IOError 自身が close されている場合に発生します。

@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。

//emlist[例:][ruby]{
IO.write("testfile", "test")
File.open("testfile") { |f| f.ctime } # => 2017-12-21 22:58:17 +0900
//}

@see File#lstat, File#atime, F...

• File

File#mtime -> Time (51091.0)

• 3.1

• インスタンスメソッド

最終更新時刻を Time オブジェクトとして返します。

最終更新時刻を Time オブジェクトとして返します。

@raise IOError 自身が close されている場合に発生します。

@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。

//emlist[例:][ruby]{
IO.write("testfile", "test")
File.open("testfile") { |f| f.mtime } # => 2017-12-21 22:58:17 +0900
//}

@see File#lstat, File#atime, File#ctime, File#birthtime

• File

File#chown(owner, group) -> 0 (51073.0)

• 3.1

• インスタンスメソッド

ファイルのオーナーとグループを変更します。

ファイルのオーナーとグループを変更します。

適切な権限があればファイルのオーナーとグループを変更できます。
所有者の変更に成功した場合は 0 を返します。変更に失敗した場合は
例外 Errno::EXXX が発生します。

@param owner chown(2) と同様に数値で指定します。nil または -1 を指定することで、オーナーを現在のままにすることができます。

@param group chown(2) と同様に数値で指定します。nil または -1 を指定することで、グループを現在のままにすることができます。

@raise IOError 自身が close されている...

• Errno::EXXX
• File

File.expand_path(path, default_dir = &#39;.&#39;) -> String (51073.0)

• 3.1

• 特異メソッド

path を絶対パスに展開した文字列を返します。 path が相対パスであれば default_dir を基準にします。

path を絶対パスに展開した文字列を返します。
path が相対パスであれば default_dir を基準にします。

先頭の ~ はホームディレクトリ(環境変数 HOME が使われます)に、
~USER はそのユーザのホームディレクトリに展開されます。

//emlist[例][ruby]{
p Dir.getwd #=> "/home/matz/work/foo"
p ENV["HOME"] #=> "/home/matz"
p File.expand_path("..") #=> "/h...

• File

File.realpath(pathname, basedir = nil) -> String (51073.0)

• 3.1

• 特異メソッド

与えられた pathname に対応する絶対パスを返します。

与えられた pathname に対応する絶対パスを返します。

pathname の全てのコンポーネントは存在しなければなりません。

@param pathname ファイル名を指定します。

@param basedir ベースディレクトリを指定します。省略するとカレントディレクトリを使用します。

@raise Errno::ENOENT ファイルが存在しない場合に発生します。

//emlist[例][ruby]{
ENV["HOME"] # => "/home/matz"
File.symlink("testfile", "testlink"...

• File

絞り込み条件を変える

File.rename(from, to) -> 0 (51073.0)

• 3.1

• 特異メソッド

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

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

ファイルの移動に成功した場合 0 を返します。失敗した場合は例外
Errno::EXXX が発生します。

@param from ファイルの名前を文字列で与えます。

@param to 新しいファイル名を文字列で与えます。

@raise Errno::EXXX 失敗した場合に発生します。

//emlist[例][ruby]{
begin
File.rename("testfile", "testfile.bak")...

• Errno::EXXX
• File

File.exists?(path) -> bool (51049.0)

• 3.1

• 特異メソッド

このメソッドは Ruby 2.1 から deprecated です。File.exist? を使用してください。

このメソッドは Ruby 2.1 から deprecated です。File.exist? を使用してください。

• File

File#size -> Integer (51037.0)

• 3.1

• インスタンスメソッド

ファイルのサイズを返します。

ファイルのサイズを返します。

//emlist[例][ruby]{
File.open("/dev/null") do |f|
f.size #=> 0
end
//}

@raise IOError 自身が close されている場合に発生します。

@raise Errno::EXXX 失敗した場合に発生します。

@see File#lstat

• File

File.readlink(path) -> String (51037.0)

• 3.1

• 特異メソッド

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

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

@param path シンボリックリンクを表す文字列を指定します。

@raise Errno::EXXX 指定された path がシンボリックリンクでない場合や、リンクの読み取りに失敗した場合に発生します。

//emlist[例:][ruby]{
IO.write("testfile", "test")
File.symlink("testfile", "testlink") # => 0
File.readlink("testlink") # => "testfile"
//}

• File

File.split(pathname) -> [String] (51037.0)

• 3.1

• 特異メソッド

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

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

//emlist[][ruby]{
[File.dirname(pathname), File.basename(pathname)]
//}

と同じです。

@param pathname パス名を表す文字列を指定します。

• File

絞り込み条件を変える

File.truncate(path, length) -> 0 (51037.0)

• 3.1

• 特異メソッド

path で指定されたファイルのサイズを最大 length バイト にします。

path で指定されたファイルのサイズを最大 length バイト
にします。

サイズの変更に成功すれば 0 を返します。失敗した場合は例外
Errno::EXXX が発生します。

@param path パスを表す文字列を指定します。

@param length 変更したいサイズを整数で与えます。

@raise Errno::EXXX 失敗した場合に発生します。

//emlist[例][ruby]{
IO.write("testfile", "1234567890")
File.truncate("testfile", 5) # => 0
File.size("testfil...

• Errno::EXXX
• File

File.umask(umask) -> Integer (51037.0)

• 3.1

• 特異メソッド

umask を変更します。変更前の umask の値を返します。

umask を変更します。変更前の umask の値を返します。

@param umask 設定したい umask の値を整数で指定します。

//emlist[例][ruby]{
File.umask(0006) # => 18
File.umask # => 6
//}

@see umask(2)

• File

File#chmod(mode) -> 0 (51019.0)

• 3.1

• インスタンスメソッド

ファイルのモードを指定された mode に変更します。

ファイルのモードを指定された mode に変更します。

モードの変更に成功した場合は 0 を返します。失敗した場合は例外 Errno::EXXX が発生し
ます。

@param mode chmod(2) と同様に整数で指定します。

@raise IOError 自身が close されている場合に発生します。

@raise Errno::EXXX 失敗した場合に発生します。

//emlist[例][ruby]{
f = File.new("out", "w");
f.chmod(0644) #=> 0
//}

• Errno::EXXX
• File

File#truncate(length) -> 0 (51019.0)

• 3.1

• インスタンスメソッド

ファイルのサイズを最大 length バイトにします。

ファイルのサイズを最大 length バイトにします。

サイズの変更に成功すれば 0 を返します。失敗した場合は例外
Errno::EXXX が発生します。

@raise IOError 自身が書き込み用にオープンされていなければ発生します。

@raise Errno::EXXX サイズの変更に失敗した場合に発生します。

//emlist[例][ruby]{
IO.write("testfile", "1234567890")
File.open("testfile", "a") do |f|
f.truncate(5) # => 0
f.size # => 5...

• Errno::EXXX
• File

File.link(old, new) -> 0 (51019.0)

• 3.1

• 特異メソッド

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

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

失敗した場合は例外 Errno::EXXX が発生します。

@param old ファイル名を表す文字列を指定します。

@param new ファイル名を表す文字列を指定します。

@raise Errno::EXXX 失敗した場合に発生します。

//emlist[例][ruby]{
IO.write("testfile", "test")
File.link("testfile", "testlink") # => 0...

• Errno::EXXX
• File

絞り込み条件を変える

File.symlink(old, new) -> 0 (51019.0)

• 3.1

• 特異メソッド

old への new という名前のシンボリックリンクを生成します。

old への new という名前のシンボリックリンクを生成します。

シンボリックリンクの作成に成功すれば 0 を返します。失敗した場合は
例外 Errno::EXXX が発生します。

@param old ファイル名を表す文字列を指定します。

@param new シンボリックリンクを表す文字列を指定します。

@raise Errno::EXXX 失敗した場合に発生します。

//emlist[例][ruby]{
File.symlink("testfile", "testlink") # => 0
//}

• Errno::EXXX
• File

File.world_readable?(path) -> Integer | nil (51019.0)

• 3.1

• 特異メソッド

path が全てのユーザから読めるならばそのファイルのパーミッションを表す 整数を返します。そうでない場合は nil を返します。

path が全てのユーザから読めるならばそのファイルのパーミッションを表す
整数を返します。そうでない場合は nil を返します。

整数の意味はプラットフォームに依存します。

@param path パスを表す文字列か IO オブジェクトを指定します。

//emlist[例][ruby]{
m = File.world_readable?("/etc/passwd")
"%o" % m # => "644"
//}

• File

File.world_writable?(path) -> bool (51019.0)

• 3.1

• 特異メソッド

path が全てのユーザから書き込めるならば、そのファイルのパーミッションを表す 整数を返します。そうでない場合は nil を返します。

path が全てのユーザから書き込めるならば、そのファイルのパーミッションを表す
整数を返します。そうでない場合は nil を返します。

整数の意味はプラットフォームに依存します。

@param path パスを表す文字列か IO オブジェクトを指定します。

//emlist[例][ruby]{
m = File.world_writable?("/tmp")
"%o" % m #=> "777"
//}

• File

File.umask -> Integer (51007.0)

• 3.1

• 特異メソッド

現在の umask の値を返します。

現在の umask の値を返します。

@see umask(2)

• File

File.blockdev?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#blockdev? と同じです。

FileTest.#blockdev? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。


@see FileTest.#blockdev?

• File

絞り込み条件を変える

File.chardev?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#chardev? と同じです。

FileTest.#chardev? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.directory?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#directory? と同じです。

FileTest.#directory? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.empty?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#zero? と同じです。

FileTest.#zero? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.executable?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#executable? と同じです。

FileTest.#executable? と同じです。

@param path パスを表す文字列を指定します。

• File

File.executable_real?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#executable_real? と同じです。

FileTest.#executable_real? と同じです。

@param path パスを表す文字列を指定します。

• File

絞り込み条件を変える

File.exist?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#exist? と同じです。

FileTest.#exist? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.grpowned?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#grpowned? と同じです。

FileTest.#grpowned? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.owned?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#owned? と同じです。

FileTest.#owned? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.pipe?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#pipe? と同じです。

FileTest.#pipe? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.readable?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#readable? と同じです。

FileTest.#readable? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

絞り込み条件を変える

File.readable_real?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#readable_real? と同じです。

FileTest.#readable_real? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.realdirpath(pathname, basedir = nil) -> String (51001.0)

• 3.1

• 特異メソッド

与えられた pathname に対応する絶対パスを返します。

与えられた pathname に対応する絶対パスを返します。

pathname の最後のコンポーネントは存在していなくても例外は発生しません。

@param pathname ファイル名を指定します。

@param basedir ベースディレクトリを指定します。省略するとカレントディレクトリを使用します。

@raise Errno::ENOENT ファイルが存在しない場合に発生します。

• File

File.setgid?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#setgid? と同じです。

FileTest.#setgid? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.setuid?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#setuid? と同じです。

FileTest.#setuid? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.size(path) -> Integer (51001.0)

• 3.1

• 特異メソッド

FileTest.#size と同じです。

FileTest.#size と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

絞り込み条件を変える

File.size?(path) -> Integer | nil (51001.0)

• 3.1

• 特異メソッド

FileTest.#size? と同じです。

FileTest.#size? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.socket?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#socket? と同じです。

FileTest.#socket? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.sticky?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#sticky? と同じです。

FileTest.#sticky? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.symlink?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#symlink? と同じです。

FileTest.#symlink? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.writable?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#writable? と同じです。

FileTest.#writable? と同じです。

@param path パスを表す文字列を指定します。

• File

絞り込み条件を変える

File.writable_real?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#writable_real? と同じです。

FileTest.#writable_real? と同じです。

@param path パスを表す文字列を指定します。

• File

File.zero?(path) -> bool (51001.0)

• 3.1

• 特異メソッド

FileTest.#zero? と同じです。

FileTest.#zero? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File::ALT_SEPARATOR -> "\\" | nil (51001.0)

• 3.1

• 定数

システムのファイルパスのセパレータが SEPARATOR と異なる場合 に設定されます。MS-DOS などでは "\\" です。UNIX や Cygwin などでは nil です。

システムのファイルパスのセパレータが SEPARATOR と異なる場合
に設定されます。MS-DOS などでは "\\" です。UNIX や Cygwin などでは nil です。

• File

File::PATH_SEPARATOR -> ";" | ":" (51001.0)

• 3.1

• 定数

PATH 環境変数の要素のセパレータです。UNIX では ":" MS-DOS な どでは ";" です。

PATH 環境変数の要素のセパレータです。UNIX では ":" MS-DOS な
どでは ";" です。

• File

File::SEPARATOR -> "/" (51001.0)

• 3.1

• 定数

ファイルパスのセパレータです。ファイルを扱うメソッドにパス名を渡す 場合などスクリプト内のパス名は環境によらずこのセパレータで統一され ます。値は "/" です。

ファイルパスのセパレータです。ファイルを扱うメソッドにパス名を渡す
場合などスクリプト内のパス名は環境によらずこのセパレータで統一され
ます。値は "/" です。

• File

絞り込み条件を変える

File::Separator -> "/" (51001.0)

• 3.1

• 定数

ファイルパスのセパレータです。ファイルを扱うメソッドにパス名を渡す 場合などスクリプト内のパス名は環境によらずこのセパレータで統一され ます。値は "/" です。

ファイルパスのセパレータです。ファイルを扱うメソッドにパス名を渡す
場合などスクリプト内のパス名は環境によらずこのセパレータで統一され
ます。値は "/" です。

• File

RubyVM::InstructionSequence.compile_file(file, options = nil) -> RubyVM::InstructionSequence (42709.0)

• 3.1

• 特異メソッド

引数 file で指定した Ruby のソースコードを元にコンパイル済みの RubyVM::InstructionSequence オブジェクトを作成して返します。

引数 file で指定した Ruby のソースコードを元にコンパイル済みの
RubyVM::InstructionSequence オブジェクトを作成して返します。

RubyVM::InstructionSequence.compile とは異なり、file、path などの
メタデータは自動的に取得します。

@param file ファイル名を文字列で指定します。

@param options コンパイル時のオプションを true、false、Hash オブ
ジェクトのいずれかで指定します。詳細は
RubyVM::Instr...

• Hash
• RubyVM::InstructionSequence

RubyVM::AbstractSyntaxTree.parse_file(pathname) -> RubyVM::AbstractSyntaxTree::Node (42358.0)

• 3.1

• 特異メソッド

pathname のファイルを読み込み、その内容を抽象構文木にパースし、その木の根ノードを返します。

pathname のファイルを読み込み、その内容を抽象構文木にパースし、その木の根ノードを返します。

@param pathname パースする対象のファイルパスを指定します
@raise SyntaxError pathname から取得された文字列が Ruby のコードとして正しくない場合に発生します。

//emlist[][ruby]{
pp RubyVM::AbstractSyntaxTree.parse_file(__FILE__)
# => (SCOPE@1:0-1:50
# tbl: []
# args: nil
# body:
# (F...

• RubyVM::AbstractSyntaxTree

ARGF.class#filename -> String (42301.0)

• 3.1

• インスタンスメソッド

現在開いている処理対象のファイル名を返します。

現在開いている処理対象のファイル名を返します。

標準入力に対しては - を返します。
組み込み変数 $FILENAME と同じです。

$ echo "foo" > foo
$ echo "bar" > bar
$ echo "glark" > glark

$ ruby argf.rb foo bar glark

ARGF.filename # => "foo"
ARGF.read(5) # => "foo\nb"
ARGF.filename # => "bar"
ARGF.skip
ARGF.filename # => "glark"

• ARGF.class

ARGF.class#fileno -> Integer (42301.0)

• 3.1

• インスタンスメソッド

現在オープンしているファイルのファイル記述子を表す整数を返します。

現在オープンしているファイルのファイル記述子を表す整数を返します。

ARGF.fileno # => 3

@raise ArgumentError 現在開いているファイルがない場合に発生します。

• ARGF.class

絞り込み条件を変える

Dir#fileno -> Integer (42301.0)

• 3.1

• インスタンスメソッド

self に関連づけられたファイル記述子を表す整数を返します。

self に関連づけられたファイル記述子を表す整数を返します。

//emlist[例][ruby]{
Dir.open("..") { |d| d.fileno } # => 8
//}

本メソッドでは POSIX 2008 で定義されている dirfd() 関数を使用します。

@raise NotImplementedError Windows などの dirfd() 関数が存在しないプラッ
トフォームで発生します。
@raise IOError 既に自身が close している場合に発生します。

@see IO#fileno

• Dir

IO#fileno -> Integer (42301.0)

• 3.1

• インスタンスメソッド

ファイル記述子を表す整数を返します。

ファイル記述子を表す整数を返します。

@raise IOError 既に close されている場合に発生します。


//emlist[例][ruby]{
$stdin.fileno # => 0
$stdout.fileno # => 1
//}

@see Dir#fileno

• IO

Kernel$$FILENAME -> String (42301.0)

• 3.1

• 変数

仮想ファイル Object::ARGF で現在読み込み中のファイル名です。 ARGF.class#filename と同じです。

仮想ファイル Object::ARGF で現在読み込み中のファイル名です。
ARGF.class#filename と同じです。

この変数はグローバルスコープです。

• Kernel

Process::RLIMIT_NOFILE -> Integer (42301.0)

• 3.1

• 定数

リソースの種類がプロセスがオープンできるファイルの数であることを示す定数です。

リソースの種類がプロセスがオープンできるファイルの数であることを示す定数です。

Process.#getrlimit、Process.#setrlimit で使われます。
システムによっては定義されていません。

• Process

File (42073.0)

• 3.1

• クラス

ファイルアクセスのためのクラスです。

ファイルアクセスのためのクラスです。

通常 Kernel.#open または File.open を使って生成します。
IO クラスがインクルードしている File::Constants は File クラスに関係する定数を
格納したモジュールです。
また File::Stat は stat 構造体( stat(2) 参照)を表すクラスです。

• File::Constants
• File::Stat
• IO

絞り込み条件を変える

FileTest (42019.0)

• 3.1

• モジュール

ファイルの検査関数を集めたモジュールです。

ファイルの検査関数を集めたモジュールです。

=== 注意

FileTest で定義された各メソッドは、システムコールに失敗しても例外を発生させません。
真を返した時のみ、返り値は意味をもちます。
例えば、
File.exist?('/root/.bashrc')
が false を返しても、それはファイルが存在しないことを保証しません。

Errno::EMFILE (42001.0)

• 3.1

• クラス

システムコールのエラーコードを表す例外クラスです。詳細は Errno::EXXX を参照してください。

システムコールのエラーコードを表す例外クラスです。詳細は Errno::EXXX を参照してください。

• Errno::EXXX

Errno::ENFILE (42001.0)

• 3.1

• クラス

システムコールのエラーコードを表す例外クラスです。詳細は Errno::EXXX を参照してください。

システムコールのエラーコードを表す例外クラスです。詳細は Errno::EXXX を参照してください。

• Errno::EXXX

GC::Profiler (42001.0)

• 3.1

• モジュール

GC の起動回数や起動したタイミング、処理時間などの GC に関するプロファイル 情報や、ヒープ全体のサイズ、ヒープ内での使用サイズやヒープ内に存在する オブジェクトの個数といった情報を扱うモジュールです。

GC の起動回数や起動したタイミング、処理時間などの GC に関するプロファイル
情報や、ヒープ全体のサイズ、ヒープ内での使用サイズやヒープ内に存在する
オブジェクトの個数といった情報を扱うモジュールです。

@see GC

• GC

FileTest.#identical?(file1, file2) -> bool (33937.0)

• 3.1

• モジュール関数

file1 と file2 が同じファイルを指している時に真を返します。 そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

file1 と file2 が同じファイルを指している時に真を返します。
そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

ruby 1.8.3 以前ではKernel.#test(?-, file1, file2)を使ってください。

open("a", "w") {}
p File.identical?("a", "a") #=> true
p File.identical?("a", "./a") #=> true
File.link("a", "b")
p File.identical...

• FileTest

絞り込み条件を変える