バージョン:2.4.0 > クラス:IO > ライブラリ:ビルトイン

150件ヒット [1-100件を表示] （0.036秒）

トップページ >

:2.4.0

> クラス:IO

:ビルトイン

種類

キーワード

<< (1)
SEEK_CUR (1)
SEEK_DATA (1)
SEEK_END (1)
SEEK_HOLE (1)
SEEK_SET (1)
advise (1)
autoclose= (1)
autoclose? (1)
binmode (1)
binmode? (1)
binread (1)
binwrite (1)
bytes (2)
chars (2)
clone (1)
close (1)
close_on_exec= (1)
close_on_exec? (1)
close_read (1)
close_write (1)
closed? (1)
codepoints (2)
copy_stream (2)
dup (1)
each (6)
each_byte (2)
each_char (2)
each_codepoint (2)
each_line (6)
eof (1)
eof? (1)
external_encoding (1)
fcntl (1)
fdatasync (1)
fileno (1)
flush (1)
for_fd (1)
foreach (2)
fsync (1)
getbyte (1)
getc (1)
gets (3)
internal_encoding (1)
ioctl (1)
isatty (1)
lineno (1)
lineno= (1)
lines (6)
new (1)
open (2)
pid (1)
pipe (8)
popen (14)
pos (1)
pos= (1)
print (1)
printf (1)
putc (1)
puts (1)
read (4)
read_nonblock (1)
readbyte (1)
readchar (1)
readline (3)
readlines (6)
readpartial (1)
reopen (3)
rewind (1)
seek (1)
select (1)
set_encoding (3)
stat (1)
sync (1)
sync= (1)
sysopen (1)
sysread (1)
sysseek (1)
syswrite (1)
tell (1)
to_i (1)
to_io (1)
try_convert (1)
tty? (1)
ungetbyte (1)
ungetc (1)
write (3)
write_nonblock (1)

検索結果

<< 1 2 > >>

IO#<<(object) -> self (10.0)

2.4.0

インスタンスメソッド

object を出力します。object が文字列でない時にはメソッド to_s を用いて文字列に変換します。

object を出力します。object が文字列でない時にはメソッ
ド to_s を用いて文字列に変換します。

以下のような << の連鎖を使うことができます。

STDOUT << 1 << " is a " << Integer << "\n"

@param object 出力したいオブジェクトを与えます。

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

IO#advise(advice, offset=0, len=0) -> nil (10.0)

2.4.0

インスタンスメソッド

posix_fadvise(2) を呼びだし、ファイルへのアクセスパターンをOSに知らせます。

...表すシンボル
@param offset パターンを指定するデータの先頭位置
@param len パターンを指定するデータの長さ

@raise IOError ストリームが既に閉じられているときに発生する例外
@raise Errno::EBADF ファイルデスクリプタが不正である...

IO#autoclose=(bool) (10.0)

2.4.0

インスタンスメソッド

auto-close フラグを設定します。

...close しません。

@param bool 真偽値でフラグを設定します
@see IO#autoclose?

f = open("/dev/null")
IO.for_fd(f.fileno)
# ...
f.gets # may cause Errno::EBADF

f = open("/dev/null")
IO.for_fd(f.fileno).autoclose = false
# ...
f.gets # won't cause Errno::EBADF...

IO#autoclose? -> bool (10.0)

2.4.0

インスタンスメソッド

auto-close フラグを返します。

...auto-close フラグを返します。

//emlist[例][ruby]{
IO.open(IO.sysopen("testfile")) do |io|
io.autoclose? # => true
io.autoclose = false
io.autoclose? # => false
end
//}

@see IO#autoclose=...

IO#binmode -> self (10.0)

2.4.0

インスタンスメソッド

ストリームをバイナリモードにします。MSDOS などバイナリモードの存在する OS でのみ有効です。そうでない場合このメソッドは何もしません。

...ンしかありません。

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

//emlist[例][ruby]{
IO.open(IO.sysopen("testfile", "w+")) do |io|
io.binmode? # => false
io.binmode # => #<IO:fd 8>
io.binmode? # => true
end
//}

@see c:IO#io_binmode, IO#binmode?...

絞り込み条件を変える

IO#binmode? -> bool (10.0)

2.4.0

インスタンスメソッド

自身がバイナリモードなら true を返します。そうでない場合、false を返します。

...自身がバイナリモードなら true を返します。そうでない場合、false を返します。

@see c:IO#io_binmode, IO#binmode...

IO#bytes -> Enumerator (10.0)

2.4.0

インスタンスメソッド

このメソッドは obsolete です。代わりに IO#each_byte を使用してください。使用すると警告メッセージが表示されます。

...このメソッドは obsolete です。
代わりに IO#each_byte を使用してください。
使用すると警告メッセージが表示されます。

IO の現在位置から 1 バイトずつ読み込み、それを整数として与え、ブロックを実行します。

ブロック...

...が与えられなかった場合は、自身から生成した
Enumerator オブジェクトを返します。

バイナリ読み込みメソッドとして動作します。

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

@see IO#each_byte...

IO#bytes {|ch| ... } -> self (10.0)

2.4.0

インスタンスメソッド

このメソッドは obsolete です。代わりに IO#each_byte を使用してください。使用すると警告メッセージが表示されます。

IO#chars -> Enumerator (10.0)

2.4.0

インスタンスメソッド

