検索結果

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

• 3.2

• 特異メソッド

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

File (114127.0)

• 3.2

• クラス

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

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

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

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

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

• 3.2

• 特異メソッド

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#lstat -> File::Stat (82231.0)

• 3.2

• インスタンスメソッド

ファイルの状態を含む 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.lchown(owner, group, *filename) -> Integer (63475.0)

• 3.2

• 特異メソッド

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

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

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

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

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

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

• File

絞り込み条件を変える

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

• 3.2

• 特異メソッド

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.chown(owner, group, *filename) -> Integer (63373.0)

• 3.2

• 特異メソッド

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

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

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

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

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

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

• File

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

• 3.2

• インスタンスメソッド

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

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

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

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

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

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

• Errno::EXXX
• File

IO#stat -> File::Stat (55114.0)

• 3.2

• インスタンスメソッド

ファイルのステータスを含む File::Stat オブジェクトを生成して 返します。

ファイルのステータスを含む File::Stat オブジェクトを生成して
返します。

@raise Errno::EXXX ステータスの読み込みに失敗した場合に発生します。

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

//emlist[例][ruby]{
IO.write("testfile", "This is line one\nThis is line two\n")
File.open("testfile") do |f|
s = f.stat
"%o" % s.mode # => "100644"
s.blksize ...

• File::Stat
• IO

Pathname#stat -> File::Stat (55042.0)

• 3.2

• インスタンスメソッド

File.stat(self.to_s) と同じです。

File.stat(self.to_s) と同じです。


@see File.stat

• Pathname

絞り込み条件を変える

CSV#stat -> File::Stat (54976.0)

• 3.2

• インスタンスメソッド

IO#stat に委譲します。

IO#stat に委譲します。


@see IO#stat

• CSV

RDoc::TopLevel#file_stat -> File::Stat (37309.0)

• 3.2

• インスタンスメソッド

自身が管理するファイルに関する File::Stat オブジェクトを返します。

自身が管理するファイルに関する File::Stat オブジェクトを返します。

• File::Stat
• RDoc::TopLevel

RDoc::TopLevel#file_stat=(val) (36739.0)

• 3.2

• インスタンスメソッド

自身が管理するファイルに関する File::Stat オブジェクトを設定しま す。

自身が管理するファイルに関する File::Stat オブジェクトを設定しま
す。

@param val File::Stat オブジェクトを指定します。

• File::Stat
• RDoc::TopLevel

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

• 3.2

• インスタンスメソッド

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

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

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

• File::Stat

RDoc::Stats#num_files -> Integer (27301.0)

• 3.2

• インスタンスメソッド

解析したファイルの数を返します。

解析したファイルの数を返します。

• RDoc::Stats

絞り込み条件を変える

RDoc::Stats#num_files=(val) (27301.0)

• 3.2

• インスタンスメソッド

解析したファイルの数を指定します。

解析したファイルの数を指定します。

@param val 数値を指定します。

• RDoc::Stats

File::Stat (27055.0)

• 3.2

• クラス

ファイルの情報を格納したオブジェクトのクラス。

ファイルの情報を格納したオブジェクトのクラス。

FileTest に同名のモジュール関数がある場合はそれと同じ働きをします。ただ、
ファイル名を引数に取るかわりに Stat 自身について判定する点が違います。

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

1.8 以降では、属性メソッドがシステムでサポートされていない場合 nil が返ります。
なお、1.7 以前では 0 が返っていました。

