検索結果

ARGF.class#argv -> Array (24010.0)

• 3.3

• インスタンスメソッド

Object::ARGV を返します。

Object::ARGV を返します。

ARGF が ARGV をどう扱うかについては ARGF を参照してください。

例:

$ ruby argf.rb -v glark.txt

ARGF.argv #=> ["-v", "glark.txt"]

• ARGF
• ARGF.class

ARGF.class#binmode -> self (24010.0)

• 3.3

• インスタンスメソッド

self をバイナリモードにします。一度バイナリモードになった後は非バイナリ モードに戻る事はできません。

self をバイナリモードにします。一度バイナリモードになった後は非バイナリ
モードに戻る事はできません。

バイナリモード下では以下のように動作します。

* 改行の変換を停止する
* 文字エンコーディングの変換を停止する
* 内容を ASCII-8BIT として扱う

例:
# test1.png - 164B
# test2.png - 128B
# test1.png + test2.png = 292B

# $ ruby test.rb test1.png test2.png

ARGF.binmode
ARGF.read.size # => 29...

• ARGF.class

ARGF.class#binmode? -> bool (24010.0)

• 3.3

• インスタンスメソッド

ARGF の入力ストリームがバイナリモードなら true を返します。 そうでない場合、false を返します。

ARGF の入力ストリームがバイナリモードなら true を返します。
そうでない場合、false を返します。

バイナリモードにするためには ARGF.class#binmode を使用します。

ARGF.binmode? # => false
ARGF.binmode
ARGF.binmode? # => true

@see IO#binmode?, ARGF.class#binmode

• ARGF.class

ARGF.class#close -> self (24010.0)

• 3.3

• インスタンスメソッド

現在開いている処理対象のファイルをクローズします。開くファイルが残って いる場合は次のファイルをオープンします。 ただし、標準入力はクローズされません。

現在開いている処理対象のファイルをクローズします。開くファイルが残って
いる場合は次のファイルをオープンします。
ただし、標準入力はクローズされません。

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

$ ruby argf.rb foo bar

ARGF.filename # => "foo"
ARGF.close
ARGF.filename # => "bar"
ARGF.close

@see ARGF.class#closed?

• ARGF.class

ARGF.class#closed? -> bool (24010.0)

• 3.3

• インスタンスメソッド

現在開いている処理対象のファイルがARGFがcloseされていればtrueを返します。

現在開いている処理対象のファイルがARGFがcloseされていればtrueを返します。

例:
# $ echo "foo" > foo
# $ echo "bar" > bar
# $ ruby argf.rb foo bar

ARGF.filename # => "foo"
ARGF.close
# 複数のファイルを開いているので1度のARGF.closeではまた全てのファイルを閉じていないのでfalseになる
ARGF.closed? # => false
ARGF.filename # => "bar"
ARGF.close
# 2つ...

• ARGF.class

絞り込み条件を変える

ARGF.class#each(rs = $/) -> Enumerator (24010.0)

• 3.3

• インスタンスメソッド

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

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

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

このメソッドはスクリプトに指定した引数(Object::ARGV を参照) をファ
イル名とみなして、それらのファイルを連結した 1 つの仮想ファイルを表すオ
ブジェクトです。そのため、最初のファイルを最後まで読んだ後は次のファイ
ルの内容を返します。現在の行についてファイル名や行数を得るには
ARGF.class#filename と ARGF.class#lineno を使用します。

...

• ARGF.class
• Enumerator

ARGF.class#each(rs = $/) { |line| ... } -> self (24010.0)

• 3.3

• インスタンスメソッド

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

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

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

このメソッドはスクリプトに指定した引数(Object::ARGV を参照) をファ
イル名とみなして、それらのファイルを連結した 1 つの仮想ファイルを表すオ
ブジェクトです。そのため、最初のファイルを最後まで読んだ後は次のファイ
ルの内容を返します。現在の行についてファイル名や行数を得るには
ARGF.class#filename と ARGF.class#lineno を使用します。

...

• ARGF.class
• Enumerator

ARGF.class#each(rs = $/, limit) -> Enumerator (24010.0)

• 3.3

• インスタンスメソッド

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

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

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

このメソッドはスクリプトに指定した引数(Object::ARGV を参照) をファ
イル名とみなして、それらのファイルを連結した 1 つの仮想ファイルを表すオ
ブジェクトです。そのため、最初のファイルを最後まで読んだ後は次のファイ
ルの内容を返します。現在の行についてファイル名や行数を得るには
ARGF.class#filename と ARGF.class#lineno を使用します。

...

• ARGF.class
• Enumerator

ARGF.class#each(rs = $/, limit) { |line| ... } -> self (24010.0)

• 3.3

• インスタンスメソッド

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

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

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

このメソッドはスクリプトに指定した引数(Object::ARGV を参照) をファ
イル名とみなして、それらのファイルを連結した 1 つの仮想ファイルを表すオ
ブジェクトです。そのため、最初のファイルを最後まで読んだ後は次のファイ
ルの内容を返します。現在の行についてファイル名や行数を得るには
ARGF.class#filename と ARGF.class#lineno を使用します。

...

• ARGF.class
• Enumerator

ARGF.class#each_byte -> Enumerator (24010.0)

• 3.3

• インスタンスメソッド

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

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

このメソッドはスクリプトに指定した引数(Object::ARGV を参照) をファ
イル名とみなして、それらのファイルを連結した 1 つの仮想ファイルを表すオ
ブジェクトです。そのため、最初のファイルを最後まで読んだ後は次のファイ
ルの内容を返します。現在位置の1バイトについてファイル名を得るには
ARGF.class#filename を使用します。

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

• ARGF.class
• Enumerator

絞り込み条件を変える

ARGF.class#each_byte { |byte| ...} -> self (24010.0)

• 3.3

• インスタンスメソッド

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

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

このメソッドはスクリプトに指定した引数(Object::ARGV を参照) をファ
イル名とみなして、それらのファイルを連結した 1 つの仮想ファイルを表すオ
ブジェクトです。そのため、最初のファイルを最後まで読んだ後は次のファイ
ルの内容を返します。現在位置の1バイトについてファイル名を得るには
ARGF.class#filename を使用します。

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

• ARGF.class
• Enumerator

ARGF.class#each_char -> Enumerator (24010.0)

• 3.3

• インスタンスメソッド

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

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

このメソッドはスクリプトに指定した引数(Object::ARGV を参照) をファ
イル名とみなして、それらのファイルを連結した 1 つの仮想ファイルを表すオ
ブジェクトです。そのため、最初のファイルを最後まで読んだ後は次のファイ
ルの内容を返します。現在位置の1文字についてファイル名を得るには
ARGF.class#filename を使用します。

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

例:
# $ echo "line1\n" > test1.txt
# $...

• ARGF.class
• Enumerator

ARGF.class#each_char { |c| ... } -> self (24010.0)

• 3.3

• インスタンスメソッド

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

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

このメソッドはスクリプトに指定した引数(Object::ARGV を参照) をファ
イル名とみなして、それらのファイルを連結した 1 つの仮想ファイルを表すオ
ブジェクトです。そのため、最初のファイルを最後まで読んだ後は次のファイ
ルの内容を返します。現在位置の1文字についてファイル名を得るには
ARGF.class#filename を使用します。

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

例:
# $ echo "line1\n" > test1.txt
# $...

• ARGF.class
• Enumerator

ARGF.class#each_codepoint -> Enumerator (24010.0)

• 3.3