このメソッドは obsolete です。代わりに IO#each_char を使用してください。

...このメソッドは obsolete です。
代わりに IO#each_char を使用してください。

使用すると警告メッセージが表示されます。

self に含まれる文字を一文字ずつブロックに渡して評価します。

self は読み込み用にオープンされてい...

...なければなりません。

ブロックを省略した場合は各文字について繰り返す Enumerator を返します。

@raise IOError self が読み込み用にオープンされていない場合に発生します。

@see IO#each_char...

IO#chars {|c| ... } -> self (10.0)

2.4.0

インスタンスメソッド

このメソッドは obsolete です。代わりに IO#each_char を使用してください。

絞り込み条件を変える

IO#clone -> IO (10.0)

2.4.0

インスタンスメソッド

レシーバと同じ IO を参照する新しい IO オブジェクトを返します。参照しているファイル記述子は dup(2) されます。

...シーバと同じ IO を参照する新しい IO オブジェクトを返します。
参照しているファイル記述子は dup(2) されます。

clone の際に self は一旦 IO#flush されます。
フリーズした IO の clone は同様にフリーズされた IO を返しますが、...

...しいフリーズされていない IO を返します。

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

//emlist[例][ruby]{
clone_io = nil
IO.write("testfile", "test")
File.open("testfile") do |io|
clone_io = io.clone
end
clone_io.read # => "test"
clone_io.close
//}...

IO#close -> nil (10.0)

2.4.0

インスタンスメソッド

入出力ポートをクローズします。

...ポートをクローズします。

以後このポートに対して入出力を行うと例外 IOError が発生しま
す。ガーベージコレクトの際にはクローズされていない IO ポートはクロー
ズされます。
self がパイプでプロセスにつながっていれ...

...se Errno::EXXX close に失敗した場合に発生します。

//emlist[例][ruby]{
IO.write("testfile", "test")
f = File.open("testfile")
f.read # => "test"
f.close
# f.read # => IOError (すでに close しているので read できない)
//}

@see IO#closed?, IO#close_read, IO#close_write...

IO#close_on_exec=(bool) (10.0)

2.4.0

インスタンスメソッド

自身に close-on-exec フラグを設定します。

...2)
@param bool 自身の close-on-exec フラグを true か false で指定します。

f = open("/dev/null")
f.close_on_exec = true
system("cat", "/proc/self/fd/#{f.fileno}") # cat: /proc/self/fd/3: No such file or directory
f.closed? #=> false

@see IO#close_on_exec?...

IO#close_on_exec? -> bool (10.0)

2.4.0

インスタンスメソッド

自身に close-on-exec フラグが設定されていた場合 true を返します。そうでない場合に false を返します。

...ます。
そうでない場合に false を返します。

f = open("/dev/null")
f.close_on_exec? #=> true
f.close_on_exec = false
f.close_on_exec? #=> false
f.close_on_exec = true
f.close_on_exec? #=> true

@see IO#close_on_exec=...

IO#close_read -> nil (10.0)

2.4.0

インスタンスメソッド

読み込み用の IO を close します。主にパイプや読み書き両用に作成した IO オブジェクトで使用します。

...読み込み用の IO を close します。主にパイプや読み書き両用に作成し
た IO オブジェクトで使用します。

既に close されていた場合には単に無視されます。

@raise IOError 自身が読み込み用にオープンされていなければ発生し...

...ます。

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

//emlist[例][ruby]{
IO.popen("/bin/sh","r+") do |f|
f.close_read
# f.readlines # => IOError: not opened for reading
end
//}

@see IO#close, IO#closed?, IO#close_write...

絞り込み条件を変える

IO#close_write -> nil (10.0)

2.4.0

インスタンスメソッド

書き込み用の IO を close します。

...の IO を close します。

既に close されていた場合には単に無視されます。

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

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

//emlist[例][ruby]{
f = IO.popen...

...("/bin/sh","r+") do |f|
f.close_write
# f.print "nowhere" # => IOError: not opened for writing
end
//}

@see IO#close, IO#closed?, IO#close_read...

IO#closed? -> bool (10.0)

2.4.0

インスタンスメソッド

self が完全に(読み込み用と書き込み用の両方が)クローズされている場合に true を返します。そうでない場合は false を返します。

