クエリ:I > クエリ:file > バージョン:2.2.0

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")
p f.internal_encoding # => #<Encoding:EUC-JP>
end
//}

IRB::FileInputMethod#encoding -> Encoding (87601.0)

2.2.0

インスタンスメソッド

読み込んだファイルの文字エンコーディングを返します。

絞り込み条件を変える

IRB::MagicFile.ENCODING_SPEC_RE -> %r"coding\s*[=:]\s*([[:alnum:]\-_]+)" (87601.0)

2.2.0

特異メソッド

マジックコメントにマッチする正規表現を返します。

IO#to_i -> Integer (87304.0)

2.2.0

インスタンスメソッド

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

IRB::ExtendCommand::Require#execute(file_name) -> bool (78706.0)

2.2.0

インスタンスメソッド

ファイル file_name を現在の irb インタプリタ上で実行します。

ファイル file_name を現在の irb インタプリタ上で実行します。

file_name に Ruby スクリプトを指定した場合は、Kernel.#require と異
なり、file_name の内容を irb で一行ずつタイプしたかのように、irb 上で一
行ずつ評価されます。require に成功した場合は true を、そうでない場合は
false を返します。

拡張ライブラリ(*.so,*.o,*.dll など)を指定した場合は単純に require され
ます。

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

IO#readlines(limit) -> [String] (78655.0)

2.2.0

インスタンスメソッド

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

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

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

limit で最大読み込みバイト数を指定します。ただしマルチバイト文字が途中で
切れないように余分に読み込む場合があります。

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

@raise IOError ...

IO#readlines(rs = $/) -> [String] (78655.0)

2.2.0

インスタンスメソッド

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

絞り込み条件を変える

IO#readlines(rs, limit) -> [String] (78655.0)

2.2.0

インスタンスメソッド

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

IO#each_line(limit) {|line| ... } -> self (78637.0)

2.2.0

インスタンスメソッド

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

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

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

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

limit で最大読み込みバイト数を指定します。ただしマルチバイト文字が途中で
切れないように余分に読み込む場合があります。

@param rs 行の区切りを文字列で指定します。rs に nil を指定すると行区切りなしとみなします。
空文字列 "" を指定すると連続する改行を行の区切りとみなします(パラグラフモード)...

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

2.2.0

インスタンスメソッド

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

IO#each_line(rs, limit) {|line| ... } -> self (78637.0)

2.2.0

インスタンスメソッド

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

IO#readline(limit) -> String (78637.0)

2.2.0

インスタンスメソッド

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

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

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

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

limit で最大読み込みバイト数を指定します。ただしマルチバイト文字が途中で
切れないように余分に読み込む場合があります。