• インスタンスメソッド

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

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

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

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

例:
# $ echo "line1\n" > test1.txt
# $ echo "line2\n" > test2.txt
# $ ruby test.rb test1.txt test2.txt

# test.rb
ARGF.each_codepoint # => #<Enumerator: ARGF:each_codepoint>
...

• ARGF.class
• Enumerator

ARGF.class#each_codepoint { |c| ... } -> self (24010.0)

• 3.3

• インスタンスメソッド

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

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

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

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

例:
# $ echo "line1\n" > test1.txt
# $ echo "line2\n" > test2.txt
# $ ruby test.rb test1.txt test2.txt

# test.rb
ARGF.each_codepoint # => #<Enumerator: ARGF:each_codepoint>
...

• ARGF.class
• Enumerator

絞り込み条件を変える

ARGF.class#each_line(rs = $/) -> Enumerator (24010.0)

• 3.3

• インスタンスメソッド

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

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

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

このメソッドはスクリプトに指定した引数(Object::ARGV を参照) をファ
イル名とみなして、それらのファイルを連結した 1 つの仮想ファイルを表すオ
ブジェクトです。そのため、最初のファイルを最後まで読んだ後は次のファイ
ルの内容を返します。現在の行についてファイル名や行数を得るには
ARGF.class#filename と ARGF.class#lineno を使用します。

...

• ARGF.class
• Enumerator

ARGF.class#each_line(rs = $/) { |line| ... } -> self (24010.0)

• 3.3

• インスタンスメソッド

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

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

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

このメソッドはスクリプトに指定した引数(Object::ARGV を参照) をファ
イル名とみなして、それらのファイルを連結した 1 つの仮想ファイルを表すオ
ブジェクトです。そのため、最初のファイルを最後まで読んだ後は次のファイ
ルの内容を返します。現在の行についてファイル名や行数を得るには
ARGF.class#filename と ARGF.class#lineno を使用します。

...

• ARGF.class
• Enumerator

ARGF.class#each_line(rs = $/, limit) -> Enumerator (24010.0)

• 3.3

• インスタンスメソッド

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

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

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

このメソッドはスクリプトに指定した引数(Object::ARGV を参照) をファ
イル名とみなして、それらのファイルを連結した 1 つの仮想ファイルを表すオ
ブジェクトです。そのため、最初のファイルを最後まで読んだ後は次のファイ
ルの内容を返します。現在の行についてファイル名や行数を得るには
ARGF.class#filename と ARGF.class#lineno を使用します。

...

• ARGF.class
• Enumerator

ARGF.class#each_line(rs = $/, limit) { |line| ... } -> self (24010.0)

• 3.3

• インスタンスメソッド

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

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

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

このメソッドはスクリプトに指定した引数(Object::ARGV を参照) をファ
イル名とみなして、それらのファイルを連結した 1 つの仮想ファイルを表すオ
ブジェクトです。そのため、最初のファイルを最後まで読んだ後は次のファイ
ルの内容を返します。現在の行についてファイル名や行数を得るには
ARGF.class#filename と ARGF.class#lineno を使用します。

...

• ARGF.class
• Enumerator

ARGF.class#eof -> bool (24010.0)

• 3.3

• インスタンスメソッド

現在開いているファイルがEOFに達したらtrueを返します。そうでない場合は falseを返します。

現在開いているファイルがEOFに達したらtrueを返します。そうでない場合は
falseを返します。

@raise IOError ファイルがopenされていない場合に発生します。

$ echo "eof" | ruby argf.rb

ARGF.eof? # => false
3.times { ARGF.readchar }
ARGF.eof? # => false
ARGF.readchar # => "\n"
ARGF.eof? # =...

• ARGF.class

絞り込み条件を変える

ARGF.class#eof? -> bool (24010.0)

• 3.3

• インスタンスメソッド

現在開いているファイルがEOFに達したらtrueを返します。そうでない場合は falseを返します。

現在開いているファイルがEOFに達したらtrueを返します。そうでない場合は
falseを返します。

@raise IOError ファイルがopenされていない場合に発生します。

$ echo "eof" | ruby argf.rb

ARGF.eof? # => false
3.times { ARGF.readchar }
ARGF.eof? # => false
ARGF.readchar # => "\n"
ARGF.eof? # =...

• ARGF.class

ARGF.class#external_encoding -> Encoding (24010.0)

• 3.3

• インスタンスメソッド

ARGF が処理するファイルに対する外部エンコーディングを返します。 デフォルトは Encoding.default_external です。

ARGF が処理するファイルに対する外部エンコーディングを返します。
デフォルトは Encoding.default_external です。

ARGF.class#set_encoding で設定します。

例:

ARGF.external_encoding # => #<Encoding:UTF-8>

@see IO, ARGF.class#internal_encoding

• ARGF.class
• IO

ARGF.class#file -> IO (24010.0)

• 3.3

• インスタンスメソッド

現在開いている処理対象の 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 を返します。

• ARGF.class
• File
• IO

ARGF.class#filename -> String (24010.0)

• 3.3

• インスタンスメソッド

現在開いている処理対象のファイル名を返します。

現在開いている処理対象のファイル名を返します。

標準入力に対しては - を返します。
組み込み変数 $FILENAME と同じです。

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

$ ruby argf.rb foo bar glark

ARGF.filename # => "foo"
ARGF.read(5) # => "foo\nb"
ARGF.filename # => "bar"
ARGF.skip
ARGF.filename # => "glark"

• ARGF.class

ARGF.class#fileno -> Integer (24010.0)

• 3.3

• インスタンスメソッド

現在オープンしているファイルのファイル記述子を表す整数を返します。

現在オープンしているファイルのファイル記述子を表す整数を返します。

ARGF.fileno # => 3

@raise ArgumentError 現在開いているファイルがない場合に発生します。

• ARGF.class

絞り込み条件を変える

ARGF.class#getbyte -> Integer | nil (24010.0)

• 3.3

• インスタンスメソッド

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

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

ARGF はスクリプトに指定した引数(Object::ARGV を参照) をファイル名
とみなして、それらのファイルを連結した 1 つの仮想ファイルを表すオブジェ
クトです。そのため、最初のファイルを最後まで読んだ後は次のファイルの内
容を返します。

$ echo "foo" > file1
$ echo "bar" > file2
$ ruby argf.rb file1 file2

ARGF.getbyte # => 102
ARGF.g...

• ARGF.class

ARGF.class#getc -> String | nil (24010.0)

• 3.3

• インスタンスメソッド

self から 1 文字読み込んで返します。EOF に到達した時には nil を返します。

self から 1 文字読み込んで返します。EOF に到達した時には nil を返します。

ARGF はスクリプトに指定した引数(Object::ARGV を参照) をファイル名
とみなして、それらのファイルを連結した 1 つの仮想ファイルを表すオブジェ
クトです。そのため、最初のファイルを最後まで読んだ後は次のファイルの内
容を返します。

$ echo "foo" > file1
$ echo "bar" > file2
$ ruby argf.rb file1 file2

ARGF.getc # => "f"
ARGF.getc # => "o"
ARGF....

• ARGF.class

ARGF.class#gets(limit, chomp: false) -> String | nil (24010.0)

• 3.3

• インスタンスメソッド

ARGFの現在位置から一行ずつ文字列として読み込みます。EOF に到達した時に は nil を返します。

ARGFの現在位置から一行ずつ文字列として読み込みます。EOF に到達した時に
は nil を返します。

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

@param limit 最大の読み込みバイト数