...t[例][ruby]{
IO.write("testfile", "test")
f = File.new("testfile")
f.close # => nil
f.closed? # => true
f = IO.popen("/bin/sh","r+")
f.close_write # => nil
f.closed? # => false
f.close_read # => nil
f.closed? # => true
//}

@see IO#close, IO#close_read, IO#close_write...

IO#codepoints -> Enumerator (10.0)

2.4.0

インスタンスメソッド

このメソッドは obsolete です。代わりに IO#each_codepoint を使用してください。

...このメソッドは obsolete です。
代わりに IO#each_codepoint を使用してください。

使用すると警告メッセージが表示されます。

IO の各コードポイントに対して繰り返しブロックを呼びだします。

ブロックの引数にはコードポ...

...イントを表す整数が渡されます。

ブロックを省略した場合には、Enumerator を返します。

@see IO#each_codepoint...

IO#codepoints {|c| ... } -> self (10.0)

2.4.0

インスタンスメソッド

このメソッドは obsolete です。代わりに IO#each_codepoint を使用してください。

...イントを表す整数が渡されます。

ブロックを省略した場合には、Enumerator を返します。

@see IO#each_codepoint...

IO#dup -> IO (10.0)

2.4.0

インスタンスメソッド

レシーバと同じ IO を参照する新しい IO オブジェクトを返します。参照しているファイル記述子は dup(2) されます。

絞り込み条件を変える

IO#each(limit, chomp: false) -> Enumerator (10.0)

2.4.0

インスタンスメソッド

IO の現在位置から 1 行ずつ文字列として読み込み、それを引数として与えられたブロックを実行します。

...
IO の現在位置から 1 行ずつ文字列として読み込み、それを引数として
与えられたブロックを実行します。

ブロックが与えられなかった場合は、自身から生成した
Enumerator オブジェクトを返します。

テキスト読み込みメソ...

...と各行の末尾から "\n", "\r", または "\r\n" を取り除きます。

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

//emlist[例: 引数なし][ruby]{
IO.write("testfile", "This is line one,\nThis is line two,\nThis is line three,\nAnd so...

...is is line three,\n"
# "4: And so on..."
//}
//emlist[例: 行の区切りに半角カンマ、最大読み取りバイト数に 10 を指定][ruby]{
IO.write("testfile", "This is line one,This is line two,This is line three,And so on...")
f = File.new("testfile")
f.each(",", 10) { |line| p "#{f.lin...

IO#each(limit, chomp: false) {|line| ... } -> self (10.0)

2.4.0

インスタンスメソッド

IO の現在位置から 1 行ずつ文字列として読み込み、それを引数として与えられたブロックを実行します。

IO#each(rs = $/, chomp: false) -> Enumerator (10.0)

2.4.0

インスタンスメソッド

IO の現在位置から 1 行ずつ文字列として読み込み、それを引数として与えられたブロックを実行します。

IO#each(rs = $/, chomp: false) {|line| ... } -> self (10.0)

2.4.0

インスタンスメソッド

IO の現在位置から 1 行ずつ文字列として読み込み、それを引数として与えられたブロックを実行します。

IO#each(rs, limit, chomp: false) -> Enumerator (10.0)

2.4.0

インスタンスメソッド

IO の現在位置から 1 行ずつ文字列として読み込み、それを引数として与えられたブロックを実行します。

絞り込み条件を変える

IO#each(rs, limit, chomp: false) {|line| ... } -> self (10.0)

2.4.0

インスタンスメソッド

IO の現在位置から 1 行ずつ文字列として読み込み、それを引数として与えられたブロックを実行します。

IO#each_byte -> Enumerator (10.0)

2.4.0

インスタンスメソッド

IO の現在位置から 1 バイトずつ読み込み、それを整数として与え、ブロックを実行します。

...
IO の現在位置から 1 バイトずつ読み込み、それを整数として与え、ブロックを実行します。

ブロックが与えられなかった場合は、自身から生成した
Enumerator オブジェクトを返します。

バイナリ読み込みメソッドとして動...

...作します。

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

//emlist[例][ruby]{
IO.write("testfile", "aあ")
File.open("testfile") do |io|
io.each_byte { |x| p x }
# => 97
# 227
# 129
# 130
end
//}...

IO#each_byte {|ch| ... } -> self (10.0)

2.4.0

インスタンスメソッド

IO の現在位置から 1 バイトずつ読み込み、それを整数として与え、ブロックを実行します。

IO#each_char -> Enumerator (10.0)

2.4.0

インスタンスメソッド

self に含まれる文字を一文字ずつブロックに渡して評価します。

...れていなければなりません。

ブロックを省略した場合は各文字について繰り返す Enumerator を返します。

@raise IOError self が読み込み用にオープンされていない場合に発生します。

f = File.new("testfile")
f.each_char {|c| print c, ' '...

IO#each_char {|c| ... } -> self (10.0)

2.4.0

インスタンスメソッド

self に含まれる文字を一文字ずつブロックに渡して評価します。

絞り込み条件を変える

IO#each_codepoint -> Enumerator (10.0)

2.4.0

インスタンスメソッド

IO の各コードポイントに対して繰り返しブロックを呼びだします。

...
IO の各コードポイントに対して繰り返しブロックを呼びだします。

ブロックの引数にはコードポイントを表す整数が渡されます。

ブロックを省略した場合には、Enumerator を返します。

//emlist[例][ruby]{
IO.write("testfile", "abcde...

IO#each_codepoint {|c| ... } -> self (10.0)

2.4.0

インスタンスメソッド

IO の各コードポイントに対して繰り返しブロックを呼びだします。

IO#each_line(limit, chomp: false) -> Enumerator (10.0)

2.4.0

インスタンスメソッド

IO の現在位置から 1 行ずつ文字列として読み込み、それを引数として与えられたブロックを実行します。

IO#each_line(limit, chomp: false) {|line| ... } -> self (10.0)

2.4.0

インスタンスメソッド

IO の現在位置から 1 行ずつ文字列として読み込み、それを引数として与えられたブロックを実行します。

IO#each_line(rs = $/, chomp: false) -> Enumerator (10.0)

2.4.0

インスタンスメソッド

IO の現在位置から 1 行ずつ文字列として読み込み、それを引数として与えられたブロックを実行します。

絞り込み条件を変える

IO#each_line(rs = $/, chomp: false) {|line| ... } -> self (10.0)

2.4.0

インスタンスメソッド

IO の現在位置から 1 行ずつ文字列として読み込み、それを引数として与えられたブロックを実行します。

IO#each_line(rs, limit, chomp: false) -> Enumerator (10.0)

2.4.0

インスタンスメソッド

IO の現在位置から 1 行ずつ文字列として読み込み、それを引数として与えられたブロックを実行します。

IO#each_line(rs, limit, chomp: false) {|line| ... } -> self (10.0)

2.4.0

インスタンスメソッド

IO の現在位置から 1 行ずつ文字列として読み込み、それを引数として与えられたブロックを実行します。

IO#eof -> bool (10.0)

2.4.0

インスタンスメソッド

ストリームがファイルの終端に達した場合、true を返します。そうでない場合、false を返します。

...ックします。

r, w = IO.pipe
Thread.new { sleep 10; w.close }
r.eof? #=> 10秒ブロックしてから true を返す。

r, w = IO.pipe
Thread.new { sleep 10; w.puts "a" }
r.eof? #=> 10秒ブロックしてから false を返す。

r, w = IO.pipe
r.eof? # 永久に...

...ブロックします。

eof, eof? は入力バッファにデータを読み込むので、IO#sysread と同時に使うと正常に
動作しません。

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

IO#eof? -> bool (10.0)

2.4.0

インスタンスメソッド

ストリームがファイルの終端に達した場合、true を返します。そうでない場合、false を返します。

絞り込み条件を変える

IO#external_encoding -> Encoding | nil (10.0)

2.4.0

インスタンスメソッド

IO の外部エンコーディングを返します。外部エンコーディングが指定されていない場合は nil を返します。ただし読み込み専用モードの場合は Encoding.default_external になります。

...
IO の外部エンコーディングを返します。
外部エンコーディングが指定されていない場合は nil を返します。
ただし読み込み専用モードの場合は Encoding.default_external になります。

//emlist[例][ruby]{
IO.write("testfile", "abcde")
File.ope...

IO#fcntl(cmd, arg = 0) -> Integer (10.0)

2.4.0

インスタンスメソッド

IOに対してシステムコール fcntl を実行します。機能の詳細は fcntl(2) を参照してください。 fcntl(2) が返した整数を返します。

...
IOに対してシステムコール fcntl を実行します。
機能の詳細は fcntl(2) を参照してください。
fcntl(2) が返した整数を返します。

@param cmd IO に対するコマンドを、添付ライブラリ fcntl が提供している定数で指定します。

@param...

...ます。

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

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

//emlist[例][ruby]{
require "fcntl"

IO.write("testfile", "abcde")
# ファイル状態フラグを読み出す
File.open("testfile") do |...

IO#fdatasync -> 0 (10.0)

2.4.0

インスタンスメソッド

IO のすべてのバッファされているデータを直ちにディスクに書き込みます。

...
IO のすべてのバッファされているデータを直ちにディスクに書き込みます。

fdatasync(2) をサポートしていない OS 上では代わりに
IO#fsync を呼びだします。

IO#fsync との違いは fdatasync(2) を参照してください。

@raise NotImplemented...

IO#fileno -> Integer (10.0)

2.4.0

インスタンスメソッド

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

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

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

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

@see Dir#fileno...

IO#flush -> self (10.0)

2.4.0

インスタンスメソッド

IO ポートの内部バッファをフラッシュします。

...
IO ポートの内部バッファをフラッシュします。

このメソッドを使ったとき、即座にメタデータを更新することは保証されません(特にWindowsで)。
即座にメタデータも更新したいときは IO#fsync を使います。

@raise IOError 自身...

絞り込み条件を変える

IO#fsync -> 0 (10.0)

2.4.0

インスタンスメソッド

書き込み用の IO に対して、システムコール fsync(2) を実行します。IO#flush を行ったあと、(OSレベルで)まだディスクに書き込まれていないメモリ上にあるデータをディスクに書き出します。

...書き込み用の IO に対して、システムコール fsync(2)
を実行します。IO#flush を行ったあと、(OSレベルで)まだディスクに
書き込まれていないメモリ上にあるデータをディスクに書き出します。

成功すれば 0 を返します。
fsync(2...

...) がサポートされていない場合は nil を返します。

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

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

IO#getbyte -> Integer | nil (10.0)

2.4.0

インスタンスメソッド

IO から1バイトを読み込み整数として返します。既に EOF に達していれば nil を返します。

...
IO から1バイトを読み込み整数として返します。
既に EOF に達していれば nil を返します。

f = File.new("testfile")
f.getbyte #=> 84
f.getbyte #=> 104...

IO#getc -> String | nil (10.0)

2.4.0

インスタンスメソッド

IO ポートから外部エンコーディングに従い 1 文字読み込んで返します。 EOF に到達した時には nil を返します。

...
IO ポートから外部エンコーディングに従い 1 文字読み込んで返します。
EOF に到達した時には nil を返します。

テキスト読み込みメソッドとして動作します。

IO#readchar との違いは EOF での振る舞いのみです。

@raise IOError...

...ープンされていなければ発生します。

例:
File.write("testfile", "test")
f = File.new("testfile")
p f.getc #=> "い"
p f.getc #=> "ろ"
p f.getc #=> "は"
f.read
f.getc #=> nil

@see IO#readchar...

IO#gets(limit, chomp: false) -> String | nil (10.0)

2.4.0

インスタンスメソッド

一行読み込んで、読み込みに成功した時にはその文字列を返します。 EOF に到達した時には nil を返します。

...il を返します。

テキスト読み込みメソッドとして動作します。

読み込んだ文字列を変数 $_ にセットします。
IO#readline との違いは EOF での振る舞いのみです。

limit で最大の読み込みバイト数を指定します。ただし
ファイ...

...の読み込みバイト数
@param chomp true を指定すると各行の末尾から "\n", "\r", または "\r\n" を取り除きます。

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

f = File.new("oneline_file")
f.gets...

...#=> "This is line one\n"
$_ #=> "This is line one\n"
f.gets #=> nil
$_ #=> nil

@see $/, IO#readline...

IO#gets(rs = $/, chomp: false) -> String | nil (10.0)

2.4.0

インスタンスメソッド

一行読み込んで、読み込みに成功した時にはその文字列を返します。 EOF に到達した時には nil を返します。

...#=> "This is line one\n"
$_ #=> "This is line one\n"
f.gets #=> nil
$_ #=> nil

@see $/, IO#readline...

絞り込み条件を変える

IO#gets(rs, limit, chomp: false) -> String | nil (10.0)

2.4.0

インスタンスメソッド

一行読み込んで、読み込みに成功した時にはその文字列を返します。 EOF に到達した時には nil を返します。

...#=> "This is line one\n"
$_ #=> "This is line one\n"
f.gets #=> nil
$_ #=> nil

@see $/, IO#readline...

IO#internal_encoding -> Encoding | nil (10.0)

2.4.0

インスタンスメソッド

IO の内部エンコーディングを返します。内部エンコーディングが指定されていない場合は nil を返します。

...
IO の内部エンコーディングを返します。
内部エンコーディングが指定されていない場合は nil を返します。

//emlist[例][ruby]{
IO.write("testfile", "abcde")
File.open("testfile") do |f|
p f.internal_encoding # => nil
f.set_encoding("ASCII-8BIT", "EUC-JP"...

IO#ioctl(cmd, arg = 0) -> Integer (10.0)

2.4.0

インスタンスメソッド

IO に対してシステムコール ioctl を実行し、その結果を返します。機能の詳細は ioctl(2) を参照してください。

...
IO に対してシステムコール ioctl を実行し、その結果を返します。
機能の詳細は ioctl(2) を参照してください。

@param cmd IO に対するコマンドを整数で指定します。どのようなコマンドが使えるかはプラットフォームに依存し...

...。整数の時にはその値を ioctl に渡します。
文字列の場合には Array#pack した構造体だとみなして渡します。
arg が nil か false の場合には 0を、true の場合には 1 を渡します。

@raise IOError 既に close されている場...

IO#isatty -> bool (10.0)

2.4.0

インスタンスメソッド

入出力ポートがttyに結合している時、真を返します。そうでない場合 false を返します。

...入出力ポートがttyに結合している時、真を返します。そうでない場合 false を返します。

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

//emlist[例][ruby]{
File.new("testfile").isatty # => false
File.new("/dev/tty").isatty # => true
//}...

IO#lineno -> Integer (10.0)

2.4.0

インスタンスメソッド

現在の行番号を整数で返します。実際には IO#gets が呼ばれた回数です。改行以外のセパレータで gets が呼ばれた場合など、実際の行番号と異なる場合があります。

...現在の行番号を整数で返します。実際には IO#gets が呼ばれた回数です。
改行以外のセパレータで gets が呼ばれた場合など、実際の行番号と異なる場合があります。

@raise IOError 読み込み用にオープンされていなければ発生...

絞り込み条件を変える

IO#lineno=(number) (10.0)

2.4.0

インスタンスメソッド

現在の行番号を number にセットします。 $. は次回の読み込みの時に更新されます。

...ber にセットします。 $. は次回の読み込みの時に更新されます。

@param number 行番号を整数で指定します。

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

f = File.new("testfile")
f.gets #=> "This is...

IO#lines(limit) -> Enumerator (10.0)

2.4.0

インスタンスメソッド

このメソッドは obsolete です。代わりに IO#each_line を使用してください。

...このメソッドは obsolete です。
代わりに IO#each_line を使用してください。

使用すると警告メッセージが表示されます。

IO の現在位置から 1 行ずつ文字列として読み込み、それを引数として
与えられたブロックを実行しま...

...空文字列 "" を指定すると連続する改行を行の区切りとみなします(パラグラフモード)。
@param limit 最大の読み込みバイト数

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

@see $/, IO#each_line...

IO#lines(limit) {|line| ... } -> self (10.0)

2.4.0

インスタンスメソッド

このメソッドは obsolete です。代わりに IO#each_line を使用してください。

IO#lines(rs = $/) -> Enumerator (10.0)

2.4.0

インスタンスメソッド

このメソッドは obsolete です。代わりに IO#each_line を使用してください。

IO#lines(rs = $/) {|line| ... } -> self (10.0)

2.4.0

インスタンスメソッド

このメソッドは obsolete です。代わりに IO#each_line を使用してください。

絞り込み条件を変える

IO#lines(rs, limit) -> Enumerator (10.0)

2.4.0

インスタンスメソッド

このメソッドは obsolete です。代わりに IO#each_line を使用してください。

IO#lines(rs, limit) {|line| ... } -> self (10.0)

2.4.0

インスタンスメソッド

このメソッドは obsolete です。代わりに IO#each_line を使用してください。

IO#pid -> Integer | nil (10.0)

2.4.0

インスタンスメソッド

自身が IO.popen で作られたIOポートなら、子プロセスのプロセス ID を返します。それ以外は nil を返します。

...自身が IO.popen で作られたIOポートなら、子プロセスのプロセス ID を
返します。それ以外は nil を返します。

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

//emlist[例][ruby]{
IO.popen("-") do |pipe|
if pipe
$stderr.puts "In pare...

IO#pos -> Integer (10.0)

2.4.0

インスタンスメソッド

ファイルポインタの現在の位置を整数で返します。

...ファイルポインタの現在の位置を整数で返します。

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

//emlist[例][ruby]{
IO.write("testfile", "This is line one\n")
File.open("testfile") do |f|
f.pos # => 0
f.gets # => "This is line one\n"
f.pos...

IO#pos=(n) (10.0)

2.4.0

インスタンスメソッド

ファイルポインタを指定位置に移動します。 IO#seek(n, IO::SEEK_SET) と同じです。

...ンタを指定位置に移動します。
IO#seek(n, IO::SEEK_SET) と同じです。

@param n 先頭からのオフセットを整数で指定します。

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

//emlist[例][ruby]{
IO.write("testfile", "This is line one\nThis is...

絞り込み条件を変える

IO#print(*arg) -> nil (10.0)

2.4.0

インスタンスメソッド

引数を IO ポートに順に出力します。引数を省略した場合は、$_ を出力します。

...引数を IO ポートに順に出力します。引数を省略した場合は、$_ を出力します。

@param arg Kernel.#print と同じです。

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

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

IO#printf(format, *arg) -> nil (10.0)

2.4.0

インスタンスメソッド

C 言語の printf と同じように、format に従い引数を文字列に変換して、self に出力します。

...第一引数に IO を指定できないこと、引数を省略できないことを除けば Kernel.#printf と同じです。

@param format Kernel.#printf と同じです。print_format を参照してください。

@param arg Kernel.#printf と同じです。

@raise IOError 自身が書き...

IO#putc(ch) -> object (10.0)

2.4.0

インスタンスメソッド

文字 ch を self に出力します。引数の扱いは Kernel.#putc と同じです。詳細はこちらを参照してください。ch を返します。

...参照し
てください。ch を返します。

@param ch 出力したい文字を、文字列か文字コード(整数)で与えます。

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

@raise Errno::EXXX 出力に失敗した場合に発生し...

IO#puts(*obj) -> nil (10.0)

2.4.0

インスタンスメソッド

各 obj を self に出力し、それぞれの後に改行を出力します。引数の扱いは Kernel.#puts と同じです。詳細はこちらを参照してください。

...はこちらを参照し
てください。

@param obj 出力したいオブジェクトを指定します。Kernel.#puts と同じです。

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

@raise Errno::EXXX 出力に失敗した場合に発生し...

IO#read(length = nil, outbuf = "") -> String | nil (10.0)

2.4.0

インスタンスメソッド

length バイト読み込んで、その文字列を返します。

...の全てのデータを読み込んで、その文字列を返します。

@param outbuf 出力用のバッファを文字列で指定します。IO#read は読み込んだ
データをその文字列オブジェクトに上書きして返します。指定し
た文字...

...旦 length 長に拡張(ある
いは縮小)されたあと、実際に読み込んだデータのサイズになります。

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

@raise Errno::EXXX データの読み込みに失敗した場...

...負の場合に発生します。

第二引数を指定した read の呼び出しでデータが空であった場合
(read が nil を返す場合)、outbuf は空文字列になります。

outbuf = "x" * 20;
io = File.open("/dev/null")
p io.read(10,outbuf)
p outbuf
=> nil
""...

絞り込み条件を変える

IO#read_nonblock(maxlen, outbuf = nil, exception: true) -> String | Symbol | nil (10.0)

2.4.0

インスタンスメソッド

IO をノンブロッキングモードに設定し、その後で read(2) システムコールにより長さ maxlen を上限として読み込み、文字列として返します。 EAGAIN, EINTR などは Errno::EXXX 例外として呼出元に報告されます。

...
IO をノンブロッキングモードに設定し、
その後で read(2) システムコールにより
長さ maxlen を上限として読み込み、文字列として返します。
EAGAIN, EINTR などは Errno::EXXX 例外として呼出元に報告されます。

発生した例外がErr...

...no::EAGAIN、 Errno::EWOULDBLOCK である場合は、
その例外オブジェクトに IO::WaitReadable が Object#extend
されます。

なお、バッファが空でない場合は、read_nonblock はバッファから読み込みます。この場合、read(2) システムコールは呼ば...

...れません。

このメソッドはノンブロッキングモードにする点を除いて IO#readpartial と
同じであることに注意してください。

バイナリ読み込みメソッドとして動作します。

既に EOF に達していれば EOFError が発生します。た...

IO#readbyte -> Integer (10.0)

2.4.0

インスタンスメソッド

IO から1バイトを読み込み整数として返します。既に EOF に達していれば EOFError が発生します。

...
IO から1バイトを読み込み整数として返します。
既に EOF に達していれば EOFError が発生します。

@raise EOFError 既に EOF に達している場合に発生します。

//emlist[例][ruby]{
IO.write("testfile", "123")
File.open("testfile") do |f|
begin
f.rea...

IO#readchar -> String (10.0)

2.4.0

インスタンスメソッド

IO ポートから 1 文字読み込んで返します。 EOF に到達した時には EOFError が発生します。

...
IO ポートから 1 文字読み込んで返します。
EOF に到達した時には EOFError が発生します。

テキスト読み込みメソッドとして動作します。

IO#getc との違いは EOF での振る舞いのみです。

@raise EOFError EOF に到達した時に発生し...

...ます。

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

f = File.new("testfile")
p f.readchar #=> "い"
p f.readchar #=> "ろ"
p f.readchar #=> "は"
f.read
f.readchar...

...#=> EOFError

@see IO#getc...

IO#readline(limit, chomp: false) -> String (10.0)

2.4.0

インスタンスメソッド

一行読み込んで、読み込みに成功した時にはその文字列を返します。 EOF に到達した時には EOFError が発生します。

...が発生します。

テキスト読み込みメソッドとして動作します。

読み込んだ文字列を変数 $_ にセットします。IO#gets との違いは EOF での振る舞いのみです。

limit で最大読み込みバイト数を指定します。ただしマルチバイト...

...と各行の末尾から "\n", "\r", または "\r\n" を取り除きます。

@raise EOFError EOF に到達した時に発生します。

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

f = File.new("oneline_file")
f.readline...

...#=> "This is line one\n"
$_ #=> "This is line one\n"
f.readline #=> EOFError
$_ #=> nil

@see $/, IO#gets...

IO#readline(rs = $/, chomp: false) -> String (10.0)

2.4.0

インスタンスメソッド

一行読み込んで、読み込みに成功した時にはその文字列を返します。 EOF に到達した時には EOFError が発生します。

...#=> "This is line one\n"
$_ #=> "This is line one\n"
f.readline #=> EOFError
$_ #=> nil

@see $/, IO#gets...

絞り込み条件を変える

IO#readline(rs, limit, chomp: false) -> String (10.0)

2.4.0

インスタンスメソッド

一行読み込んで、読み込みに成功した時にはその文字列を返します。 EOF に到達した時には EOFError が発生します。

...#=> "This is line one\n"
$_ #=> "This is line one\n"
f.readline #=> EOFError
$_ #=> nil

@see $/, IO#gets...

IO#readlines(limit, chomp: false) -> [String] (10.0)

2.4.0

インスタンスメソッド

データを全て読み込んで、その各行を要素としてもつ配列を返します。既に EOF に達していれば空配列 [] を返します。

...@param chomp true を指定すると各行の末尾から rs を取り除きます。

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

//emlist[例][ruby]{
IO.write("testfile", "line1,\nline2,\nline3,\n")
File.open("testfile") { |f| p f.readlines }...

...chomp = true）][ruby]{
IO.write("testfile", "line1,\rline2,\r\nline3,\n")
File.open("testfile") { |f| p f.readlines(chomp: true) } # => ["line1,\rline2,", "line3,"]
File.open("testfile") { |f| p f.readlines("\r", chomp: true) } # => ["line1,", "line2,", "\nline3,\n"]
//}

@see $/, IO#gets...

IO#readlines(rs = $/, chomp: false) -> [String] (10.0)

2.4.0

インスタンスメソッド

データを全て読み込んで、その各行を要素としてもつ配列を返します。既に EOF に達していれば空配列 [] を返します。

IO#readlines(rs, limit, chomp: false) -> [String] (10.0)

2.4.0

インスタンスメソッド

データを全て読み込んで、その各行を要素としてもつ配列を返します。既に EOF に達していれば空配列 [] を返します。

IO#readpartial(maxlen, outbuf = "") -> String (10.0)

2.4.0

インスタンスメソッド

IO から長さ maxlen を上限として読み込み、文字列として返します。即座に得られるデータが存在しないときにはブロックしてデータの到着を待ちます。即座に得られるデータが 1byte でも存在すればブロックしません。

...
IO から長さ maxlen を上限として読み込み、文字列として返します。
即座に得られるデータが存在しないときにはブロックしてデータの到着を待ちます。
即座に得られるデータが 1byte でも存在すればブロックしません。

バ...

...動作するよう設計されています。
readpartial がブロックするのは次の全ての条件が満たされたときだけです。
* IO オブジェクト内のバッファが空
* ストリームにデータが到着していない
* ストリームが EOF になっていない...

...EOF になっていれば、例外 EOFError を発生させます。

例えば、パイプに対しては次のように動作します。

r, w = IO.pipe # buffer pipe content
w << "abc" # "" "abc".
r.readpartial(4096)...

絞り込み条件を変える

IO#reopen(io) -> self (10.0)

2.4.0

インスタンスメソッド

自身を指定された io に繋ぎ換えます。

...た io に繋ぎ換えます。

クラスも io に等しくなることに注意してください。
IO#pos, IO#lineno などは指定された io と等しくなります。

@param io 自身を繋ぎ換えたい IO オブジェクトを指定します。

@raise IOError 指定された io が c...

IO#reopen(path) -> self (10.0)

2.4.0

インスタンスメソッド

path で指定されたファイルにストリームを繋ぎ換えます。

...ぎます。
IO#pos, IO#lineno などはリセットされます。

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

@param mode パスを開く際のモードを文字列で指定します。

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

//emlist[例][ruby]{
IO.write("test...

IO#reopen(path, mode) -> self (10.0)

2.4.0

インスタンスメソッド

path で指定されたファイルにストリームを繋ぎ換えます。

IO#rewind -> 0 (10.0)

2.4.0

インスタンスメソッド

ファイルポインタを先頭に移動します。IO#lineno は 0 になります。

...ファイルポインタを先頭に移動します。IO#lineno は 0 になります。

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

f = File.new("testfile")
f.readline #=> "This is line one\n"
f.rewind #=> 0
f.lineno...

IO#seek(offset, whence = IO::SEEK_SET) -> 0 (10.0)

2.4.0

インスタンスメソッド

ファイルポインタを whence の位置から offset だけ移動させます。 offset 位置への移動が成功すれば 0 を返します。

...* IO::SEEK_SET: ファイルの先頭から (デフォルト)
* IO::SEEK_CUR: 現在のファイルポインタから
* IO::SEEK_END: ファイルの末尾から
* IO::SEEK_DATA: offset 以降の次にデータがある位置へ(lseek の man ページ参照。Linux 3.1 以降のみ)
* IO::...

...no::EXXX ファイルポインタの移動に失敗した場合に発生します。

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

f = File.new("testfile")
f.seek(-13, IO::SEEK_END) #=> 0
f.readline #=> "And so on...\n"

@see IO#sysseek...

絞り込み条件を変える

IO#set_encoding(enc_str, **opts) -> self (10.0)

2.4.0

インスタンスメソッド

IO のエンコーディングを設定します。

...
IO のエンコーディングを設定します。

引数が "A:B" のようにコロンで区切られた文字列の場合は、
A を外部エンコーディング、 B を内部エンコーディングに指定します。

引数が一つで、上のような形式でない場合には、...

...oding オブジェクトを指定します。

@param int_enc 内部エンコーディングを表す文字列か Encoding オブジェクトを指定します。
@param opts エンコーディング変換のオプション
例:
io = File.open(file)
io.set_encoding("ASCII-8BIT", "EUC-JP")...

IO#set_encoding(ext_enc) -> self (10.0)

2.4.0

インスタンスメソッド

IO のエンコーディングを設定します。

IO#set_encoding(ext_enc, int_enc, **opts) -> self (10.0)

2.4.0

インスタンスメソッド

IO のエンコーディングを設定します。

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

2.4.0

インスタンスメソッド

ファイルのステータスを含む 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...

IO#sync -> bool (10.0)

2.4.0

インスタンスメソッド

現在の出力が同期モードならば true を返します。そうでない場合は false を返します。

...現在の出力が同期モードならば true を返します。そうでない場合は false を返します。

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

//emlist[例][ruby]{
File.open("testfile", "w") do |f|
f.sync # => false
f.sync = true
f.sync...

絞り込み条件を変える

IO#sync=(newstate) (10.0)

2.4.0

インスタンスメソッド

自身を同期モードに設定すると、出力関数の呼出毎にバッファがフラッシュされます。

...自身を同期モードに設定すると、出力関数の呼出毎にバッファがフラッシュされます。

@param newstate 自身を同期モードに設定するかを boolean で指定します。

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

@see IO#sync...

IO#sysread(maxlen, outbuf = "") -> String (10.0)

2.4.0

インスタンスメソッド

read(2) を用いて入力を行ない、入力されたデータを含む文字列を返します。stdio を経由しないので gets や getc や eof? などと混用すると思わぬ動作をすることがあります。

...read(2) を用いて入力を行ない、入力されたデータを
含む文字列を返します。stdio を経由しないので gets や getc や eof? などと混用すると思わぬ動作
をすることがあります。

バイナリ読み込みメソッドとして動作します。

既...

...します。

@param maxlen 入力のサイズを整数で指定します。

@param outbuf 出力用のバッファを文字列で指定します。IO#sysread は読み込んだデータを
その文字列オブジェクトに上書きして返します。指定した文字列オブ...

...小)されたあと、実際に読み込んだデータのサイズになります。

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

@raise EOFError IO が既に EOF に達していれば発生します。

@raise Errno::EXXX データの読み込...

IO#sysseek(offset, whence = IO::SEEK_SET) -> Integer (10.0)

2.4.0

インスタンスメソッド

lseek(2) と同じです。IO#seek では、 IO#sysread, IO#syswrite と併用すると正しく動作しないので代わりにこのメソッドを使います。位置 offset への移動が成功すれば移動した位置(ファイル先頭からのオフセット)を返します。

...lseek(2) と同じです。IO#seek では、
IO#sysread, IO#syswrite と併用すると正しく動作しないので代わりにこのメソッドを使います。
位置 offset への移動が成功すれば移動した位置(ファイル先頭からのオフセット)を返します。

書き...

...込み用にバッファリングされた IO に対して実行すると警告が出ます。

File.open("/dev/zero") {|f|
buf = f.read(3)
f.sysseek(0)
}
# => -:3:in `sysseek': sysseek for buffered IO (IOError)

File.open("/dev/null", "w") {|f|
f.print "foo"
f.sysseek(0)...

...ered IO

@param offset ファイルポインタを移動させるオフセットを整数で指定します。

@param whence 値は以下のいずれかです。
それぞれ代わりに :SET、:CUR、:END、:DATA、:HOLE を指定す
る事も可能です。

* IO::SE...

IO#syswrite(string) -> Integer (10.0)