検索結果

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

• 2.3.0

• インスタンスメソッド

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

...をロックします。

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

...eration に有効な定数は以下の通りです。定数は File::Constants で定義されていますが、
File クラスの親クラスの IO が File::Constants をインクルードしているので、
これらの定数は File::LOCK_SH などとして参照可能です。

: LOCK_SH
共...

...ブロックモード。
File::LOCK_SH | File::LOCK_NB のように他の指定と or することで指
定します。この指定がない場合、ブロックされる条件での flock
の呼び出しはロックが解除されるまでブロックされます。

File::LOCK_NB の指定が...

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

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

• 2.3.0

• インスタンスメソッド

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

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

@raise Errno::EXXX 失敗した場合...

...ose されている場合に発生します。

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

@see IO#stat, File.stat, File.lstat...

• File::Stat

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

• 2.3.0

• 特異メソッド

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

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

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

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

...mod(0755, "testfile")
File.ctime("testfile") # => 2017-11-30 22:42:12 +0900
//}...

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

• 2.3.0

• 特異メソッド

FileTest.#identical? と同じです。

...
FileTest.#identical? と同じです。

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

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

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

• 2.3.0

• 特異メソッド

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

...を指定します。

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

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

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

• Errno::EXXX

絞り込み条件を変える

File#atime -> Time (22.0)

• 2.3.0

• インスタンスメソッド

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

...に発生します。

@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#ctime -> Time (22.0)

• 2.3.0

• インスタンスメソッド

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

...に発生します。

@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, File#mtime, File#birthtime...

File#mtime -> Time (22.0)

• 2.3.0

• インスタンスメソッド

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

...に発生します。

@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#truncate(length) -> 0 (22.0)

• 2.3.0

• インスタンスメソッド

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

...書き込み用にオープンされていなければ発生します。

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

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

• Errno::EXXX

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

• 2.3.0

• 特異メソッド

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

...セス時刻を返します。

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

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

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

絞り込み条件を変える

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

• 2.3.0

• 特異メソッド

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

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

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

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

@raise NotImplementedError Windows のような birthtime のない...

...環境で発生します。

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

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

• 2.3.0

• 特異メソッド

FileTest.#blockdev? と同じです。

...
FileTest.#blockdev? と同じです。

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


@see FileTest.#blockdev?...

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

• 2.3.0

• 特異メソッド

FileTest.#chardev? と同じです。

...
FileTest.#chardev? と同じです。

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

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

• 2.3.0

• 特異メソッド

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

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

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

@param owner chown(2) と同様に数値で指定します。nil または -1 を指...

...を指定することで、グループを現在のままにすることができます。

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

//emlist[例][ruby]{
IO.write("test.txt", "test")
File.chown(502, 12, "test.txt")
File.stat("test.txt").uid # => 502
//}

@see File#chown...

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

• 2.3.0

• 特異メソッド

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

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

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

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

...delete("test.txt")
rescue
p $! # => #<Errno::ENOENT: No such file or directory @ unlink_internal - test.txt>
end
//}...

• Errno::EXXX

絞り込み条件を変える

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

• 2.3.0

• 特異メソッド

FileTest.#directory? と同じです。

...
FileTest.#directory? と同じです。

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

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

• 2.3.0

• 特異メソッド

FileTest.#exist? と同じです。

...
FileTest.#exist? と同じです。

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

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

• 2.3.0

• 特異メソッド

FileTest.#file? と同じです。

...
FileTest.#file? と同じです。

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

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

• 2.3.0

• 特異メソッド

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

...用できます。
Dir.glob とは違って `**/' は使用できません。
//emlist[例][ruby]{
%w(foo foobar bar).each {|f|
p File.fnmatch("foo*", f)
}
# => true
# true
# false
//}

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

@param flags パターンマッ...

...る定数は以下のとおりです。
これらの定数は File::Constants で定義されていますが、
File クラスの親クラスの IO が File::Constants をインクルードしているので、
これらの定数は File::FNM_NOESCAPE などとして参照可能です。

: FNM_NOES...

...ます。
//emlist[][ruby]{
p File.fnmatch('\a', 'a') # => true
p File.fnmatch('\a', '\a', File::FNM_NOESCAPE) # => true
//}
前者で * は、エスケープされているので "*" そのものにマッチ
します。
//emlist[][ruby]{
p File.fnmatch('\*', 'a')...

• File
• File::Constants

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

• 2.3.0

• 特異メソッド

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

...用できます。
Dir.glob とは違って `**/' は使用できません。
//emlist[例][ruby]{
%w(foo foobar bar).each {|f|
p File.fnmatch("foo*", f)
}
# => true
# true
# false
//}

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

@param flags パターンマッ...

...る定数は以下のとおりです。
これらの定数は File::Constants で定義されていますが、
File クラスの親クラスの IO が File::Constants をインクルードしているので、
これらの定数は File::FNM_NOESCAPE などとして参照可能です。

: FNM_NOES...

...ます。
//emlist[][ruby]{
p File.fnmatch('\a', 'a') # => true
p File.fnmatch('\a', '\a', File::FNM_NOESCAPE) # => true
//}
前者で * は、エスケープされているので "*" そのものにマッチ
します。
//emlist[][ruby]{
p File.fnmatch('\*', 'a')...

• File
• File::Constants

絞り込み条件を変える

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

• 2.3.0

• 特異メソッド

FileTest.#grpowned? と同じです。

...
FileTest.#grpowned? と同じです。

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

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

• 2.3.0

• 特異メソッド

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

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

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

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