@param chomp true を指定すると各行の末尾から "\n", "\r", または "\r\n" を取り除きます。

例:
# $ echo "line1\nline2\nline...

• ARGF.class

ARGF.class#gets(rs = $/, chomp: false) -> String | nil (24010.0)

• 3.3

• インスタンスメソッド

ARGFの現在位置から一行ずつ文字列として読み込みます。EOF に到達した時に は nil を返します。

ARGFの現在位置から一行ずつ文字列として読み込みます。EOF に到達した時に
は nil を返します。

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

@param limit 最大の読み込みバイト数

@param chomp true を指定すると各行の末尾から "\n", "\r", または "\r\n" を取り除きます。

例:
# $ echo "line1\nline2\nline...

• ARGF.class

ARGF.class#gets(rs, limit, chomp: false) -> String | nil (24010.0)

• 3.3

• インスタンスメソッド

ARGFの現在位置から一行ずつ文字列として読み込みます。EOF に到達した時に は nil を返します。

ARGFの現在位置から一行ずつ文字列として読み込みます。EOF に到達した時に
は nil を返します。

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

@param limit 最大の読み込みバイト数

@param chomp true を指定すると各行の末尾から "\n", "\r", または "\r\n" を取り除きます。

例:
# $ echo "line1\nline2\nline...

• ARGF.class

絞り込み条件を変える

ARGF.class#inplace_mode -> String | nil (24010.0)

• 3.3

• インスタンスメソッド

c:ARGF#inplace で書き換えるファイルのバックアップに付加される拡 張子を返します。拡張子が設定されていない場合は空文字列を返します。イン プレースモードでない場合は nil を返します。

c:ARGF#inplace で書き換えるファイルのバックアップに付加される拡
張子を返します。拡張子が設定されていない場合は空文字列を返します。イン
プレースモードでない場合は nil を返します。

Ruby 起動時の -i オプション や ARGF.class#inplace_mode= で設定します。

例:
# $ echo "test" > test.txt
# $ ruby -i.bak test.rb test.txt
# $ cat test.txt # => "TEST"
# $ cat test.txt.bak # => "test"

# test...

• ARGF.class

ARGF.class#inplace_mode=(ext) (24010.0)

• 3.3

• インスタンスメソッド

c:ARGF#inplace時にバックアップファイルに付加する拡張子を設定します。 ピリオドも含めて指定する必要があります。

c:ARGF#inplace時にバックアップファイルに付加する拡張子を設定します。
ピリオドも含めて指定する必要があります。

バックアップを残さない場合は空文字列を指定します。
この機能は Windows では使用出来ません。

設定が有効になるのは次のファイルの処理に移った時です。
インプレースモードに入っていない場合はその時点でモードに入ります。

Ruby 起動時の -i オプションで設定することも出来ます。

@param ext インプレースモード時にバックアップファイルに付加する拡張子を
文字列で指定します。
ピリオドも含める必要があ...

• ARGF.class

ARGF.class#inspect -> String (24010.0)

• 3.3

• インスタンスメソッド

常に文字列 "ARGF" を返します。

常に文字列 "ARGF" を返します。

• ARGF.class

ARGF.class#internal_encoding -> Encoding | nil (24010.0)

• 3.3

• インスタンスメソッド

ARGF から読み込んだ文字列の内部エンコーディングを返します。 内部エンコーディングが指定されていない場合は nil を返します。

ARGF から読み込んだ文字列の内部エンコーディングを返します。
内部エンコーディングが指定されていない場合は nil を返します。

まだ読み込み処理を始めていない場合は Encoding.default_external を返します。

ARGF.class#set_encoding で設定します。


例:
# $ ruby -Eutf-8 test.rb

# test.rb
ARGF.internal_encoding # => #<Encoding:UTF-8>
ARGF.set_encoding('utf-8','ascii')
ARG...

• ARGF.class
• IO

ARGF.class#lineno -> Integer (24010.0)

• 3.3

• インスタンスメソッド

全引数ファイルを一つのファイルとみなしたときの現在の行番号を返します。 個々の引数ファイル毎の行番号を得るには ARGF.file.lineno とします。

全引数ファイルを一つのファイルとみなしたときの現在の行番号を返します。
個々の引数ファイル毎の行番号を得るには ARGF.file.lineno とします。

この値を書き換えたい場合は ARGF.class#lineno= を使用してください。

ARGF.lineno # => 0
ARGF.readline # => "This is line 1\n"
ARGF.lineno # => 1

@see ARGF.class#lineno=

• ARGF.class

絞り込み条件を変える

ARGF.class#lineno=(number) (24010.0)

• 3.3

• インスタンスメソッド

全引数ファイルを一つのファイルとみなしたときの現在の行番号を number に書き換えます。

全引数ファイルを一つのファイルとみなしたときの現在の行番号を number に書き換えます。

この値を読み込みたい場合は ARGF.class#lineno を使用してください。

@param number 更新後の行番号を指定する

ARGF.lineno # => 0
ARGF.readline # => "This is line 1\n"
ARGF.lineno # => 1
ARGF.lineno = 0 # => 0
ARGF.lineno # => 0

@see ARGF.class#lineno

• ARGF.class

ARGF.class#path -> String (24010.0)

• 3.3

• インスタンスメソッド

現在開いている処理対象のファイル名を返します。

現在開いている処理対象のファイル名を返します。

標準入力に対しては - を返します。
組み込み変数 $FILENAME と同じです。

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

$ ruby argf.rb foo bar glark

ARGF.filename # => "foo"
ARGF.read(5) # => "foo\nb"
ARGF.filename # => "bar"
ARGF.skip
ARGF.filename # => "glark"

• ARGF.class

ARGF.class#pos -> Integer (24010.0)

• 3.3

• インスタンスメソッド

ARGFが現在開いているファイルのファイルポインタの現在の位置をバイト単位 の整数で返します。

ARGFが現在開いているファイルのファイルポインタの現在の位置をバイト単位
の整数で返します。

ARGF.pos # => 0
ARGF.gets # => "This is line one\n"
ARGF.pos # => 17

@see IO#pos, IO#tell, ARGF.class#pos=

• ARGF.class

ARGF.class#pos=(n) (24010.0)

• 3.3

• インスタンスメソッド

ARGFが開いているファイルのファイルポインタを指定位置に移動します。

ARGFが開いているファイルのファイルポインタを指定位置に移動します。

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

ARGF.pos = 17
ARGF.gets # => "This is line two\n"

@see IO#pos=, ARGF.class#pos

• ARGF.class

ARGF.class#print(*arg) -> nil (24010.0)

• 3.3

• インスタンスメソッド

引数を順に処理対象のファイルに出力します。

引数を順に処理対象のファイルに出力します。

c:ARGF#inplace時にのみ使用できます。
また $stdout への代入の影響を受けません。
それ以外は Kernel.#print と同じです。

@param arg 出力するオブジェクトを任意個指定します。

• ARGF.class

絞り込み条件を変える

ARGF.class#printf(format, *arg) -> nil (24010.0)

• 3.3

• インスタンスメソッド

C 言語の printf と同じように、format に従い引数を 文字列に変換して処理対象のファイルに出力します。

C 言語の printf と同じように、format に従い引数を
文字列に変換して処理対象のファイルに出力します。

c:ARGF#inplace時にのみ使用できます。
また $stdout への代入の影響を受けません。
それ以外は出力先を指定しない形式の Kernel.#printf と同じです。

