バージョン:2.6.0 > 種類:インスタンスメソッド > クエリ:| > クラス:IO

78件ヒット [1-78件を表示] （0.122秒）

トップページ >

:2.6.0

:インスタンスメソッド

> クラス:IO

別のキーワード

ライブラリ

ビルトイン (65)
etc (1)
expect (2)
io/console (3)
io/wait (5)
scanf (2)

キーワード

advise (1)
autoclose? (1)
binmode (1)
bytes (2)
chars (2)
clone (1)
close_read (1)
close_write (1)
codepoints (2)
cooked (1)
dup (1)
each (6)
each_byte (2)
each_char (2)
each_codepoint (2)
each_line (6)
expect (2)
external_encoding (1)
fcntl (1)
fdatasync (1)
flush (1)
getbyte (1)
getc (1)
gets (3)
internal_encoding (1)
lines (6)
noecho (1)
pathconf (1)
pid (1)
pos (1)
pos= (1)
pread (1)
pwrite (1)
raw (1)
read (1)
read_nonblock (1)
readbyte (1)
readlines (3)
ready? (1)
scanf (2)
stat (1)
sync (1)
sysseek (1)
syswrite (1)
tell (1)
wait (1)
wait_readable (1)
wait_writable (2)
write (1)
write_nonblock (1)

検索結果

IO#wait(timeout = nil) -> bool | self | nil (619.0)

2.6.0

インスタンスメソッド

self が読み込み可能になるまでブロックし、読み込み可能になったら真値を返します。タイムアウト、もしくはEOFでそれ以上読みこめない場合は偽の値を返します。

...timeout を指定した場合は、指定秒数経過するまでブロックし、タ
イムアウトした場合は nil を返します。

self が EOF に達していれば false を返します。

@param timeout タイムアウトまでの秒数を指定します。

@see IO#wait_writable...

IO#wait_readable(timeout = nil) -> bool | self | nil (619.0)

2.6.0

インスタンスメソッド

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

2.6.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#each(limit, chomp: false) {|line| ... } -> self (433.0)

2.6.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(rs = $/, chomp: false) {|line| ... } -> self (433.0)

2.6.0

インスタンスメソッド

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

絞り込み条件を変える

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

2.6.0

インスタンスメソッド

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

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

2.6.0

インスタンスメソッド

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

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

2.6.0

インスタンスメソッド

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

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

2.6.0

インスタンスメソッド

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

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

2.6.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_codepoint {|c| ... } -> self (382.0)

2.6.0

インスタンスメソッド

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

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

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

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

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

IO#external_encoding -> Encoding | nil (346.0)

2.6.0

インスタンスメソッド

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

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

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

IO#internal_encoding -> Encoding | nil (346.0)

2.6.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#pid -> Integer | nil (346.0)

2.6.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#each_char {|c| ... } -> self (328.0)

2.6.0

インスタンスメソッド

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

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

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

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

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

絞り込み条件を変える

IO#pathconf(name) -> Integer | nil (328.0)

2.6.0

インスタンスメソッド

fpathconf(3) で取得したファイルの設定変数の値を返します。

...場合は nil
を返します。(fpathconf(3) が -1 を返し、errno が設定されていない
場合)

@param name Etc モジュールの PC_ で始まる定数のいずれかを指定します。

//emlist[][ruby]{
require 'etc'
IO.pipe {|r, w|
p w.pathconf(Etc::PC_PIPE_BUF) # => 4096
}
//}...

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

2.6.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#gets(limit, chomp: false) -> String | nil (316.0)

2.6.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 (316.0)

2.6.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 (316.0)

2.6.0

インスタンスメソッド

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

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

@see $/, IO#readline...

絞り込み条件を変える

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

2.6.0

インスタンスメソッド

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

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

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

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

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

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

@see $/, IO#each_line...

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

2.6.0

インスタンスメソッド

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

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

2.6.0

インスタンスメソッド

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