@raise NotImplementedError lchmod(2)...

...生します。

//emlist[例][ruby]{
IO.write("testfile", "test")
File.symlink("testfile", "testlink")
File.lstat("testlink").ftype # => "link"
File.lchmod(0744, "testlink")
File.stat("testlink").mode.to_s(8) # => "100644"
File.lstat("testlink").mode.to_s(8) # => "120744"
//}...

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

• 2.3.0

• 特異メソッド

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

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

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

@param owner chown(2) と同様に数値で指定します。nil または -1...

...発生します。

//emlist[例][ruby]{
IO.write("testfile", "test")
File.symlink("testfile", "testlink")
File.chown(501, -1, "testfile")
File.lstat("testlink").ftype # => "link"
File.lchown(0, -1, "testlink")
File.stat("testlink").uid # => 501
File.lstat("testlink").uid # => 0
//}...

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

• 2.3.0

• 特異メソッド

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

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

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

@ra...

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

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

@see IO#stat, File#lstat...

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

• 2.3.0

• 特異メソッド

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

...更新時刻を返します。

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

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

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

絞り込み条件を変える

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

• 2.3.0

• 特異メソッド

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

...、File オブジェクトを生成して
返します。

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

...mlist[例: File.new による読み込みモードでのファイルオープン][ruby]{
f = File.new("testfile", "r")
f.class # => File
f.close
//}

//emlist[例: File.open による読み込みモードでのファイルオープン][ruby]{
f = File.open("testfile", "r")
f.class # => File
f.close...

...//}

//emlist[例: File.open による書き込みモードでのファイルオープン][ruby]{
File.open("testfile", "w", 0755) { |f| f.print "test" }
File.read("testfile") # => "test"
//}...

• File

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

• 2.3.0

• 特異メソッド

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

...、File オブジェクトを生成して
返します。

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

...mlist[例: File.new による読み込みモードでのファイルオープン][ruby]{
f = File.new("testfile", "r")
f.class # => File
f.close
//}

//emlist[例: File.open による読み込みモードでのファイルオープン][ruby]{
f = File.open("testfile", "r")
f.class # => File
f.close...

...//}

//emlist[例: File.open による書き込みモードでのファイルオープン][ruby]{
File.open("testfile", "w", 0755) { |f| f.print "test" }
File.read("testfile") # => "test"
//}...

• File

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

• 2.3.0

• 特異メソッド

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

...、File オブジェクトを生成して
返します。

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

...mlist[例: File.new による読み込みモードでのファイルオープン][ruby]{
f = File.new("testfile", "r")
f.class # => File
f.close
//}

//emlist[例: File.open による読み込みモードでのファイルオープン][ruby]{
f = File.open("testfile", "r")
f.class # => File
f.close...

...//}

//emlist[例: File.open による書き込みモードでのファイルオープン][ruby]{
File.open("testfile", "w", 0755) { |f| f.print "test" }
File.read("testfile") # => "test"
//}...

• File

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

• 2.3.0

• 特異メソッド

FileTest.#owned? と同じです。

...
FileTest.#owned? と同じです。

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

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

• 2.3.0

• 特異メソッド

FileTest.#pipe? と同じです。

...
FileTest.#pipe? と同じです。

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

絞り込み条件を変える

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

• 2.3.0

• 特異メソッド

FileTest.#readable? と同じです。

...
FileTest.#readable? と同じです。

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

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

• 2.3.0

• 特異メソッド

FileTest.#readable_real? と同じです。

...
FileTest.#readable_real? と同じです。

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

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

• 2.3.0

• 特異メソッド

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

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

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

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

• 2.3.0

• 特異メソッド

FileTest.#setgid? と同じです。

...
FileTest.#setgid? と同じです。

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

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

• 2.3.0

• 特異メソッド

FileTest.#setuid? と同じです。

...
FileTest.#setuid? と同じです。

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

絞り込み条件を変える

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

• 2.3.0

• 特異メソッド

FileTest.#size と同じです。

...
FileTest.#size と同じです。

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

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

• 2.3.0

• 特異メソッド

FileTest.#size? と同じです。

...
FileTest.#size? と同じです。

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

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

• 2.3.0

• 特異メソッド

FileTest.#socket? と同じです。

...
FileTest.#socket? と同じです。

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

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

• 2.3.0

• 特異メソッド

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

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

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

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

//emlist[例][ruby]{
File.stat("testfile").class # => Fi...

...le::Stat
File.stat("testfile").mtime # => 2017-12-10 01:13:56 +0900
//}

@see IO#stat, File#lstat...

• File::Stat

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

• 2.3.0

• 特異メソッド

FileTest.#sticky? と同じです。

...
FileTest.#sticky? と同じです。

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

絞り込み条件を変える

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

• 2.3.0

• 特異メソッド

FileTest.#symlink? と同じです。

...
FileTest.#symlink? と同じです。

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

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

• 2.3.0

• 特異メソッド

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

...す文字列を指定します。

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

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

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

• Errno::EXXX

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

• 2.3.0

• 特異メソッド

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

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

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

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

...delete("test.txt")
rescue
p $! # => #<Errno::ENOENT: No such file or directory @ unlink_internal - test.txt>
end
//}...

• Errno::EXXX

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

• 2.3.0

• 特異メソッド

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

...場合は nil を返します。

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

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

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

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

• 2.3.0

• 特異メソッド

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

...でない場合は nil を返します。

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

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

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

絞り込み条件を変える

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

• 2.3.0

• 特異メソッド

FileTest.#zero? と同じです。

...
FileTest.#zero? と同じです。

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