@param format フォーマット文字列です。
@param arg フォーマットされる引数です。

• ARGF.class

ARGF.class#putc(ch) -> object (24010.0)

• 3.3

• インスタンスメソッド

文字 ch を処理対象のファイルに出力します。 ch を返します。

文字 ch を処理対象のファイルに出力します。
ch を返します。

c:ARGF#inplace時にのみ使用できます。
また $stdout への代入の影響を受けません。
それ以外は Kernel.#putc と同じです。

@param ch 出力する文字を String オブジェクトで指定します。

• ARGF.class
• String

ARGF.class#puts(*arg) -> nil (24010.0)

• 3.3

• インスタンスメソッド

引数と改行を順番に処理対象のファイルに出力します。 引数がなければ改行のみを出力します。

引数と改行を順番に処理対象のファイルに出力します。
引数がなければ改行のみを出力します。

c:ARGF#inplace時にのみ使用できます。
また $stdout への代入の影響を受けません。
それ以外は Kernel.#puts と同じです。

@param arg 出力するオブジェクトを任意個指定します。

• ARGF.class

ARGF.class#read(length = nil, str = nil) -> String | nil (24010.0)

• 3.3

• インスタンスメソッド

ARGVに指定されたファイルを先頭のファイルからlengthバイト読み込み、 その文字列をstrに出力します。読み込んだ文字列を返します。

ARGVに指定されたファイルを先頭のファイルからlengthバイト読み込み、
その文字列をstrに出力します。読み込んだ文字列を返します。

@param length 読み込むバイト数を指定します。nilの場合はARGVのすべてのファ
イルを読み込みます。

@param str 出力先の文字列。内容は上書きされます。

$ echo "small" > small.txt
$ echo "large" > large.txt
$ ruby glark.rb small.txt large.txt

ARGF.read # => "sm...

• ARGF.class

ARGF.class#read_nonblock(maxlen, outbuf = nil, exception: true) -> String | Symbol | nil (24010.0)

• 3.3

• インスタンスメソッド

処理中のファイルからノンブロッキングモードで最大 maxlen バイト読み込みます。 詳しくは IO#read_nonblock を参照してください。

処理中のファイルからノンブロッキングモードで最大 maxlen バイト読み込みます。
詳しくは IO#read_nonblock を参照してください。

ARGF.class#read などとは違って複数ファイルを同時に読み込むことはありません。

@param maxlen 読み込む長さの上限を整数で指定します。
@param outbuf 読み込んだデータを格納する String オブジェクトを指定します。
@param exception 読み込み時に Errno::EAGAIN、
Errno::EWOULDBLOCK が発生する代わりに
...

• ARGF.class
• Errno::EAGAIN
• String

絞り込み条件を変える

ARGF.class#readbyte -> Integer (24010.0)

• 3.3

• インスタンスメソッド

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

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

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

$ echo "foo" > file
$ ruby argf.rb file

ARGF.readbyte # => 102
ARGF.readbyte # => 111
ARGF.readbyte # => 111
ARGF.readbyte # => 10
ARGF.readbyte # => end of file reached (EOFError)...

• ARGF.class

ARGF.class#readchar -> String (24010.0)

• 3.3

• インスタンスメソッド

ARGFから 1 文字読み込んで、その文字に対応する String を返します。EOF に 到達した時には EOFErrorを発生します。

ARGFから 1 文字読み込んで、その文字に対応する String を返します。EOF に
到達した時には EOFErrorを発生します。

@raise EOFError EOFに達した時発生する

$ echo "foo" > file
$ ruby argf.rb file

ARGF.readchar # => "f"
ARGF.readchar # => "o"
ARGF.readchar # => "o"
ARGF.readchar # => "\n"
ARGF.readchar # => end of file reached (EOFEr...

• ARGF.class

ARGF.class#readline(limit) -> String (24010.0)

• 3.3

• インスタンスメソッド

ARGFの現在位置から一行ずつ文字列として読み込みます。EOF に到達した時に は EOFError を発生します。

ARGFの現在位置から一行ずつ文字列として読み込みます。EOF に到達した時に
は EOFError を発生します。

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

@param limit 最大の読み込みバイト数

@raise EOFError EOFに達したら発生する

@see Kernel.#readline, ARGF.class#gets

• ARGF.class
• EOFError

ARGF.class#readline(rs = $/) -> String (24010.0)

• 3.3

• インスタンスメソッド

ARGFの現在位置から一行ずつ文字列として読み込みます。EOF に到達した時に は EOFError を発生します。

ARGFの現在位置から一行ずつ文字列として読み込みます。EOF に到達した時に
は EOFError を発生します。

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

@param limit 最大の読み込みバイト数

@raise EOFError EOFに達したら発生する

@see Kernel.#readline, ARGF.class#gets

• ARGF.class
• EOFError

ARGF.class#readline(rs, limit) -> String (24010.0)

• 3.3

• インスタンスメソッド

ARGFの現在位置から一行ずつ文字列として読み込みます。EOF に到達した時に は EOFError を発生します。

ARGFの現在位置から一行ずつ文字列として読み込みます。EOF に到達した時に
は EOFError を発生します。

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

@param limit 最大の読み込みバイト数

@raise EOFError EOFに達したら発生する

@see Kernel.#readline, ARGF.class#gets

• ARGF.class
• EOFError

絞り込み条件を変える

ARGF.class#readlines(limit) -> Array (24010.0)

• 3.3

• インスタンスメソッド

ARGFの各行を配列に読み込んで返します。rsがnilの場合は要素に各ファイルを すべて読み込んだ配列を返します。

ARGFの各行を配列に読み込んで返します。rsがnilの場合は要素に各ファイルを
すべて読み込んだ配列を返します。

@param rs 行区切り文字

@param limit 最大の読み込みバイト数

lines = ARGF.readlines
lines[0] # => "This is line one\n"

@see $/, Kernel.#readlines, IO#readlines

• ARGF.class

ARGF.class#readlines(rs = $/) -> Array (24010.0)

• 3.3

• インスタンスメソッド

ARGFの各行を配列に読み込んで返します。rsがnilの場合は要素に各ファイルを すべて読み込んだ配列を返します。

ARGFの各行を配列に読み込んで返します。rsがnilの場合は要素に各ファイルを
すべて読み込んだ配列を返します。

@param rs 行区切り文字

@param limit 最大の読み込みバイト数

lines = ARGF.readlines
lines[0] # => "This is line one\n"

@see $/, Kernel.#readlines, IO#readlines

• ARGF.class

ARGF.class#readlines(rs, limit) -> Array (24010.0)

• 3.3

• インスタンスメソッド

ARGFの各行を配列に読み込んで返します。rsがnilの場合は要素に各ファイルを すべて読み込んだ配列を返します。

ARGFの各行を配列に読み込んで返します。rsがnilの場合は要素に各ファイルを
すべて読み込んだ配列を返します。

@param rs 行区切り文字

@param limit 最大の読み込みバイト数

lines = ARGF.readlines
lines[0] # => "This is line one\n"

@see $/, Kernel.#readlines, IO#readlines

• ARGF.class

ARGF.class#readpartial(maxlen, outbuf = nil) -> String (24010.0)

• 3.3

• インスタンスメソッド

IO#readpartialを参照。ARGF.class#read などとは違って複数ファ イルを同時に読み込むことはありません。

IO#readpartialを参照。ARGF.class#read などとは違って複数ファ
イルを同時に読み込むことはありません。