dev デバイス番号(フ...

• FileTest

Pathname#lstat -> File::Stat (18973.0)

• 3.2

• インスタンスメソッド

File.lstat(self.to_s) と同じです。

File.lstat(self.to_s) と同じです。


@see File.lstat

• Pathname

File::Stat.new(path) -> File::Stat (18871.0)

• 3.2

• 特異メソッド

path に関する File::Stat オブジェクトを生成して返します。 File.stat と同じです。

path に関する File::Stat オブジェクトを生成して返します。
File.stat と同じです。

@param path ファイルのパスを指定します。

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

//emlist[][ruby]{
p $:[0]
#=> 例
# "C:/Program Files/ruby-1.8/lib/ruby/site_ruby/1.8"
p File::Stat.new($:[0])
#=> 例
#<File::Stat dev=0x2, ino=0, mode=040755, nlink=1,...

• File::Stat

static enum st_retval sweep_source_filename(char *key, char *value) (18601.0)

• 3.2

• 関数

絞り込み条件を変える

static void mark_source_filename(char *f) (18601.0)

• 3.2

• 関数

File::Stat#<=>(o) -> Integer | nil (18217.0)

• 3.2

• インスタンスメソッド

ファイルの最終更新時刻を比較します。self が other よりも 新しければ正の数を、等しければ 0 を古ければ負の数を返します。 比較できない場合は nil を返します。

ファイルの最終更新時刻を比較します。self が other よりも
新しければ正の数を、等しければ 0 を古ければ負の数を返します。
比較できない場合は nil を返します。

@param o File::Stat のインスタンスを指定します。

//emlist[][ruby]{
require 'tempfile' # for Tempfile

fp1 = Tempfile.open("first")
fp1.print "古い方\n"
sleep(1)
fp2 = Tempfile.open("second")
fp2.print "新しい方\n"

p File::Stat.n...

• File::Stat

File::Stat#birthtime -> Time (18217.0)

• 3.2

• インスタンスメソッド

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

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

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

//emlist[][ruby]{
File.write("testfile", "foo")
sleep 10
File.write("testfile", "bar")
sleep 10
File.chmod(0644, "testfile")
sleep 10
File.read("testfile")
File.stat("testfile").birthtime #=> 2014-02-24 11:19:17 +0900...

• File::Stat

File::Stat#symlink? -> false (18169.0)

• 3.2

• インスタンスメソッド

シンボリックリンクである時に真を返します。 ただし、File::Statは自動的にシンボリックリンクをたどっていくので 常にfalseを返します。

シンボリックリンクである時に真を返します。
ただし、File::Statは自動的にシンボリックリンクをたどっていくので
常にfalseを返します。

//emlist[][ruby]{
require 'fileutils'
outfile = $0 + ".ln"
FileUtils.ln_s($0, outfile)
p File::Stat.new(outfile).symlink? #=> false
p File.lstat(outfile).symlink? #=> true
p FileTest.symlink?(outfile) #=> true
//}

...

• File::Stat

File::Stat#ftype -> String (18109.0)

• 3.2

• インスタンスメソッド

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

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

文字列は以下のうちのいずれかです。

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

"unknown"


//emlist[例][ruby]{
fs = File::Stat.new($0)
p fs.ftype #=> "file"
p File::Stat.new($:[0]).ftype #=> "directory"
//}


1.8 以降では、属性メソッドがシステムでサポートされていない場合 nil...

• File::Stat

絞り込み条件を変える

File::Stat#socket? -> bool (18091.0)

• 3.2

• インスタンスメソッド

ソケットの時に真を返します。

ソケットの時に真を返します。

//emlist[][ruby]{
Dir.glob("/tmp/*"){|file|
if File::Stat.new(file).socket?
printf "%s\n", file
end
}
#例
#=> /tmp/uimhelper-hogehoge
#...
//}

• File::Stat

File::Stat#grpowned? -> bool (18073.0)

• 3.2

• インスタンスメソッド

グループIDが実効グループIDと等しい時に真を返します。

グループIDが実効グループIDと等しい時に真を返します。

補助グループIDは考慮されません。

//emlist[][ruby]{
printf "%s %s\n", $:[0], File::Stat.new($:[0]).grpowned?
#例
#=> /usr/local/lib/site_ruby/1.8 false
printf "%s %s\n", $0, File::Stat.new($0).grpowned?
#例
#=> filestat.rb true
//}

• File::Stat

File::Stat#size? -> Integer | nil (18073.0)

• 3.2

• インスタンスメソッド

サイズが0の時にはnil、それ以外の場合はファイルサイズを返します。

サイズが0の時にはnil、それ以外の場合はファイルサイズを返します。

//emlist[][ruby]{
require 'tempfile'

fp = Tempfile.new("temp")
p fp.size #=> 0
p File::Stat.new(fp.path).size? #=> nil
fp.print "not 0 "
fp.close
p FileTest.exist?(fp.path) #=> true
p File::Stat.new(fp.path).size? #=> 6
//}

• File::Stat

File::Stat#atime -> Time (18037.0)

• 3.2

• インスタンスメソッド

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

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

//emlist[][ruby]{
fs = File::Stat.new($0)
#例
p fs.atime.to_a #=> [45, 5, 21, 5, 9, 2007, 3, 248, false, "\223\214\213\236 (\225W\217\200\216\236) "]
//}

@see Time

• File::Stat
• Time

File::Stat#blksize -> Integer (18037.0)

• 3.2

• インスタンスメソッド

望ましいI/Oのブロックサイズを返します。

望ましいI/Oのブロックサイズを返します。

//emlist[][ruby]{
fs = File::Stat.new($0)
#例
p fs.blksize #=> nil
//}

• File::Stat

絞り込み条件を変える

File::Stat#blockdev? -> bool (18037.0)

• 3.2

• インスタンスメソッド

ブロックスペシャルファイルの時に真を返します。

ブロックスペシャルファイルの時に真を返します。

//emlist[][ruby]{
Dir.glob("/dev/*") {|bd|
if File::Stat.new(bd).blockdev?
puts bd
end
}
#例
#...
#=> /dev/hda1
#=> /dev/hda3
#...
//}

• File::Stat

File::Stat#blocks -> Integer (18037.0)

• 3.2

• インスタンスメソッド

割り当てられているブロック数を返します。

割り当てられているブロック数を返します。

//emlist[][ruby]{
fs = File::Stat.new($0)
#例
p fs.blocks #=> nil
//}

• File::Stat

File::Stat#chardev? -> bool (18037.0)

• 3.2

• インスタンスメソッド

キャラクタスペシャルファイルの時に真を返します。

キャラクタスペシャルファイルの時に真を返します。

//emlist[][ruby]{
Dir.glob("/dev/*") {|bd|
if File::Stat.new(bd).chardev?
puts bd
end
}
#例
#...
#=> /dev/tty1
#=> /dev/stderr
#...
//}

• File::Stat

File::Stat#ctime -> Time (18037.0)

• 3.2

• インスタンスメソッド

最終状態変更時刻を返します。 (状態の変更とは chmod などによるもので、Unix では i-node の変更を意味します)

最終状態変更時刻を返します。
(状態の変更とは chmod などによるもので、Unix では i-node の変更を意味します)

//emlist[][ruby]{
fs = File::Stat.new($0)
#例
p fs.ctime.to_f #=> 1188719843.0
//}


@see Time

• File::Stat
• Time

File::Stat#dev -> String (18037.0)

• 3.2

• インスタンスメソッド

デバイス番号(ファイルシステム)を返します。

デバイス番号(ファイルシステム)を返します。

//emlist[][ruby]{
fs = File::Stat.new($0)
p fs.dev
#例
#=> 2
//}

• File::Stat

絞り込み条件を変える

File::Stat#dev_major -> Integer (18037.0)

• 3.2

• インスタンスメソッド

dev の major 番号部を返します。

dev の major 番号部を返します。

//emlist[][ruby]{
fs = File::Stat.new($0)
p fs.dev_major
#例
#=> nil #この場合ではシステムでサポートされていないため
//}

• File::Stat

File::Stat#dev_minor -> Integer (18037.0)

• 3.2

• インスタンスメソッド

dev の minor 番号部を返します。

dev の minor 番号部を返します。

//emlist[][ruby]{
fs = File::Stat.new($0)
p fs.dev_minor
#例
#=> nil
//}

• File::Stat

File::Stat#directory? -> bool (18037.0)

• 3.2

• インスタンスメソッド

ディレクトリの時に真を返します。

ディレクトリの時に真を返します。

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

@see FileTest.#directory?

• File::Stat

File::Stat#executable? -> bool (18037.0)

• 3.2

• インスタンスメソッド

実効ユーザ/グループIDで実行できる時に真を返します。

実効ユーザ/グループIDで実行できる時に真を返します。

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

• File::Stat

File::Stat#executable_real? -> bool (18037.0)

• 3.2

• インスタンスメソッド

実ユーザ/グループIDで実行できる時に真を返します。

実ユーザ/グループIDで実行できる時に真を返します。

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

• File::Stat

絞り込み条件を変える

File::Stat#gid -> Integer (18037.0)

• 3.2

• インスタンスメソッド

オーナーのグループIDを返します。

オーナーのグループIDを返します。

//emlist[][ruby]{
fs = File::Stat.new($0)
#例
p fs.gid #=> 0
//}

• File::Stat

File::Stat#ino -> Integer (18037.0)

• 3.2

• インスタンスメソッド

i-node 番号を返します。

i-node 番号を返します。

//emlist[][ruby]{
fs = File::Stat.new($0)
#例
p fs.ino #=> 0
//}

• File::Stat

File::Stat#mode -> Integer (18037.0)

• 3.2

• インスタンスメソッド

ファイルモードを返します。

ファイルモードを返します。

//emlist[][ruby]{
fs = File::Stat.new($0)
printf "%o\n", fs.mode
#例
#=> 100644
//}

• File::Stat

File::Stat#mtime -> Time (18037.0)

• 3.2

• インスタンスメソッド

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

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

//emlist[][ruby]{
fs = File::Stat.new($0)
#例
p fs.mtime #=> Wed Sep 05 20:42:18 +0900 2007
//}

@see Time

• File::Stat
• Time

File::Stat#nlink -> Integer (18037.0)

• 3.2

• インスタンスメソッド

ハードリンクの数を返します。

ハードリンクの数を返します。

//emlist[][ruby]{
fs = File::Stat.new($0)
#例
p fs.nlink #=> 1
//}

• File::Stat

絞り込み条件を変える

File::Stat#owned? -> bool (18037.0)

• 3.2

• インスタンスメソッド

自分のものである時に真を返します。

自分のものである時に真を返します。

//emlist[][ruby]{
printf "%s %s\n", $:[0], File::Stat.new($:[0]).owned?
#例
#=> /usr/local/lib/site_ruby/1.8 false
//}

• File::Stat

File::Stat#pipe? -> bool (18037.0)

• 3.2

• インスタンスメソッド

無名パイプおよび名前つきパイプ(FIFO)の時に真を返します。

無名パイプおよび名前つきパイプ(FIFO)の時に真を返します。

//emlist[][ruby]{
system("mkfifo /tmp/pipetest")
p File::Stat.new("/tmp/pipetest").pipe? #=> true
//}

• File::Stat

File::Stat#rdev -> Integer (18037.0)

• 3.2

• インスタンスメソッド

デバイスタイプ(スペシャルファイルのみ)を返します。

デバイスタイプ(スペシャルファイルのみ)を返します。

//emlist[][ruby]{
fs = File::Stat.new($0)
#例
p fs.rdev #=> 2
//}

• File::Stat

File::Stat#rdev_major -> Integer (18037.0)

• 3.2

• インスタンスメソッド

rdev の major 番号部を返します。

rdev の major 番号部を返します。

//emlist[][ruby]{
fs = File::Stat.new($0)
#例
p fs.rdev_major #=> nil
//}

• File::Stat

File::Stat#rdev_minor -> Integer (18037.0)

• 3.2

• インスタンスメソッド

rdev の minor 番号部を返します。

rdev の minor 番号部を返します。

//emlist[][ruby]{
fs = File::Stat.new($0)
#例
p fs.rdev_minor #=> nil
//}

• File::Stat

絞り込み条件を変える

File::Stat#readable? -> bool (18037.0)

• 3.2

• インスタンスメソッド

読み込み可能な時に真を返します。

読み込み可能な時に真を返します。

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

• File::Stat

File::Stat#readable_real? -> bool (18037.0)

• 3.2

• インスタンスメソッド

実ユーザ/実グループによって読み込み可能な時に真を返します。

実ユーザ/実グループによって読み込み可能な時に真を返します。

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

• File::Stat

File::Stat#setgid? -> bool (18037.0)

• 3.2

• インスタンスメソッド

setgidされている時に真を返します。

setgidされている時に真を返します。

//emlist[][ruby]{
Dir.glob("/usr/sbin/*") {|bd|
if File::Stat.new(bd).setgid?
puts bd
end
}
#例
#...
#=> /usr/sbin/postqueue
#...
//}

• File::Stat

File::Stat#setuid? -> bool (18037.0)

• 3.2

• インスタンスメソッド

setuidされている時に真を返します。

setuidされている時に真を返します。

//emlist[][ruby]{
Dir.glob("/bin/*") {|bd|
if File::Stat.new(bd).setuid?
puts bd
end
}
#例
#...
#=> /bin/ping
#=> /bin/su
#...
//}

• File::Stat

File::Stat#size -> Integer (18037.0)

• 3.2

• インスタンスメソッド

ファイルサイズ(バイト単位)を返します。

ファイルサイズ(バイト単位)を返します。

//emlist[][ruby]{
fs = File::Stat.new($0)
#例
p fs.size #=> 1548
//}

• File::Stat

絞り込み条件を変える

File::Stat#sticky? -> bool (18037.0)

• 3.2

• インスタンスメソッド

stickyビットが立っている時に真を返します。

stickyビットが立っている時に真を返します。

//emlist[][ruby]{
Dir.glob("/usr/bin/*") {|bd|
begin
if File::Stat.new(bd).sticky?
puts bd
end
rescue
end
}
#例
#...
#=> /usr/bin/emacs-21.4
#...
//}

• File::Stat

File::Stat#uid -> Integer (18037.0)

• 3.2

• インスタンスメソッド

オーナーのユーザIDを返します。

オーナーのユーザIDを返します。

//emlist[][ruby]{
fs = File::Stat.new($0)
#例
p fs.uid #=> 0
//}

• File::Stat

File::Stat#world_readable? -> Integer | nil (18037.0)

• 3.2

• インスタンスメソッド

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

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

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

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

• File::Stat

File::Stat#world_writable? -> Integer | nil (18037.0)

• 3.2

• インスタンスメソッド

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

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

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

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

• File::Stat

File::Stat#writable? -> bool (18037.0)

• 3.2

• インスタンスメソッド

書き込み可能な時に真を返します。

書き込み可能な時に真を返します。

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

• File::Stat

絞り込み条件を変える

File::Stat#writable_real? -> bool (18037.0)

• 3.2

• インスタンスメソッド

実ユーザ/実グループによって書き込み可能な時に真を返します。

実ユーザ/実グループによって書き込み可能な時に真を返します。

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

• File::Stat

File::Stat#zero? -> bool (18037.0)

• 3.2

• インスタンスメソッド

サイズが0である時に真を返します。

サイズが0である時に真を返します。

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

• File::Stat

FileUtils#sh(*cmd) {|result, status| ... } (9337.0)

• 3.2

• インスタンスメソッド

与えられたコマンドを実行します。

与えられたコマンドを実行します。

与えられた引数が複数の場合、シェルを経由しないでコマンドを実行します。

@param cmd 引数の解釈に関しては Kernel.#exec を参照してください。


例:
sh %{ls -ltr}

sh 'ls', 'file with spaces'

# check exit status after command runs
sh %{grep pattern file} do |ok, res|
if ! ok
puts "pattern not found (status = #...

• FileUtils

FileUtils#ruby(*args) {|result, status| ... } (9301.0)

• 3.2

• インスタンスメソッド

与えられた引数で Ruby インタプリタを実行します。

与えられた引数で Ruby インタプリタを実行します。

@param args Ruby インタプリタに与える引数を指定します。

例:
ruby %{-pe '$_.upcase!' <README}

@see Kernel.#sh

• FileUtils

1.6.8から1.8.0への変更点(まとめ) (1189.0)

• 3.2

• 文書

1.6.8から1.8.0への変更点(まとめ) * ((<1.6.8から1.8.0への変更点(まとめ)/インタプリタの変更>)) * ((<1.6.8から1.8.0への変更点(まとめ)/追加されたクラス／モジュール>)) * ((<1.6.8から1.8.0への変更点(まとめ)/追加されたメソッド>)) * ((<1.6.8から1.8.0への変更点(まとめ)/追加された定数>)) * ((<1.6.8から1.8.0への変更点(まとめ)/拡張されたクラス／メソッド(互換性のある変更)>)) * ((<1.6.8から1.8.0への変更点(まとめ)/変更されたクラス／メソッド(互換性のない変更)>)) * ((<1.6.8から1.8.0への変更点(まとめ)/文法の変更>)) * ((<1.6.8から1.8.0への変更点(まとめ)/正規表現>)) * ((<1.6.8から1.8.0への変更点(まとめ)/Marshal>)) * ((<1.6.8から1.8.0への変更点(まとめ)/Windows 対応>)) * ((<1.6.8から1.8.0への変更点(まとめ)/廃止された(される予定の)機能>)) * ((<1.6.8から1.8.0への変更点(まとめ)/ライブラリ>)) * ((<1.6.8から1.8.0への変更点(まとめ)/拡張ライブラリAPI>)) * ((<1.6.8から1.8.0への変更点(まとめ)/バグ修正>)) * ((<1.6.8から1.8.0への変更点(まとめ)/サポートプラットフォームの追加>))

1.6.8から1.8.0への変更点(まとめ)
* ((<1.6.8から1.8.0への変更点(まとめ)/インタプリタの変更>))
* ((<1.6.8から1.8.0への変更点(まとめ)/追加されたクラス／モジュール>))
* ((<1.6.8から1.8.0への変更点(まとめ)/追加されたメソッド>))
* ((<1.6.8から1.8.0への変更点(まとめ)/追加された定数>))
* ((<1.6.8から1.8.0への変更点(まとめ)/拡張されたクラス／メソッド(互換性のある変更)>))
* ((<1.6.8から1.8.0への変更点(まとめ)/変更されたクラス／メソッド(互換性のない変更)>))...

絞り込み条件を変える

ruby 1.8.4 feature (991.0)

• 3.2

• 文書

ruby 1.8.4 feature ruby 1.8.4 での ruby 1.8.3 からの変更点です。

ruby 1.8.4 feature
ruby 1.8.4 での ruby 1.8.3 からの変更点です。

掲載方針

*バグ修正の影響も含めて動作が変わるものを収録する。
*単にバグを直しただけのものは収録しない。
*ライブラリへの単なる定数の追加は収録しない。

以下は各変更点に付けるべきタグです。

記号について(特に重要なものは大文字(主観))

# * カテゴリ
# * [ruby]: ruby インタプリタの変更
# * [api]: 拡張ライブラリ API
# * [lib]: ライブラリ
* レベル
* [bug]: バグ修正
* [new]: 追加され...

NEWS for Ruby 2.5.0 (703.0)

• 3.2

• 文書

NEWS for Ruby 2.5.0 このドキュメントは前回リリース以降のバグ修正を除くユーザーに影響のある機能の変更のリストです。

NEWS for Ruby 2.5.0
このドキュメントは前回リリース以降のバグ修正を除くユーザーに影響のある機能の変更のリストです。

それぞれのエントリーは参照情報があるため短いです。
十分な情報と共に書かれた全ての変更のリストは ChangeLog ファイルか bugs.ruby-lang.org の issue を参照してください。

== 2.4.0 以降の変更

=== 言語仕様の変更

* トップレベルの定数参照を削除しました 11547
* do/end ブロック内部で rescue/else/ensure を書けるようになりました 12906
* 文字列の式展...

• Array
• BasicSocket
• ConditionVariable
• Data
• Dir
• ERB
• Enumerable
• Exception
• File
• FrozenError
• Hash
• IO
• IOError
• Integer
• Kernel
• KeyError
• Logger
• Method
• Module
• Mutex
• ...

RDoc::Parser.parser_for(top_level, file_name, body, options, stats) -> RDoc::Parser (670.0)

• 3.2

• 特異メソッド

file_name を解析できるパーサのインスタンスを返します。 見つからなかった場合は RDoc::Parser::Simple のインスタンスを返します。

file_name を解析できるパーサのインスタンスを返します。
見つからなかった場合は RDoc::Parser::Simple のインスタンスを返します。

@param top_level RDoc::TopLevel オブジェクトを指定します。

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

@param body ソースコードの内容を文字列で指定します。

@param options RDoc::Options オブジェクトを指定します。

@param stats RDoc::Stats オブジェクトを指定します。

• RDoc::Options
• RDoc::Parser
• RDoc::Parser::Simple
• RDoc::Stats
• RDoc::TopLevel

static NODE * compile(VALUE src, char *file, int line) (649.0)

• 3.2

• 関数

Ruby の文字列または IO オブジェクト src を 構文木にコンパイルし、返します。そのとき、src が ファイル file の line 行目から始まっていると仮定します。

Ruby の文字列または IO オブジェクト src を
構文木にコンパイルし、返します。そのとき、src が
ファイル file の line 行目から始まっていると仮定します。

RDoc::Parser::C.new(top_level, file_name, body, options, stats) -> RDoc::Parser::C (622.0)

• 3.2

• 特異メソッド

自身を初期化します。

自身を初期化します。

@param top_level RDoc::TopLevel オブジェクトを指定します。

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

@param body ソースコードの内容を文字列で指定します。

@param options RDoc::Options オブジェクトを指定します。

@param stats RDoc::Stats オブジェクトを指定します。

• RDoc::Options
• RDoc::Parser::C
• RDoc::Stats
• RDoc::TopLevel

絞り込み条件を変える

RDoc::Parser::Ruby.new(top_level, file_name, body, options, stats) -> RDoc::Parser::Ruby (622.0)

• 3.2

• 特異メソッド

自身を初期化します。

自身を初期化します。

@param top_level RDoc::TopLevel オブジェクトを指定します。

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

@param body ソースコードの内容を文字列で指定します。

@param options RDoc::Options オブジェクトを指定します。

@param stats RDoc::Stats オブジェクトを指定します。

• RDoc::Options
• RDoc::Parser::Ruby
• RDoc::Stats
• RDoc::TopLevel

RDoc::Parser::Simple.new(top_level, file_name, body, options, stats) -> RDoc::Parser::Simple (622.0)

• 3.2

• 特異メソッド

自身を初期化します。

自身を初期化します。

@param top_level RDoc::TopLevel オブジェクトを指定します。

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

@param body 内容を文字列で指定します。

@param options RDoc::Options オブジェクトを指定します。

@param stats RDoc::Stats オブジェクトを指定します。

• RDoc::Options
• RDoc::Parser::Simple
• RDoc::Stats
• RDoc::TopLevel

static VALUE eval(VALUE self, VALUE src, VALUE scope, char *file, int line) (619.0)

• 3.2

• 関数

eval の実体。文字列 src を評価します。 そのとき第三引数 scope が nil でなければ そのコンテキストの元で評価します。

eval の実体。文字列 src を評価します。
そのとき第三引数 scope が nil でなければ
そのコンテキストの元で評価します。

また src をコンパイルするとき、
ファイル file の line 行目に配置されていると仮定します。

ruby 1.6 feature (613.0)

• 3.2

• 文書

ruby 1.6 feature ruby version 1.6 は安定版です。この版での変更はバグ修正がメイン になります。

ruby 1.6 feature
ruby version 1.6 は安定版です。この版での変更はバグ修正がメイン
になります。

((<stable-snapshot|URL:ftp://ftp.netlab.co.jp/pub/lang/ruby/stable-snapshot.tar.gz>)) は、日々更新される安定版の最新ソースです。

== 1.6.8 (2002-12-24) -> stable-snapshot

: 2003-01-22: errno

EAGAIN と EWOULDBLOCK が同じ値のシステムで、EWOULDBLOCK がなくなっ
ていま...

Ripper.lex(src, filename = &#39;-&#39;, lineno = 1, raise_errors: false) -> [[Integer, Integer], Symbol, String, Ripper::Lexer::State] (601.0)

• 3.2

• 特異メソッド

Ruby プログラム str をトークンに分割し、そのリストを返します。 ただし Ripper.tokenize と違い、トークンの種類と位置情報も付属します。

Ruby プログラム str をトークンに分割し、そのリストを返します。
ただし Ripper.tokenize と違い、トークンの種類と位置情報も付属します。

@param src Ruby プログラムを文字列か IO オブジェクトで指定します。

@param filename src のファイル名を文字列で指定します。省略すると "-" になります。

@param lineno src の開始行番号を指定します。省略すると 1 になります。

@param raise_errors true を指定すると、src にエラーがある場合に例外(SyntaxError)を発生させます。省...

• Ripper

絞り込み条件を変える

static VALUE eval_under(VALUE under, VALUE self, VALUE src, const char *file, int line) (601.0)

• 3.2

• 関数

static void rb_autoload_id(ID id, const char *filename) (601.0)

• 3.2

• 関数

CSV.open(filename, mode = "rb", options = Hash.new) -> CSV (445.0)

• 3.2

• 特異メソッド

このメソッドは IO オブジェクトをオープンして CSV でラップします。 これは CSV ファイルを書くための主要なインターフェイスとして使うことを意図しています。

このメソッドは IO オブジェクトをオープンして CSV でラップします。
これは CSV ファイルを書くための主要なインターフェイスとして使うことを意図しています。

このメソッドは IO.open と同じように動きます。ブロックが与えられた場合は
ブロックに CSV オブジェクトを渡し、ブロック終了時にそれをクローズします。
ブロックが与えられなかった場合は CSV オブジェクトを返します。

データが Encoding.default_external と異なる場合は、mode にエンコー
ディングを指定する文字列を埋め込まなければなりません。データをどのよう
に解析するか決定するため...

• CSV
• File
• IO

CSV.open(filename, mode = "rb", options = Hash.new) {|csv| ... } -> nil (445.0)

• 3.2

• 特異メソッド

このメソッドは IO オブジェクトをオープンして CSV でラップします。 これは CSV ファイルを書くための主要なインターフェイスとして使うことを意図しています。

このメソッドは IO オブジェクトをオープンして CSV でラップします。
これは CSV ファイルを書くための主要なインターフェイスとして使うことを意図しています。

このメソッドは IO.open と同じように動きます。ブロックが与えられた場合は
ブロックに CSV オブジェクトを渡し、ブロック終了時にそれをクローズします。
ブロックが与えられなかった場合は CSV オブジェクトを返します。

データが Encoding.default_external と異なる場合は、mode にエンコー
ディングを指定する文字列を埋め込まなければなりません。データをどのよう
に解析するか決定するため...

• CSV
• File
• IO

CSV.open(filename, options = Hash.new) -> CSV (445.0)

• 3.2

• 特異メソッド

このメソッドは IO オブジェクトをオープンして CSV でラップします。 これは CSV ファイルを書くための主要なインターフェイスとして使うことを意図しています。

このメソッドは IO オブジェクトをオープンして CSV でラップします。
これは CSV ファイルを書くための主要なインターフェイスとして使うことを意図しています。

このメソッドは IO.open と同じように動きます。ブロックが与えられた場合は
ブロックに CSV オブジェクトを渡し、ブロック終了時にそれをクローズします。
ブロックが与えられなかった場合は CSV オブジェクトを返します。

データが Encoding.default_external と異なる場合は、mode にエンコー
ディングを指定する文字列を埋め込まなければなりません。データをどのよう
に解析するか決定するため...

• CSV
• File
• IO

絞り込み条件を変える

CSV.open(filename, options = Hash.new) {|csv| ... } -> nil (445.0)

• 3.2

• 特異メソッド

このメソッドは IO オブジェクトをオープンして CSV でラップします。 これは CSV ファイルを書くための主要なインターフェイスとして使うことを意図しています。

このメソッドは IO オブジェクトをオープンして CSV でラップします。
これは CSV ファイルを書くための主要なインターフェイスとして使うことを意図しています。

このメソッドは IO.open と同じように動きます。ブロックが与えられた場合は
ブロックに CSV オブジェクトを渡し、ブロック終了時にそれをクローズします。
ブロックが与えられなかった場合は CSV オブジェクトを返します。

データが Encoding.default_external と異なる場合は、mode にエンコー
ディングを指定する文字列を埋め込まなければなりません。データをどのよう
に解析するか決定するため...

• CSV
• File
• IO

ruby 1.9 feature (379.0)

• 3.2

• 文書

ruby 1.9 feature ruby version 1.9.0 は開発版です。 以下にあげる機能は将来削除されたり互換性のない仕様変更がなされるかもしれません。 1.9.1 以降は安定版です。 バグ修正がメインになります。

ruby 1.9 feature
ruby version 1.9.0 は開発版です。
以下にあげる機能は将来削除されたり互換性のない仕様変更がなされるかもしれません。
1.9.1 以降は安定版です。
バグ修正がメインになります。

記号について(特に重要なものは大文字(主観))

* カテゴリ
* [ruby]: ruby インタプリタの変更
* [api]: 拡張ライブラリ API
* [lib]: ライブラリ
* [parser]: 文法の変更
* [regexp]: 正規表現の機能拡張
* [marshal]: Marshal ファイルのフォーマット変更
* ...

NEWS for Ruby 2.3.0 (217.0)

• 3.2

• 文書

NEWS for Ruby 2.3.0 このドキュメントは前回リリース以降のバグ修正を除くユーザーに影響のある機能の変更のリストです。

NEWS for Ruby 2.3.0
このドキュメントは前回リリース以降のバグ修正を除くユーザーに影響のある機能の変更のリストです。

それぞれのエントリーは参照情報があるため短いです。
十分な情報と共に書かれた全ての変更のリストは ChangeLog ファイルか bugs.ruby-lang.org の issue を参照してください。

== 2.2.0 以降の変更

=== 言語仕様の変更

* frozen-string-literal プラグマ:
* 実験的な機能として fronzen-string-literal というプラグマが導入されました。
897...

• ARGF
• Array
• Comparable
• Encoding
• Enumerable
• Enumerator::Lazy
• Fiddle
• File
• File::Stat
• Hash
• IO
• IO::WaitReadable
• IO::WaitWritable
• Kernel
• Logger
• Module
• NameError
• Net::FTP
• Net::HTTP
• Numeric
• ...

NEWS for Ruby 2.2.0 (163.0)

• 3.2

• 文書

NEWS for Ruby 2.2.0 このドキュメントは前回リリース以降のバグ修正を除くユーザーに影響のある機能の変更のリストです。

NEWS for Ruby 2.2.0
このドキュメントは前回リリース以降のバグ修正を除くユーザーに影響のある機能の変更のリストです。

それぞれのエントリーは参照情報があるため短いです。
十分な情報と共に書かれた全ての変更のリストは ChangeLog ファイルか bugs.ruby-lang.org の issue を参照してください。

== 2.1.0 以降の変更

=== 言語仕様の変更

* nil/true/false
* nil/true/false はフリーズされました 8923

* Hash リテラル
* 後ろにコロンのあるシンボルをキーにしたと...

• ArgumentError
• Binding
• Dir
• Enumerable
• Enumerator
• Fiber
• File
• File::Stat
• Float
• GC
• Hash
• IO
• Kernel
• Math
• Math::DomainError
• Method
• OpenSSL::HMAC
• Proc
• Process
• String
• ...

Pathname#chown(owner, group) -> Integer (121.0)

• 3.2

• インスタンスメソッド

File.chown(owner, group, self.to_s) と同じです。

File.chown(owner, group, self.to_s) と同じです。

@param owner オーナーを指定します。

@param group グループを指定します。

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

Pathname('testfile').stat.uid # => 501
Pathname('testfile').chown(502, 12)
Pathname('testfile').stat.uid # => 502
//}

@see File.chown, File#chown

• Pathname

絞り込み条件を変える

find (109.0)

• 3.2

• ライブラリ

ディレクトリ配下のファイルを探索するためのモジュールです。

ディレクトリ配下のファイルを探索するためのモジュールです。

=== 使い方

require "find"

Find.find('/foo','/bar') {|f| ...}

または

require "find"

include Find
find('/foo','/bar') {|f| ...}

以下は、ruby のアーカイブに含まれるサンプルスクリプト
(https://github.com/ruby/ruby/blob/master/sample/trojan.rb) をこのモジュールで書き換えたものです。

#! /usr/bin/env ...

• Find

ruby 1.8.2 feature (109.0)

• 3.2

• 文書

ruby 1.8.2 feature ruby 1.8.2 での ruby 1.8.1 からの変更点です。

ruby 1.8.2 feature
ruby 1.8.2 での ruby 1.8.1 からの変更点です。

掲載方針

*バグ修正の影響も含めて動作が変わるものを収録する。
*単にバグを直しただけのものは収録しない。
*ライブラリへの単なる定数の追加は収録しない。

以下は各変更点に付けるべきタグです。

*カテゴリ
* [ruby]: ruby インタプリタの変更
* [api]: 拡張ライブラリ API
* [lib]: ライブラリ
*レベル
* [bug]: バグ修正
* [new]: 追加されたクラス／メソッドなど
* [compat]: 変更されたクラス／...

NEWS for Ruby 2.1.0 (73.0)

• 3.2

• 文書

NEWS for Ruby 2.1.0 このドキュメントは前回リリース以降のバグ修正を除くユーザーに影響のある機能の変更のリストです。

NEWS for Ruby 2.1.0
このドキュメントは前回リリース以降のバグ修正を除くユーザーに影響のある機能の変更のリストです。

それぞれのエントリーは参照情報があるため短いです。
十分な情報と共に書かれた全ての変更のリストは ChangeLog ファイルか bugs.ruby-lang.org の issue を参照してください。

== 2.0.0 以降の変更

=== 言語仕様の変更

* キーワード引数のデフォルト値が省略可能になりました。これらの「必須キーワード引数」は呼び出し時に明示的に与えなければなりません。

* 整数や小数のリテラルの末尾に'r','i','...

• ArgumentError
• Array
• Bignum
• Binding
• Enumerable
• Exception
• GC
• Hash
• IO
• Integer
• Kernel
• Module
• Mutex
• Net::HTTP
• Numeric
• Pathname
• Proc
• Process
• Rinda::RingFinger
• Rinda::RingServer
• ...

NEWS for Ruby 3.1.0 (73.0)

• 3.2

• 文書

NEWS for Ruby 3.1.0 このドキュメントは前回リリース以降のバグ修正を除くユーザーに影響のある機能の変更のリストです。

...した。
* RubyGems 3.3.3
* base64 0.1.1
* benchmark 0.2.0
* bigdecimal 3.1.1
* bundler 2.3.3
* cgi 0.3.1
* csv 3.2.2
* date 3.2.2
* did_you_mean 1.6.1
* digest 3.1.0
* drb 2.1.0
* erb 2.2.3
* error_highlight 0.3.0
* etc 1.3.0
* fcntl 1.0....

...以下のbundled gemsが更新されました。
* minitest 5.15.0
* power_assert 2.0.1
* rake 13.0.6
* test-unit 3.5.3
* rexml 3.2.5
* rbs 2.0.0
* typeprof 0.21.1
* 以下のdefault gemsがbundled gemsに変更されました。
* net-ftp 0.1.3
* net-imap 0.2....

...12913
* Psych 4.0では、デフォルトで Psych.load が Psych.safe_load に変更されました。この動作に移行するにはPsych 3.3.2を使用する必要があるかもしれません。 17866

== C API の更新

* ドキュメント化されました。 https://github.com/ruby/...

• ArgumentError
• Array
• Class
• Enumerable
• Enumerator::Lazy
• File
• GC
• Integer
• Kernel
• Marshal
• MatchData
• Method
• Module
• Process
• Refinement
• String
• Struct
• Thread
• Thread::Queue
• Time
• ...

Dir.mkdir(path, mode = 0777) -> 0 (55.0)

• 3.2

• 特異メソッド

path で指定された新しいディレクトリを作ります。パーミッションは mode で指定された値に umask をかけた値 (mode & ~umask) になります。 mkdir(2) も参照して下さい。 ディレクトリの作成に成功すれば 0 を返します。

path で指定された新しいディレクトリを作ります。パーミッションは
mode で指定された値に umask をかけた値 (mode & ~umask) になります。
mkdir(2) も参照して下さい。
ディレクトリの作成に成功すれば 0 を返します。

@param path ディレクトリのパスを文字列で指定します。

@param mode ディレクトリのモードを整数で与えます。

@raise Errno::EXXX ディレクトリの作成に失敗した場合に発生します。

//emlist[例][ruby]{
p File.umask ...

• Dir

絞り込み条件を変える

Marshal.#dump(obj, limit = -1) -> String (55.0)

• 3.2

• モジュール関数

obj を指定された出力先に再帰的に出力します。

obj を指定された出力先に再帰的に出力します。

ファイルに書き出せないオブジェクトをファイルに書き出そうとすると
例外 TypeError が発生します。
ファイルに書き出せないオブジェクトは以下の通りです。

* 名前のついてない Class/Module オブジェクト。(この場
合は、例外 ArgumentError が発生します。無名クラスについて
は、Module.new を参照。)
* システムがオブジェクトの状態を保持するもの。具体的には以下のイン
スタンス。Dir, File::Stat, IO とそのサブクラス
File, Socket など。...

• ArgumentError
• Class
• Continuation
• Data
• Dir
• File
• File::Stat
• Hash
• IO
• Marshal
• MatchData
• Method
• Module
• Proc
• Socket
• String
• Thread
• ThreadGroup
• TypeError
• UnboundMethod

Marshal.#dump(obj, port, limit = -1) -> IO (55.0)

• 3.2

• モジュール関数

obj を指定された出力先に再帰的に出力します。

obj を指定された出力先に再帰的に出力します。

ファイルに書き出せないオブジェクトをファイルに書き出そうとすると
例外 TypeError が発生します。
ファイルに書き出せないオブジェクトは以下の通りです。

* 名前のついてない Class/Module オブジェクト。(この場
合は、例外 ArgumentError が発生します。無名クラスについて
は、Module.new を参照。)
* システムがオブジェクトの状態を保持するもの。具体的には以下のイン
スタンス。Dir, File::Stat, IO とそのサブクラス
File, Socket など。...

• ArgumentError
• Class
• Continuation
• Data
• Dir
• File
• File::Stat
• Hash
• IO
• Marshal
• MatchData
• Method
• Module
• Proc
• Socket
• String
• Thread
• ThreadGroup
• TypeError
• UnboundMethod