IO#expect(pattern, timeout = 9999999) -> Array | nil (313.0)

2.6.0

インスタンスメソッド

レシーバから指定したパターンを読み込むまで待ちます。

...定したパターンを読み込むまで待ちます。

このメソッドがブロックなしで呼ばれた場合、まずレシーバである
IO オブジェクトから pattern にマッチするパターンが読みこまれる
まで待ちます。

このメソッドをブロック付き...

IO#expect(pattern, timeout = 9999999) {|array| ... } -> nil (313.0)

2.6.0

インスタンスメソッド

レシーバから指定したパターンを読み込むまで待ちます。

絞り込み条件を変える

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

2.6.0

インスタンスメソッド

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

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

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

ブロック...

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

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

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

@see IO#each_byte...

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

2.6.0

インスタンスメソッド

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

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

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

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

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

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

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

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

@see IO#each_char...

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

2.6.0

インスタンスメソッド

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

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

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

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

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

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

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

@see IO#each_codepoint...

IO#cooked {|io| ... } -> object (310.0)

2.6.0

インスタンスメソッド

cooked モードを有効にして指定されたブロックを評価します。

...す。ブロックを評価した結果を返します。

@raise LocalJumpError ブロックを指定しなかった場合に発生します。

以下の例では、標準入力からエコーバック付きで文字列を一行読み込みます。

require "io/console"
STDIN.cooked(&:gets)...

IO#getbyte -> Integer | nil (310.0)

2.6.0

インスタンスメソッド

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

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

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

絞り込み条件を変える

IO#getc -> String | nil (310.0)

2.6.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#noecho {|io| ... } -> object (310.0)

2.6.0

インスタンスメソッド

文字入力時のエコーバックを無効に設定してブロックを評価します。

...す。ブロックを評価した結果を返します。

以下の例では、標準入力からエコーバックなしで文字列を一行読み込みます。

require "io/console"
STDIN.noecho(&:gets)

@raise LocalJumpError ブロックを指定しなかった場合に発生します。...

IO#raw(min: 1, time: 0, intr: false) {|io| ... } -> object (310.0)

2.6.0

インスタンスメソッド

raw モード、行編集を無効にして指定されたブロックを評価します。

...シグナルを生成する制御文字が有効になります。端末の制御については、 termios のマニュアル：https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/termios.h.html を参照してください。

@raise LocalJumpError ブロックを指定しなかった場合...

...に発生します。

@raise ArgumentError intr に true または false 以外の値を指定した場合に発生します。

以下の例では、標準入力からエコーバックなしで文字列を一行読み込みます。

require "io/console"
STDIN.raw(&:gets)...

IO#ready? -> bool | nil (310.0)

2.6.0

インスタンスメソッド

ブロックせずに読み込み可能ならtrueを、ブロックしてしまう可能性があるならfalseを返します。

ブロックせずに読み込み可能ならtrueを、
ブロックしてしまう可能性があるならfalseを返します。

判定不可能な場合は nil を返します。

IO#scanf(format) {|*ary| ...} -> Array (310.0)

2.6.0

インスタンスメソッド

String#scanfも参照してください。

String#scanfも参照してください。

@param format スキャンするフォーマットを文字列で指定します。
詳細は、m:String#scanf#format を参照してください。

絞り込み条件を変える

IO#wait_writable(timeout) -> self | nil (310.0)

2.6.0

インスタンスメソッド

self が書き込み可能になるまでブロックし、書き込み可能になったら self を返します。

...、書き込み可能になったら self を
返します。

timeout を指定した場合は、指定秒数経過するまでブロックし、タイムアウト
した場合は nil を返します。

@param timeout タイムアウトまでの秒数を指定します。

@see IO#wait_readable...

IO#write_nonblock(string, exception: true) -> Integer | :wait_writable (310.0)

2.6.0

インスタンスメソッド

IO をノンブロッキングモードに設定し、string を write(2) システムコールで書き出します。