@param maxlen 読み込む長さの上限を整数で指定します。
@param outbuf 読み込んだデータを格納する String オブジェクトを指定します。

@see IO#readpartial, ARGF.class#read_nonblock

• ARGF.class
• String

ARGF.class#rewind -> 0 (24010.0)

• 3.3

• インスタンスメソッド

ARGFが現在開いているファイルのファイルポインタを先頭に戻します。

ARGFが現在開いているファイルのファイルポインタを先頭に戻します。

ARGF.readline # => "This is line one\n"
ARGF.rewind # => 0
ARGF.lineno # => 0
ARGF.readline # => "This is line one\n"

• ARGF.class

絞り込み条件を変える

ARGF.class#seek(offset, whence = IO::SEEK_SET) -> 0 (24010.0)

• 3.3

• インスタンスメソッド

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

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

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

@see IO#seek

• ARGF.class

ARGF.class#set_encoding(enc_str, options = {}) -> self (24010.0)

• 3.3

• インスタンスメソッド

ARGF の外部／内部エンコーディングを設定します。 次以降に処理するファイルにも同じ設定が適用されます。

ARGF の外部／内部エンコーディングを設定します。
次以降に処理するファイルにも同じ設定が適用されます。

外部エンコーディングは ARGF を介して読み込むファイルの、
内部エンコーディングは読み込んだ文字列のエンコーディングです。

詳しくは IO#set_encoding を参照してください。

@param enc_str 外部／内部エンコーディングを"A:B" のようにコロンで
区切って指定します。
@param ext_enc 外部エンコーディングを表す文字列か
Encoding オブジェクトを指定します。
@para...

• ARGF.class

ARGF.class#set_encoding(ext_enc) -> self (24010.0)

• 3.3

• インスタンスメソッド

ARGF の外部／内部エンコーディングを設定します。 次以降に処理するファイルにも同じ設定が適用されます。

ARGF の外部／内部エンコーディングを設定します。
次以降に処理するファイルにも同じ設定が適用されます。

外部エンコーディングは ARGF を介して読み込むファイルの、
内部エンコーディングは読み込んだ文字列のエンコーディングです。

詳しくは IO#set_encoding を参照してください。

@param enc_str 外部／内部エンコーディングを"A:B" のようにコロンで
区切って指定します。
@param ext_enc 外部エンコーディングを表す文字列か
Encoding オブジェクトを指定します。
@para...

• ARGF.class

ARGF.class#set_encoding(ext_enc, int_enc, options = {}) -> self (24010.0)

• 3.3

• インスタンスメソッド

ARGF の外部／内部エンコーディングを設定します。 次以降に処理するファイルにも同じ設定が適用されます。

ARGF の外部／内部エンコーディングを設定します。
次以降に処理するファイルにも同じ設定が適用されます。

外部エンコーディングは ARGF を介して読み込むファイルの、
内部エンコーディングは読み込んだ文字列のエンコーディングです。

詳しくは IO#set_encoding を参照してください。

@param enc_str 外部／内部エンコーディングを"A:B" のようにコロンで
区切って指定します。
@param ext_enc 外部エンコーディングを表す文字列か
Encoding オブジェクトを指定します。
@para...

• ARGF.class

ARGF.class#skip -> self (24010.0)

• 3.3

• インスタンスメソッド

現在開いている処理対象のファイルをクローズします。 次回の読み込みは次の引数が処理対象になります。 self を返します。

現在開いている処理対象のファイルをクローズします。
次回の読み込みは次の引数が処理対象になります。
self を返します。

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

$ ruby argf.rb foo bar
ARGF.filename # => "foo"
ARGF.skip
ARGF.filename # => "bar"

• ARGF.class

絞り込み条件を変える

ARGF.class#tell -> Integer (24010.0)

• 3.3

• インスタンスメソッド

ARGFが現在開いているファイルのファイルポインタの現在の位置をバイト単位 の整数で返します。

ARGFが現在開いているファイルのファイルポインタの現在の位置をバイト単位
の整数で返します。

ARGF.pos # => 0
ARGF.gets # => "This is line one\n"
ARGF.pos # => 17

@see IO#pos, IO#tell, ARGF.class#pos=

• ARGF.class

ARGF.class#to_a(limit) -> Array (24010.0)

• 3.3

• インスタンスメソッド

ARGFの各行を配列に読み込んで返します。rsがnilの場合は要素に各ファイルを すべて読み込んだ配列を返します。

ARGFの各行を配列に読み込んで返します。rsがnilの場合は要素に各ファイルを
すべて読み込んだ配列を返します。

@param rs 行区切り文字

@param limit 最大の読み込みバイト数

lines = ARGF.readlines
lines[0] # => "This is line one\n"

@see $/, Kernel.#readlines, IO#readlines

• ARGF.class

ARGF.class#to_a(rs = $/) -> Array (24010.0)

• 3.3

• インスタンスメソッド

ARGFの各行を配列に読み込んで返します。rsがnilの場合は要素に各ファイルを すべて読み込んだ配列を返します。

ARGFの各行を配列に読み込んで返します。rsがnilの場合は要素に各ファイルを
すべて読み込んだ配列を返します。

@param rs 行区切り文字

@param limit 最大の読み込みバイト数

lines = ARGF.readlines
lines[0] # => "This is line one\n"

@see $/, Kernel.#readlines, IO#readlines

• ARGF.class

ARGF.class#to_a(rs, limit) -> Array (24010.0)

• 3.3

• インスタンスメソッド

ARGFの各行を配列に読み込んで返します。rsがnilの場合は要素に各ファイルを すべて読み込んだ配列を返します。

ARGFの各行を配列に読み込んで返します。rsがnilの場合は要素に各ファイルを
すべて読み込んだ配列を返します。

@param rs 行区切り文字

@param limit 最大の読み込みバイト数

lines = ARGF.readlines
lines[0] # => "This is line one\n"

@see $/, Kernel.#readlines, IO#readlines

• ARGF.class

ARGF.class#to_i -> Integer (24010.0)

• 3.3

• インスタンスメソッド

現在オープンしているファイルのファイル記述子を表す整数を返します。

現在オープンしているファイルのファイル記述子を表す整数を返します。

ARGF.fileno # => 3

@raise ArgumentError 現在開いているファイルがない場合に発生します。

• ARGF.class

絞り込み条件を変える

ARGF.class#to_io -> IO (24010.0)

• 3.3

• インスタンスメソッド

ARGFが現在開いているファイルのFile、またはIOオブジェクトを 返します。

ARGFが現在開いているファイルのFile、またはIOオブジェクトを
返します。

ARGF.to_io # => #<File:glark.txt>
ARGF.to_io # => #<IO:<STDIN>>

@see ARGF.class#file, ARGF.class#to_write_io

• ARGF.class
• File
• IO

ARGF.class#to_s -> String (24010.0)

• 3.3

• インスタンスメソッド

常に文字列 "ARGF" を返します。

常に文字列 "ARGF" を返します。

• ARGF.class

ARGF.class#to_write_io -> IO (24010.0)

• 3.3

• インスタンスメソッド

処理対象のファイルへの書き出し用 IO オブジェクトを返します。

処理対象のファイルへの書き出し用 IO オブジェクトを返します。

c:ARGF#inplace時以外は読み込み用の IO オブジェクトを返します。
このため ARGF.class#write などの書き出し用メソッドを呼ぶと IOError が発生します。

• ARGF.class
• IO
• IOError

ARGF.class#write(str) -> Integer (24010.0)

• 3.3