@param rs 行の区切りを文字列で指定します。rs に nil を指定すると行区切りなしとみなします。空文字列 "" を指定すると連続する改行を行の区切りとみなします(パラグラフモード...

絞り込み条件を変える

IO#readline(rs = $/) -> String (78637.0)

2.2.0

インスタンスメソッド

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

IO#readline(rs, limit) -> String (78637.0)

2.2.0

インスタンスメソッド

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

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

2.2.0

インスタンスメソッド

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

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

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

引数が一つで、上のような形式でない場合には、
それが外部エンコーディングと見なされます。

引数が2つの場合はそのそれぞれを外部エンコーディング、内部エンコーディング
に設定します。

キーワード引数で外部エンコーディングを内部エンコーディングに変換する際の
オプションを指定します。
詳しくは String#encode を参照してください。

@param enc_str エンコーディングを表す文字列を指定します...

IRB::MagicFile.open(path) -> File (78622.0)

2.2.0

特異メソッド

引数 path で指定したファイルを開いて、ファイル中のマジックコメントをエンコーディングに設定します。

引数 path で指定したファイルを開いて、ファイル中のマジックコメントをエ
ンコーディングに設定します。

ブロックを指定した場合はブロックの実行結果を返します。ブロックを指定し
なかった場合はエンコーディングが設定された File オブジェクトを返
します。

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

IO#external_encoding -> Encoding | nil (78619.0)

2.2.0

インスタンスメソッド

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

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

//emlist[例][ruby]{
IO.write("testfile", "abcde")
File.open("testfile") { |f| p f.external_encoding } # => #<Encoding:UTF-8>
//}

絞り込み条件を変える

IO#lineno -> Integer (78619.0)

2.2.0

インスタンスメソッド

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

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

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

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

IO.readlines(path, limit, opts={}) -> [String] (78619.0)

2.2.0

特異メソッド

path で指定されたファイルを全て読み込んで、その各行を要素としてもつ配列を返します。

path で指定されたファイルを全て読み込んで、その各行を要素としてもつ配列を返します。

Kernel.#open と同様 path の先頭が "|" ならば、"|" に続くコマンドの出力を読み取ります。

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

limit で最大読み込みバイト数を指定します。ただしマルチバイト文字が途中で
切れないように余分に読み込む場合があります。

opts でファイルを開くときのオプションを指定します。エンコーディングなど
を指定できます。
File.open と同様なのでそちらを参照してください。

@param path ファイル名を表す文字列か "|コ...

IO.readlines(path, rs = $/, opts={}) -> [String] (78619.0)

2.2.0

特異メソッド

path で指定されたファイルを全て読み込んで、その各行を要素としてもつ配列を返します。

IO.readlines(path, rs, limit, opts={}) -> [String] (78619.0)

2.2.0

特異メソッド

path で指定されたファイルを全て読み込んで、その各行を要素としてもつ配列を返します。

IRB::FileInputMethod.new(path) -> IRB::FileInputMethod (78601.0)

2.2.0

特異メソッド

自身を初期化します。

自身を初期化します。

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

絞り込み条件を変える

IO#each_codepoint -> Enumerator (78355.0)

2.2.0

インスタンスメソッド

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

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

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

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

//emlist[例][ruby]{
IO.write("testfile", "abcdeあ")
File.open("testfile") do |f|
f.each_codepoint { |i| p i }
end
# => 97
# 98
# 99
# 100
# 101
# 12354
//}

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

2.2.0

インスタンスメソッド

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

IO#each_line(limit) -> Enumerator (78337.0)

2.2.0

インスタンスメソッド

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

IO#each_line(rs = $/) -> Enumerator (78337.0)

2.2.0

インスタンスメソッド

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

IO#each_line(rs, limit) -> Enumerator (78337.0)

2.2.0

インスタンスメソッド

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

絞り込み条件を変える

IO#isatty -> bool (78337.0)

2.2.0

インスタンスメソッド

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

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

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

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

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

2.2.0

インスタンスメソッド

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

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

2.2.0

インスタンスメソッド

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

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

2.2.0

インスタンスメソッド

write(2) を用いて string を出力します。 string が文字列でなければ to_s による文字列化を試みます。実際に出力できたバイト数を返します。

write(2) を用いて string を出力します。
string が文字列でなければ to_s による文字列化を試みます。
実際に出力できたバイト数を返します。

stdio を経由しないので他の出力メソッドと混用すると思わぬ動作
をすることがあります。

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

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

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

//emlist[例][ruby]{
File.open("testfile", "w+") do |...

IO#write(str) -> Integer (78337.0)

2.2.0

インスタンスメソッド

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

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

IO#syswrite を除く全ての出力メソッドは、最終的に
"write" という名のメソッドを呼び出すので、このメソッドを置き換える
ことで出力関数の挙動を変更することができます。

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

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

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

//emlist[例][ruby]...

絞り込み条件を変える

IRB::MagicFile.open(path) { |io| ... } -> object (78322.0)

2.2.0

特異メソッド

引数 path で指定したファイルを開いて、ファイル中のマジックコメントをエンコーディングに設定します。

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

2.2.0

インスタンスメソッド

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

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

advice には以下のいずれかのシンボルを指定します。
* :normal - デフォルト
* :sequential - データは前から順にアクセスされる
* :random - データはランダムアクセスされる
* :willneed - データはこの直後にアクセスされる
* :dontneed - データは直後にはアクセスしない
* :noreuse - データは一度しかアクセスされない
これらの advice が具体的に何をするのかはプラットフォーム依存です。
...

IO#lineno=(number) (78319.0)

2.2.0

インスタンスメソッド

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

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

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

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

f = File.new("testfile")
f.gets #=> "This is line one\n"
$. #=> 1
f.lineno = 1000
f.lineno #=> 1000
$. ...

IO#rewind -> 0 (78319.0)

2.2.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 #=> 0
f.readline #=> "This is line one\n"

IRB::FileInputMethod#gets -> String (78301.0)

2.2.0

インスタンスメソッド

読み込んだファイルから文字列を 1 行読み込みます。

絞り込み条件を変える

IO (78127.0)

2.2.0

クラス

基本的な入出力機能のためのクラスです。

基本的な入出力機能のためのクラスです。

File::Constants は、File から IO へ移動しました。

===[a:m17n] 多言語化と IO のエンコーディング

IO オブジェクトはエンコーディングを持ちます。
エンコーディングの影響を受けるメソッドと受けないメソッドがあります。

影響を受けるメソッドでは、IO のエンコーディングに従い読み込まれた文字列のエンコーディングが決定されます。
また IO のエンコーディングを適切に設定することにより、読み込み時・書き込み時に文字列のエンコーディングを
変換させることもできます。

==== エンコーディングの影響を受けるメ...

Kernel#file(*args) { ... } -> Rake::FileTask (73222.0)

2.2.0

インスタンスメソッド

ファイルタスクを定義します。

ファイルタスクを定義します。

@param args ファイル名と依存ファイル名を指定します。

例:
file "config.cfg" => ["config.template"] do
open("config.cfg", "w") do |outfile|
open("config.template") do |infile|
while line = infile.gets
outfile.puts line
end
end
end
end

@see Rake:...

Psych::SyntaxError#file -> String|nil (72922.0)

2.2.0

インスタンスメソッド

エラーが生じたファイルの名前を返します。

エラーが生じたファイルの名前を返します。

Psych.load_file で指定したファイルの名前や
Psych.load の第2引数で指定した名前が返されます。
パース時にファイル名を指定しなかった場合は nil が返されます。

ARGF.class#file -> IO (72724.0)

2.2.0

インスタンスメソッド

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

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

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

$ ruby argf.rb foo bar

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

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

Digest::Base#file(path) -> self (72706.0)

2.2.0

インスタンスメソッド

ファイル名 file で指定したファイルの内容を読み込んでダイジェストを更新し、オブジェクト自身を返します。

ファイル名 file で指定したファイルの内容を読み込んでダイジェストを更新し、
オブジェクト自身を返します。

@param path 読み込み対象のファイル名です。
@return ダイジェストオブジェクトを返します。

例(MD5の場合)

require 'digest/md5'
digest = Digest::MD5.new
digest.file("/path/to/file") # => Digest::MD5のインスタンス
digest.hexdigest # => "/path/to/file"のMD5値

絞り込み条件を変える

Digest::Base.file(path) -> object (72670.0)

2.2.0

特異メソッド

新しいダイジェストオブジェクトを生成し、ファイル名 file で指定したファイルの内容を読み込み、そのダイジェストオブジェクトを返します。

新しいダイジェストオブジェクトを生成し、
ファイル名 file で指定したファイルの内容を読み込み、
そのダイジェストオブジェクトを返します。

@param path 読み込み対象のファイル名です。
@return ダイジェストオブジェクトを返します。

使用例(SHA256の場合)

require 'digest'
digest = Digest::SHA256.file("X11R6.8.2-src.tar.bz2")
digest.hexdigest
# => "f02e3c85572dc9ad7cb77c2a638e...

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

2.2.0

特異メソッド

FileTest.#file? と同じです。

FileTest.#file? と同じです。

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

IRB::ExtendCommand::Load#execute(file_name, priv = nil) -> nil (70222.0)

2.2.0

インスタンスメソッド

ファイル path を Ruby スクリプトとみなし、現在の irb インタプリタ上で実行します。

ファイル path を Ruby スクリプトとみなし、現在の irb インタプリタ上で実
行します。

Kernel.#load と異なり、path の内容を irb で一行ずつタイプしたかの
ように、irb 上で一行ずつ評価されます。

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

@param priv 真を指定した場合は実行は内部的に生成される無名モジュール上
で行われ、グローバルな名前空間を汚染しません。

@raise LoadError 読み込みに失敗した場合に発生します。

IRB::InputMethod.new(file = STDIN_FILE_NAME) -> IRB::InputMethod (70207.0)

2.2.0

特異メソッド

自身を初期化します。

IO.console -> File | nil (69970.0)

2.2.0

特異メソッド

端末を File オブジェクトで返します。

端末を File オブジェクトで返します。

require "io/console"
IO.console # => #<File:/dev/tty>

プロセスが端末から切り離された状態で実行すると nil を返します。

戻り値はプラットフォームや環境に依存します。

絞り込み条件を変える

IRB::ExtendCommand::Source#execute(file_name) -> nil (69922.0)

2.2.0

インスタンスメソッド

現在の irb インタプリタ上で、 Ruby スクリプト path を評価します。

現在の irb インタプリタ上で、 Ruby スクリプト path を評価します。

path の内容を irb で一行ずつタイプしたかのように、irb 上で一行ずつ評価
されます。$" は更新されず、何度でも実行し直す事ができます。

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

IRB::ExtendCommandBundle.def_extend_command(cmd_name, cmd_class, load_file = nil, *aliases) -> object (69922.0)

2.2.0

特異メソッド

irb に cmd_name で指定したメソッドが実行できるように拡張します。

irb に cmd_name で指定したメソッドが実行できるように拡張します。

@param cmd_name メソッド名を Symbol か文字列で指定します。
cmd_class で指定するクラスの execute メソッドとして定
義してある必要があります。

@param cmd_class 指定した拡張が定義されたクラス名を Symbol、
String、Class のいずれかで指定します。
なお、このクラスは IRB::ExtendCommand ...

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

2.2.0

インスタンスメソッド

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

IO.read(path, length = nil, **opt) -> String | nil (69691.0)

2.2.0

特異メソッド

path で指定されたファイルを offset 位置から length バイト分読み込んで返します。

path で指定されたファイルを offset 位置から
length バイト分読み込んで返します。

既に EOF に達している場合は nil を返します。ただし、length に nil か 0 が指定されている場合は、空文字列 "" を返します。例えば、IO.read(空ファイル) は "" を返します。

引数 length が指定された場合はバイナリ読み込みメソッド、そうでない場合はテキスト読み込みメソッドとして
動作します。

Kernel.#open と同様 path の先頭が "|" ならば、"|" に続くコマンドの出力を読み取ります。

@param path ファイル名を...

IO.read(path, length = nil, offset = 0, **opt) -> String | nil (69691.0)

2.2.0

特異メソッド

path で指定されたファイルを offset 位置から length バイト分読み込んで返します。

絞り込み条件を変える

IRB::ContextExtender.def_extend_command(cmd_name, load_file, *aliases) -> object (69622.0)

2.2.0

特異メソッド

IRB::Context に cmd_name で指定したメソッドが実行できるように拡張します。

IRB::Context に cmd_name で指定したメソッドが実行できるように拡張
します。

@param cmd_name メソッド名を Symbol で指定します。
IRB::Context クラスのインスタンスメソッドとして定
義してある必要があります。

@param load_file cmd_name で指定したメソッドが定義されたファイル名を指
定します。このファイルは自動的に require されます。

@param aliases cmd_name の別名を Symb...

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

2.2.0

インスタンスメソッド

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

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

引数 length が指定された場合はバイナリ読み込みメソッド、そうでない場合はテキスト読み込みメソッドとして
動作します。
既に EOF に達していれば nil を返します。
ただし、length に nil か 0 が指定されている場合は、空文字列 "" を返します。
例えば、open(空ファイル) {|f| f.read } は "" となります。

@param length 読み込むサイズを整数で指定します。
nil が指定された場合、EOF までの全てのデータを読み込んで、その文字列を返します。...

IRB::Frame#trace_func(event, file, line, id, binding) -> Binding (69604.0)

2.2.0

インスタンスメソッド

ライブラリ内部で使用します。

IO.read(path, **opt) -> String | nil (69391.0)

2.2.0

特異メソッド

path で指定されたファイルを offset 位置から length バイト分読み込んで返します。

IO#each(limit) -> Enumerator (69337.0)

2.2.0

インスタンスメソッド

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

絞り込み条件を変える

IO#each(limit) {|line| ... } -> self (69337.0)

2.2.0

インスタンスメソッド

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

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

2.2.0

インスタンスメソッド

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

IO#each(rs, limit) -> Enumerator (69337.0)

2.2.0

インスタンスメソッド

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

IO#each(rs, limit) {|line| ... } -> self (69337.0)

2.2.0

インスタンスメソッド

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

IO#getc -> String | nil (69337.0)

2.2.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 #=> "ろ...

絞り込み条件を変える

IO#gets(limit) -> String | nil (69337.0)

2.2.0

インスタンスメソッド

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

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

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

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

limit で最大の読み込みバイト数を指定します。ただし
ファイルのエンコーディングがマルチバイトエンコーディングである場合には
読み込んだ文字列がマルチバイト文字の途中で切れないように
数バイト余分に読み込む場合があります。

@param rs 行の区切りを文字列で指定します。rs に nil を指定すると行区切り...

IO#gets(rs = $/) -> String | nil (69337.0)

2.2.0

インスタンスメソッド

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

IO#gets(rs, limit) -> String | nil (69337.0)

2.2.0

インスタンスメソッド

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

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

2.2.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 (IOErro...

IO#ungetbyte(c) -> nil (69337.0)

2.2.0

インスタンスメソッド

指定したバイト列を書き戻します。

指定したバイト列を書き戻します。

2バイト以上の書き戻しは仕様として保証しません。

このメソッドはバッファを経由しない読み出し(IO#sysread など)
には影響しません。

@param c バイト列(文字列)、もしくは0から255までの整数

例:

f = File.new("testfile") #=> #<File:testfile>
b = f.getbyte #=> 0x38
f.ungetbyte(b) #=> nil
f.getbyte #=> 0x38
...

絞り込み条件を変える

IO#ungetc(char) -> nil (69337.0)

2.2.0

インスタンスメソッド

指定された char を読み戻します。

指定された char を読み戻します。

@param char 読み戻したい1文字かそのコードポイントを指定します。

@raise IOError 読み戻しに失敗した場合に発生します。また、自身が読み込み用にオープンされていない時、
自身がまだ一度も read されていない時に発生します。

f = File.new("testfile") # => #<File:testfile>
c = f.getc # => "い"
f.ungetc(c) # => nil
f.getc...

IO#clone -> IO (69319.0)

2.2.0

インスタンスメソッド

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

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

clone の際に self は一旦 IO#flush されます。
フリーズした IO の clone は同様にフリーズされた IO を返しますが、
dup は内容の等しいフリーズされていない IO を返します。

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

//emlist[例][ruby]{
clone_io = nil
IO.write("testfile", "test")
File.open("testfile") ...

IO#close -> nil (69319.0)

2.2.0

インスタンスメソッド

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

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

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

@raise Errno::EXXX close に失敗した場合に発生します。
@raise IOError 既に close されていた場合に発生します。

//emlist[例][ruby]{
IO.write("testfile", "test")
f = File.open("testfile")
f.r...

IO#dup -> IO (69319.0)

2.2.0

インスタンスメソッド

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

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

2.2.0

インスタンスメソッド

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

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

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

@param arg cmd に対する引数を整数、文字列、booleanのいずれかで指定します。
整数の時にはその値を fcntl(2) に渡します。
文字列の場合には Array#pack した構造体だとみなして渡します。
arg が nil か false の...

絞り込み条件を変える

IO#getbyte -> Integer | nil (69319.0)

2.2.0

インスタンスメソッド

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

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

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

IO#pos -> Integer (69319.0)

2.2.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 # => 17
end
//}

IO#readbyte -> Integer (69319.0)

2.2.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.readbyte # => 49
f.readbyte # => 50
f.readbyte # => 51
f.readbyte # => 例外発生
rescue => e
e...

IO#readchar -> String (69319.0)

2.2.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 #=> "ろ"...

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

2.2.0

インスタンスメソッド

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

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

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

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

* IO::SEEK_SET: ファイルの先頭から (デフォルト)
* IO::SEEK_CUR: 現在のファイルポインタから
* IO::SE...

絞り込み条件を変える

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

2.2.0

インスタンスメソッド

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

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

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

既に EOF に達していれば EOFError が発生します。ただし、maxlen に 0 が指定されている場合は、空文字列 "" を返します。

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

@param outbuf 出力用のバッファを文字列で指定します。IO#sysread は読み込んだデータを
...

IO#tell -> Integer (69319.0)

2.2.0

インスタンスメソッド

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

IO.for_fd(fd, mode = "r", **opts) -> IO (69319.0)

2.2.0

特異メソッド

オープン済みのファイルディスクリプタ fd に対する新しい IO オブジェクトを生成して返します。

オープン済みのファイルディスクリプタ fd に対する新しい
IO オブジェクトを生成して返します。

IO.open にブロックが与えられた場合、IO オブジェクトを生成しそれを引数としてブロックを
実行します。ブロックの終了とともに fd はクローズされます。ブロックの結果を返します。
IO.new, IO.for_fd はブロックを受け付けません。

=== キーワード引数
このメソッドは以下のキーワード引数を利用できます。
* :mode mode引数と同じ意味です
* :external_encoding 外部エンコーディング。"-" はデフォルト外部エンコーディングの
...

IO.new(fd, mode = "r", **opts) -> IO (69319.0)

2.2.0

特異メソッド

オープン済みのファイルディスクリプタ fd に対する新しい IO オブジェクトを生成して返します。

IO.open(fd, mode = "r", **opts) -> IO (69319.0)

2.2.0

特異メソッド

オープン済みのファイルディスクリプタ fd に対する新しい IO オブジェクトを生成して返します。

絞り込み条件を変える

IO.open(fd, mode = "r", **opts) {|io| ... } -> object (69319.0)

2.2.0

特異メソッド

オープン済みのファイルディスクリプタ fd に対する新しい IO オブジェクトを生成して返します。

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

2.2.0

インスタンスメソッド

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

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

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

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

@raise IOError 指定された io が close されている場合に発生します。

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

2.2.0

インスタンスメソッド

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

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

第二引数を省略したとき self のモードをそのまま引き継ぎます。
IO#pos, IO#lineno などはリセットされます。

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

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

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

//emlist[例][ruby]{
IO.write("testfile", "This is line one\nThis is line two\n")
f1 = File.new("testfile"...

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