...
IO をノンブロッキングモードに設定し、string を write(2) システムコールで書き出します。

write(2) が成功した場合、書き込んだ長さを返します。
EAGAIN, EINTR などは例外 Errno::EXXX として呼出元に報告されます。

書き込んだバ...

...ブジェクトに IO::WaitWritable が Object#extend
されます。よって IO::WaitWritable を write_nonblock のリトライが必要
かの判定に用いることができます。

@param string 自身に書き込みたい文字列を指定します。

@param exception false を指定す...

...と、書き込み時に Errno::EAGAIN、Errno::EWOULDBLOCK が発生
する代わりに :wait_writable を返します。

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

@raise Errno::EXXX write(2) が失敗した場合に発生し...

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

2.6.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] (187.0)

2.6.0

インスタンスメソッド

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

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

2.6.0

インスタンスメソッド

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

絞り込み条件を変える

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

2.6.0

インスタンスメソッド

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

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

2.6.0

インスタンスメソッド

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

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

2.6.0

インスタンスメソッド

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

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

2.6.0

インスタンスメソッド

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

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

2.6.0

インスタンスメソッド

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

絞り込み条件を変える

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

2.6.0

インスタンスメソッド

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

IO#each_byte -> Enumerator (82.0)

2.6.0

インスタンスメソッド

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

IO#each_codepoint -> Enumerator (82.0)

2.6.0

インスタンスメソッド

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

IO#write(*str) -> Integer (79.0)

2.6.0

インスタンスメソッド

IOポートに対して str を出力します。str が文字列でなければ to_s による文字列化を試みます。実際に出力できたバイト数を返します。

...
IOポートに対して str を出力します。str が文字列でなけ
れば to_s による文字列化を試みます。
実際に出力できたバイト数を返します。

IO#syswrite を除く全ての出力メソッドは、最終的に
"write" という名のメソッドを呼び出...

...ことで出力関数の挙動を変更することができます。

@param str 自身に書き込みたい文字列を指定します。

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

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

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

2.6.0

インスタンスメソッド

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

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

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

絞り込み条件を変える

IO#autoclose? -> bool (43.0)

2.6.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 (43.0)

2.6.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#clone -> IO (43.0)

2.6.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_read -> nil (43.0)

2.6.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 (43.0)

2.6.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#dup -> IO (43.0)

2.6.0

インスタンスメソッド

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

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

2.6.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 (43.0)

2.6.0

インスタンスメソッド

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

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

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

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

@raise NotImplemented...

IO#flush -> self (43.0)

2.6.0

インスタンスメソッド

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

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

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

@raise IOError 自身...

IO#pos -> Integer (43.0)

2.6.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) (43.0)

2.6.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#pread(maxlen, offset, outbuf = "") -> string (43.0)

2.6.0

インスタンスメソッド

preadシステムコールを使ってファイルポインタを変更せずに、また現在のファイルポインタに依存せずにmaxlenバイト読み込みます。

...みます。

IO#seekとIO#readの組み合わせと比べて、アトミックな操作に
なるという点が優れていて、複数スレッド/プロセスから同じIOオブジェクトを
様々な位置から読み込むことを許します。
どのユーザー空間のIO層のバッフ...

IO#pwrite(string, offset) -> Integer (43.0)

2.6.0

インスタンスメソッド

stringをoffsetの位置にpwrite()システムコールを使って書き込みます。

...みます。

IO#seekとIO#writeの組み合わせと比べて、アトミックな操作に
なるという点が優れていて、複数スレッド/プロセスから同じIOオブジェクトを
様々な位置から読み込むことを許します。
どのユーザー空間のIO層のバッ...

IO#readbyte -> Integer (43.0)

2.6.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#stat -> File::Stat (43.0)

2.6.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 (43.0)

2.6.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#sysseek(offset, whence = IO::SEEK_SET) -> Integer (43.0)

2.6.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 (43.0)