• インスタンスメソッド

処理対象のファイルに対して str を出力します。 str が文字列でなければ to_s による文字列化を試みます。 実際に出力できたバイト数を返します。

処理対象のファイルに対して str を出力します。
str が文字列でなければ to_s による文字列化を試みます。
実際に出力できたバイト数を返します。

c:ARGF#inplace時にのみ使用できます。

@param str 出力する文字列を指定します。

@see ARGF.class#to_write_io

• ARGF.class

Array#&(other) -> Array (24010.0)

• 3.3

• インスタンスメソッド

集合の積演算です。両方の配列に含まれる要素からなる新しい配列を返 します。重複する要素は取り除かれます。

集合の積演算です。両方の配列に含まれる要素からなる新しい配列を返
します。重複する要素は取り除かれます。

要素の重複判定は、Object#eql? により行われます。

新しい配列における要素の順は self における要素の順と同じです。

@param other 配列を指定します。
配列以外のオブジェクトを指定した場合は to_ary メソッドによ
る暗黙の型変換を試みます。

@raise TypeError 引数に配列以外の(暗黙の型変換が行えない)オブジェクトを
指定した場合に発生します。

/...

• Array

絞り込み条件を変える

Array#*(sep) -> String (24010.0)

• 3.3

• インスタンスメソッド

指定された sep を間にはさんで連結した文字列を生成して返します。Array#join(sep) と同じ動作をします。

指定された sep を間にはさんで連結した文字列を生成して返します。Array#join(sep) と同じ動作をします。

@param sep 文字列を指定します。
文字列以外のオブジェクトを指定した場合は to_str メソッドによ
る暗黙の型変換を試みます。

//emlist[例][ruby]{
p [1,2,3] * ","
# => "1,2,3"
//}

@see Array#join

• Array

Array#*(times) -> Array (24010.0)

• 3.3

• インスタンスメソッド

配列の内容を times 回 繰り返した新しい配列を作成して返します。 値はコピーされないことに注意してください。

配列の内容を times 回 繰り返した新しい配列を作成して返します。
値はコピーされないことに注意してください。

@param times 繰り返したい回数を整数で指定します。
整数以外のオブジェクトを指定した場合は to_int メソッドによ
る暗黙の型変換を試みます。

@raise TypeError 引数に整数以外の(暗黙の型変換が行えない)オブジェクトを
指定した場合に発生します。

@raise ArgumentError 引数に負の数を指定した場合に発生します。

//emlist[例][...

• Array

Array#+(other) -> Array (24010.0)

• 3.3

• インスタンスメソッド

自身と other の内容を繋げた配列を生成して返します。

自身と other の内容を繋げた配列を生成して返します。

@param other 自身と繋げたい配列を指定します。
配列以外のオブジェクトを指定した場合は to_ary メソッドによ
る暗黙の型変換を試みます。

@raise TypeError 引数に配列以外の(暗黙の型変換が行えない)オブジェクトを
指定した場合に発生します。

//emlist[例][ruby]{
a = [1, 2]
b = [8, 9]
p a + b #=> [1, 2, 8, 9]
p a #=>...

• Array

Array#-(other) -> Array (24010.0)

• 3.3

• インスタンスメソッド

自身から other の要素を取り除いた配列を生成して返します。

自身から other の要素を取り除いた配列を生成して返します。

要素の同一性は Object#eql? により評価されます。
self 中で重複していて、other中に存在していなかった要素は、その重複が保持されます。

@param other 自身から取り除きたい要素の配列を指定します。
配列以外のオブジェクトを指定した場合は to_ary メソッドによ
る暗黙の型変換を試みます。

@raise TypeError 引数に配列以外の(暗黙の型変換が行えない)オブジェクトを
指定した場合に発生します...

• Array

Array#<<(obj) -> self (24010.0)

• 3.3

• インスタンスメソッド

指定された obj を自身の末尾に破壊的に追加します。

指定された obj を自身の末尾に破壊的に追加します。

//emlist[例][ruby]{
ary = [1]
ary << 2
p ary # [1, 2]
//}

またこのメソッドは self を返すので、以下のように連続して
書くことができます。

//emlist[例][ruby]{
ary = [1]
ary << 2 << 3 << 4
p ary #=> [1, 2, 3, 4]
//}

@param obj 自身に加えたいオブジェクトを指定します。Array#push と違って引数は一つしか指定できません。

@see Array#push

• Array

絞り込み条件を変える

Array#<=>(other) -> -1 | 0 | 1 | nil (24010.0)

• 3.3

• インスタンスメソッド

自身と other の各要素をそれぞれ順に <=> で比較していき、結果が 0 でなかった場合に その値を返します。各要素が等しく、配列の長さも等しい場合には 0 を返します。 各要素が等しいまま一方だけ配列の末尾に達した時、自身の方が短ければ -1 をそうでなければ 1 を返します。 other に配列以外のオブジェクトを指定した場合は nil を返します。

自身と other の各要素をそれぞれ順に <=> で比較していき、結果が 0 でなかった場合に
その値を返します。各要素が等しく、配列の長さも等しい場合には 0 を返します。
各要素が等しいまま一方だけ配列の末尾に達した時、自身の方が短ければ -1 をそうでなければ 1
を返します。
other に配列以外のオブジェクトを指定した場合は nil を返します。

@param other 自身と比較したい配列を指定します。
配列以外のオブジェクトを指定した場合は to_ary メソッドによ
る暗黙の型変換を試みます。


//emlist[...

• Array

Array#==(other) -> bool (24010.0)

• 3.3

• インスタンスメソッド

自身と other の各要素をそれぞれ順に == で比較し て、全要素が等しければ true を返します。そうでない場合には false を返します。

自身と other の各要素をそれぞれ順に == で比較し
て、全要素が等しければ true を返します。そうでない場合には false を返します。

@param other 自身と比較したい配列を指定します。

@see Object#==

//emlist[例][ruby]{
[ "a", "c" ] == [ "a", "c", 7 ] #=> false
[ "a", "c", 7 ] == [ "a", "c", 7 ] #=> true
[ "a", "c", 7 ] == [ "a", "d", "f" ] #=> false
//}

• Array

Array#[](nth) -> object | nil (24010.0)

• 3.3

• インスタンスメソッド

nth 番目の要素を返します。nth 番目の要素が存在しない時には nil を返します。

nth 番目の要素を返します。nth 番目の要素が存在しない時には nil を返します。

@param nth インデックスを整数で指定します。
先頭の要素が 0 番目になります。nth の値が負の時には末尾から
のインデックスと見倣します。末尾の要素が -1 番目になります。
整数以外のオブジェクトを指定した場合は to_int メソッドによる
暗黙の型変換を試みます。

@raise TypeError 引数に整数以外の(暗黙の型変換が行えない)オブジェクトを
指定...

• Array

Array#[](range) -> Array | nil (24010.0)

• 3.3

• インスタンスメソッド

Range オブジェクト range の範囲にある要素からなる部分配列を返します。 range の begin が自身の範囲外となる時は nil を返します。ただし、begin が配列の長さに等しいときは空の配列を返します。 range の begin が end より後にある場合には空の配列を返します。

Range オブジェクト range の範囲にある要素からなる部分配列を返します。
range の begin が自身の範囲外となる時は nil を返します。ただし、begin が配列の長さに等しいときは空の配列を返します。
range の begin が end より後にある場合には空の配列を返します。

@param range 生成したい部分配列の範囲を Range オブジェクトで指定します。
range の begin や end の値が負の時には末尾からのインデックスと見倣します。末尾
の要素が -1 番目になります。
...

• Array
• Range

Array#[](start, length) -> Array | nil (24010.0)

• 3.3

• インスタンスメソッド

start 番目から length 個の要素を含む部分配列を返します。 start が自身の範囲外となる時は nil を返します。ただし、start が配列の長さに等しいときは空の配列を返します。 length が負の時は nil を返します。

start 番目から length 個の要素を含む部分配列を返します。
start が自身の範囲外となる時は nil を返します。ただし、start が配列の長さに等しいときは空の配列を返します。
length が負の時は nil を返します。

@param start 生成したい部分配列の先頭のインデックスを整数で指定します。
start の値が負の時には末尾からのインデックスと見倣します。
末尾の要素が -1 番目になります。
整数以外のオブジェクトを指定した場合は to_int メソッドによ
...

• Array

絞り込み条件を変える

Array#[]=(nth, val) (24010.0)

• 3.3

• インスタンスメソッド

nth 番目の要素を val に設定します。nth が配列の範囲を越える時には配列の長さを自動的に拡張し、 拡張した領域を nil で初期化します。

nth 番目の要素を val に設定します。nth が配列の範囲を越える時には配列の長さを自動的に拡張し、
拡張した領域を nil で初期化します。

@param nth インデックスを整数で指定します。
整数以外のオブジェクトを指定した場合は to_int メソッドによる
暗黙の型変換を試みます。

@param val 設定したい要素の値を指定します。

@raise TypeError 引数 nth に整数以外の(暗黙の型変換が行えない)オブジェ
クトを指定した場合に発生します。

@raise Index...

• Array

Array#[]=(range, val) (24010.0)

• 3.3

• インスタンスメソッド

Range オブジェクト range の範囲にある要素を配列 val の内容に置換します。 range の first が自身の末尾を越える時には配列の長さを自動的に拡張し、拡張した領域を nil で初期化します。

Range オブジェクト range の範囲にある要素を配列 val の内容に置換します。
range の first が自身の末尾を越える時には配列の長さを自動的に拡張し、拡張した領域を nil で初期化します。

//emlist[例][ruby]{
ary = [0, 1, 2, 3, 4, 5]
ary[0..2] = ["a", "b"]
p ary # => ["a", "b", 3, 4, 5]

ary = [0, 1, 2]
ary[5..6] = "x"
p ary # => [0, 1, 2, nil, nil, "x"]

ary = [0, 1, 2, 3, 4...

• Array
• Range

Array#[]=(start, length, val) (24010.0)

• 3.3

• インスタンスメソッド

インデックス start から length 個の要素を配列 val の内容で置き換えます。 start が自身の末尾を越える時には配列の長さを自動的に拡張し、拡張した領域を nil で初期化します。

インデックス start から length 個の要素を配列 val の内容で置き換えます。
start が自身の末尾を越える時には配列の長さを自動的に拡張し、拡張した領域を nil で初期化します。

//emlist[例][ruby]{
ary = [0, 1, 2, 3]
ary[1, 2] = ["a", "b", "c", "d"]
p ary #=> [0, "a", "b", "c", "d", 3]

ary = [0, 1, 2]
ary[5, 1] = "Z"
p ary #=> ...

• Array

Array#all? -> bool (24010.0)

• 3.3

• インスタンスメソッド

すべての要素が真である場合に true を返します。 偽である要素があれば、ただちに false を返します。

すべての要素が真である場合に true を返します。
偽である要素があれば、ただちに false を返します。

ブロックを伴う場合は、各要素に対してブロックを評価し、すべての結果
が真である場合に true を返します。ブロックが偽を返した時点で、
ただちに false を返します。

要素の数が 0 である配列に対しては true を返します。

@param pattern ブロックの代わりに各要素に対して pattern === item を評価します。

//emlist[例][ruby]{
# すべて正の数か？
p [5, 6, 7].all? {|v| v > 0 } #...

• Array

Array#all? {|item| ... } -> bool (24010.0)

• 3.3

• インスタンスメソッド

すべての要素が真である場合に true を返します。 偽である要素があれば、ただちに false を返します。

すべての要素が真である場合に true を返します。
偽である要素があれば、ただちに false を返します。

ブロックを伴う場合は、各要素に対してブロックを評価し、すべての結果
が真である場合に true を返します。ブロックが偽を返した時点で、
ただちに false を返します。

要素の数が 0 である配列に対しては true を返します。

@param pattern ブロックの代わりに各要素に対して pattern === item を評価します。

//emlist[例][ruby]{
# すべて正の数か？
p [5, 6, 7].all? {|v| v > 0 } #...

• Array

絞り込み条件を変える

Array#all?(pattern) -> bool (24010.0)

• 3.3

• インスタンスメソッド

すべての要素が真である場合に true を返します。 偽である要素があれば、ただちに false を返します。

すべての要素が真である場合に true を返します。
偽である要素があれば、ただちに false を返します。

ブロックを伴う場合は、各要素に対してブロックを評価し、すべての結果
が真である場合に true を返します。ブロックが偽を返した時点で、
ただちに false を返します。

要素の数が 0 である配列に対しては true を返します。

@param pattern ブロックの代わりに各要素に対して pattern === item を評価します。

//emlist[例][ruby]{
# すべて正の数か？
p [5, 6, 7].all? {|v| v > 0 } #...

• Array

Array#any? -> bool (24010.0)

• 3.3

• インスタンスメソッド

すべての要素が偽である場合に false を返します。 真である要素があれば、ただちに true を返します。

すべての要素が偽である場合に false を返します。
真である要素があれば、ただちに true を返します。

ブロックを伴う場合は、各要素に対してブロックを評価し、すべての結果
が偽である場合に false を返します。ブロックが真を返した時点
で、ただちに true を返します。

要素の数が 0 である配列に対しては false を返します。

@param pattern ブロックの代わりに各要素に対して pattern === item を評価します。

//emlist[例][ruby]{
p [1, 2, 3].any? {|v| v > 3 } # => false
p...

• Array

Array#any? {|item| ... } -> bool (24010.0)

• 3.3

• インスタンスメソッド

すべての要素が偽である場合に false を返します。 真である要素があれば、ただちに true を返します。

すべての要素が偽である場合に false を返します。
真である要素があれば、ただちに true を返します。

ブロックを伴う場合は、各要素に対してブロックを評価し、すべての結果
が偽である場合に false を返します。ブロックが真を返した時点
で、ただちに true を返します。

要素の数が 0 である配列に対しては false を返します。

@param pattern ブロックの代わりに各要素に対して pattern === item を評価します。

//emlist[例][ruby]{
p [1, 2, 3].any? {|v| v > 3 } # => false
p...

• Array

Array#any?(pattern) -> bool (24010.0)

• 3.3

• インスタンスメソッド

すべての要素が偽である場合に false を返します。 真である要素があれば、ただちに true を返します。

すべての要素が偽である場合に false を返します。
真である要素があれば、ただちに true を返します。

ブロックを伴う場合は、各要素に対してブロックを評価し、すべての結果
が偽である場合に false を返します。ブロックが真を返した時点
で、ただちに true を返します。

要素の数が 0 である配列に対しては false を返します。

@param pattern ブロックの代わりに各要素に対して pattern === item を評価します。

//emlist[例][ruby]{
p [1, 2, 3].any? {|v| v > 3 } # => false
p...

• Array

Array#append(*obj) -> self (24010.0)

• 3.3

• インスタンスメソッド

指定された obj を順番に配列の末尾に追加します。 引数を指定しなければ何もしません。

指定された obj を順番に配列の末尾に追加します。
引数を指定しなければ何もしません。

@param obj 自身に追加したいオブジェクトを指定します。

//emlist[例][ruby]{
array = [1, 2, 3]
array.push 4
array.push [5, 6]
array.push 7, 8
p array # => [1, 2, 3, 4, [5, 6], 7, 8]
//}

@see Array#pop, Array#shift, Array#unshift, Array#<<

• Array

絞り込み条件を変える

Array#assoc(key) -> Array | nil (24010.0)

• 3.3

• インスタンスメソッド

配列の配列を検索して、その 0 番目の要素が key に == で等しい 最初の要素を返します。該当する要素がなければ nil を返します。

配列の配列を検索して、その 0 番目の要素が key に == で等しい
最初の要素を返します。該当する要素がなければ nil を返します。

@param key 検索するオブジェクトを指定します。

//emlist[例][ruby]{
ary = [[1,15], [2,25], [3,35]]
p ary.assoc(2) # => [2, 25]
p ary.assoc(100) # => nil
p ary.assoc(15) # => nil
//}

@see Array#rassoc

• Array

Array#at(nth) -> object | nil (24010.0)

• 3.3

• インスタンスメソッド

nth 番目の要素を返します。nth 番目の要素が存在しない時には nil を返します。

nth 番目の要素を返します。nth 番目の要素が存在しない時には nil を返します。

@param nth インデックスを整数で指定します。
先頭の要素が 0 番目になります。nth の値が負の時には末尾から
のインデックスと見倣します。末尾の要素が -1 番目になります。
整数以外のオブジェクトを指定した場合は to_int メソッドによる
暗黙の型変換を試みます。

@raise TypeError 引数に整数以外の(暗黙の型変換が行えない)オブジェクトを
指定...

• Array

Array#bsearch -> Enumerator (24010.0)

• 3.3

• インスタンスメソッド

ブロックの評価結果で範囲内の各要素の判定を行い、条件を満たす値を二分探 索(計算量は O(log n))で検索します。要素が見つからない場合は nil を返し ます。self はあらかじめソートしておく必要があります。

ブロックの評価結果で範囲内の各要素の判定を行い、条件を満たす値を二分探
索(計算量は O(log n))で検索します。要素が見つからない場合は nil を返し
ます。self はあらかじめソートしておく必要があります。

本メソッドはブロックを評価した結果により以下のいずれかのモードで動作し
ます。

* find-minimum モード
* find-any モード

find-minimum モード(特に理由がない限りはこのモードを使う方がいいでしょ
う)では、条件判定の結果を以下のようにする必要があります。

* 求める値がブロックパラメータの値か前の要素の場合: true を返...

• Array
• Enumerator

Array#bsearch { |x| ... } -> object | nil (24010.0)

• 3.3

• インスタンスメソッド

ブロックの評価結果で範囲内の各要素の判定を行い、条件を満たす値を二分探 索(計算量は O(log n))で検索します。要素が見つからない場合は nil を返し ます。self はあらかじめソートしておく必要があります。

ブロックの評価結果で範囲内の各要素の判定を行い、条件を満たす値を二分探
索(計算量は O(log n))で検索します。要素が見つからない場合は nil を返し
ます。self はあらかじめソートしておく必要があります。

本メソッドはブロックを評価した結果により以下のいずれかのモードで動作し
ます。

* find-minimum モード
* find-any モード

find-minimum モード(特に理由がない限りはこのモードを使う方がいいでしょ
う)では、条件判定の結果を以下のようにする必要があります。

* 求める値がブロックパラメータの値か前の要素の場合: true を返...

• Array
• Enumerator

Array#bsearch_index -> Enumerator (24010.0)

• 3.3

• インスタンスメソッド

ブロックの評価結果で範囲内の各要素の判定を行い、条件を満たす値の位置を 二分探索(計算量は O(log n))で検索します。要素が見つからない場合は nil を返します。self はあらかじめソートしておく必要があります。

ブロックの評価結果で範囲内の各要素の判定を行い、条件を満たす値の位置を
二分探索(計算量は O(log n))で検索します。要素が見つからない場合は nil
を返します。self はあらかじめソートしておく必要があります。

本メソッドはArray#bsearchと同様に、ブロックを評価した結果により2
つのモードで動作します。Array#bsearch との違いは見つかった要素自
身を返すか位置を返すかのみです。各モードのより詳細な違いについては
Array#bsearch を参照してください。

//emlist[例: find-minimum モード][ruby]{
ary = [0,...

• Array

絞り込み条件を変える

Array#bsearch_index { |x| ... } -> Integer | nil (24010.0)

• 3.3

• インスタンスメソッド

ブロックの評価結果で範囲内の各要素の判定を行い、条件を満たす値の位置を 二分探索(計算量は O(log n))で検索します。要素が見つからない場合は nil を返します。self はあらかじめソートしておく必要があります。

ブロックの評価結果で範囲内の各要素の判定を行い、条件を満たす値の位置を
二分探索(計算量は O(log n))で検索します。要素が見つからない場合は nil
を返します。self はあらかじめソートしておく必要があります。

本メソッドはArray#bsearchと同様に、ブロックを評価した結果により2
つのモードで動作します。Array#bsearch との違いは見つかった要素自
身を返すか位置を返すかのみです。各モードのより詳細な違いについては
Array#bsearch を参照してください。

//emlist[例: find-minimum モード][ruby]{
ary = [0,...

• Array

Array#clear -> self (24010.0)

• 3.3

• インスタンスメソッド

配列の要素をすべて削除して空にします。

配列の要素をすべて削除して空にします。

//emlist[例][ruby]{
ary = [1, 2]
ary.clear
p ary #=> []
//}

• Array

Array#clone -> Array (24010.0)

• 3.3

• インスタンスメソッド

レシーバと同じ内容を持つ新しい配列を返します。

レシーバと同じ内容を持つ新しい配列を返します。

clone は frozen singleton-class の情報も含めてコピーしますが、
dup は内容だけをコピーします。
またどちらのメソッドも要素それ自体のコピーはしません。
つまり参照しているオブジェクトが変わらない「浅い(shallow)」コピーを行います。

//emlist[例][ruby]{
ary = ['string']
p ary #=> ["string"]
copy = ary.dup
p copy #=> ["string"]

ary[0][0...3] = ''...

• Array

Array#collect -> Enumerator (24010.0)

• 3.3

• インスタンスメソッド

各要素に対してブロックを評価した結果を全て含む配列を返します。

各要素に対してブロックを評価した結果を全て含む配列を返します。

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

//emlist[例][ruby]{
# すべて 3 倍にする
p [1, 2, 3].map {|n| n * 3 } # => [3, 6, 9]
//}

@see Hash#to_h, Enumerable#collect, Enumerable#map

• Array
• Enumerator

Array#collect {|item| ... } -> [object] (24010.0)

• 3.3

• インスタンスメソッド

各要素に対してブロックを評価した結果を全て含む配列を返します。

各要素に対してブロックを評価した結果を全て含む配列を返します。

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

//emlist[例][ruby]{
# すべて 3 倍にする
p [1, 2, 3].map {|n| n * 3 } # => [3, 6, 9]
//}

@see Hash#to_h, Enumerable#collect, Enumerable#map

• Array
• Enumerator

絞り込み条件を変える