検索結果

CSV::FieldInfo#header -> String | nil (63643.0)

• 2.3.0

• インスタンスメソッド

利用可能な場合はヘッダを表す文字列を返します。

利用可能な場合はヘッダを表す文字列を返します。

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

csv = CSV.new("date1,date2\n2018-07-09,2018-07-10", headers: true)
csv.convert do |field,field_info|
p field_info.header
Date.parse(field)
end
p csv.first

# => "date1"
# => "date2"
# => #<CSV::Row "date1":#<Date: 2018-07-09 ((2458309j,...

• CSV::FieldInfo

CSV::Row#header_row? -> bool (46198.0)

• 2.3.0

• インスタンスメソッド

ヘッダ行であれば真を返します。そうでなければ偽を返します。

ヘッダ行であれば真を返します。そうでなければ偽を返します。

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

header_row = CSV::Row.new(["header1", "header2"], [], true)
row = CSV::Row.new(["header1", "header2"], [1, 2])
header_row.header_row? # => true
row.header_row? # => false
//}

• CSV::Row

CSV::Row#field_row? -> bool (45859.0)

• 2.3.0

• インスタンスメソッド

フィールド行であれば真を返します。そうでなければ偽を返します。

フィールド行であれば真を返します。そうでなければ偽を返します。

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

header_row = CSV::Row.new(["header1", "header2"], [], true)
row = CSV::Row.new(["header1", "header2"], [1, 2])
header_row.field_row? # => false
row.field_row? # => true
//}

• CSV::Row

CSV#header_row? -> bool (37036.0)

• 2.3.0

• インスタンスメソッド

次に読み込まれる行が、ヘッダである場合に真を返します。 そうでない場合は、偽を返します。

次に読み込まれる行が、ヘッダである場合に真を返します。
そうでない場合は、偽を返します。

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

csv = CSV.new("header1,header2\nrow1_1,row1_2", headers: true)
csv.header_row? # => true
csv.readline
csv.header_row? # => false
//}

• CSV

CSV::Table#by_col_or_row -> CSV::Table (36985.0)

• 2.3.0

• インスタンスメソッド

ミックスモードになっている新しい CSV::Table オブジェクトを返します。

ミックスモードになっている新しい CSV::Table オブジェクトを返します。

元のテーブルモードを変更せずにメソッドチェーンできるので便利です。しか
し、大きなデータセットに対しても同じだけメモリを消費するので気をつけて
ください。

このメソッドは複製したテーブルを返すので、破壊的なメソッドはメソッド
チェーンに組込まないようにしてください。

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

row1 = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])
row2 = CSV::Row.new([...

• CSV::Table

絞り込み条件を変える

CSV::Table#by_col_or_row! -> self (36931.0)

• 2.3.0

• インスタンスメソッド

自身をミックスモードに変更します。

自身をミックスモードに変更します。

再びモードが変更されるまで、いくつかのメソッドはミックスモードで動きます。

デフォルトのミックスモードではインデックスによるアクセスは行単位での参
照であると見なします。しかし、他の方法ではヘッダによる列単位での参照で
あると見なします。

@return 必ず自身を返すので安全にメソッドチェーンできます。

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

row1 = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])
row2 = CSV::Row.new(["h...

• CSV::Table

CSV::Row#delete(header_or_index, minimum_index = 0) -> [object, object] | nil (28705.0)

• 2.3.0

• インスタンスメソッド

ヘッダの名前かインデックスで行からフィールドを削除するために使用します。

ヘッダの名前かインデックスで行からフィールドを削除するために使用します。

@param header_or_index ヘッダの名前かインデックスを指定します。

@param minimum_index このインデックスより後で、ヘッダの名前を探します。
重複しているヘッダがある場合に便利です。

@return 削除したヘッダとフィールドの組を返します。削除対象が見つからなかった場合は nil を返します。

//emlist[例 ヘッダの名前で指定][ruby]{
require "csv"

row = CSV::Row.new(["hea...

• CSV::Row

CSV::Table#delete_if {|row| ... } -> self (28219.0)

• 2.3.0

• インスタンスメソッド

ブロックを評価した結果が真である行か列を削除します。

ブロックを評価した結果が真である行か列を削除します。

デフォルトのミックスモードかロウモードでは、行単位で繰り返します。カラ
ムモードでは、ブロックに列名と対応する値の配列を与え、列単位で繰り返し
ます。

//emlist[例 ロウモード][ruby]{
require "csv"

row1 = CSV::Row.new(["header1", "header2"], ["row1_1", "valid"])
row2 = CSV::Row.new(["header1", "header2"], ["row2_1", "invalid"])
row3 = CSV::Row.new(["...

• CSV::Table

CSV::Table#by_row -> CSV::Table (28183.0)

• 2.3.0

• インスタンスメソッド

ロウモードになっている新しい CSV::Table オブジェクトを返します。

ロウモードになっている新しい CSV::Table オブジェクトを返します。

元のテーブルモードを変更せずにメソッドチェーンできるので便利です。しか
し、大きなデータセットに対しても同じだけメモリを消費するので気をつけて
ください。

このメソッドは複製したテーブルを返すので、破壊的なメソッドはメソッド
チェーンに組込まないようにしてください。

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

row1 = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])
row2 = CSV::Row.new(["h...

• CSV::Table

CSV::Table#by_row! -> self (28129.0)

• 2.3.0

• インスタンスメソッド

自身をロウモードに変更します。

自身をロウモードに変更します。

再びモードが変更されるまで、いくつかのメソッドは行単位で動きます。

@return 必ず自身を返すので安全にメソッドチェーンできます。

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

row1 = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])
row2 = CSV::Row.new(["header1", "header2"], ["row2_1", "row2_2"])
table = CSV::Table.new([row1, row2])
table ...

• CSV::Table

絞り込み条件を変える

CSV::Table#delete(index_or_header) -> object (27967.0)

• 2.3.0

• インスタンスメソッド

指定された行か列を削除して返します。

指定された行か列を削除して返します。

デフォルトのミックスモードではインデックスによるアクセスは行単位での参
照であると見なします。しかし、他の方法ではヘッダによる列単位での参照で
あると見なします。

探索方法を変更したい場合は CSV::Table#by_col!,
CSV::Table#by_row! を使用してください。

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

row1 = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])
row2 = CSV::Row.new(["header1",...

• CSV::Table

CSV::Row#delete_if {|header, field| ... } -> self (27949.0)

• 2.3.0

• インスタンスメソッド

与えられたブロックにヘッダとフィールドのペアを渡して評価します。 評価した結果が真である場合に、その組を自身から削除します。

与えられたブロックにヘッダとフィールドのペアを渡して評価します。
評価した結果が真である場合に、その組を自身から削除します。

@return メソッドチェーンのために自身を返します。

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

row = CSV::Row.new(["header1", "header2", "header3", "header4"], ["valid1", "valid2", "invalid", "valid4"])

row # => #<CSV::Row "header1":"valid1" "header2":"valid2" "hea...

• CSV::Row

CSV::Table#delete_if {|column_name, values| ... } -> self (27919.0)

• 2.3.0

• インスタンスメソッド

ブロックを評価した結果が真である行か列を削除します。

ブロックを評価した結果が真である行か列を削除します。

デフォルトのミックスモードかロウモードでは、行単位で繰り返します。カラ
ムモードでは、ブロックに列名と対応する値の配列を与え、列単位で繰り返し
ます。

//emlist[例 ロウモード][ruby]{
require "csv"

row1 = CSV::Row.new(["header1", "header2"], ["row1_1", "valid"])
row2 = CSV::Row.new(["header1", "header2"], ["row2_1", "invalid"])
row3 = CSV::Row.new(["...

• CSV::Table

CSV::Row#header?(name) -> bool (27787.0)

• 2.3.0

• インスタンスメソッド

自身のヘッダに与えられた値が含まれている場合は真を返します。 そうでない場合は偽を返します。

自身のヘッダに与えられた値が含まれている場合は真を返します。
そうでない場合は偽を返します。

@param name この行のヘッダに含まれているかどうか調べたい値を指定します。

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

row = CSV::Row.new(["header1", "header2"], [1, 2])
row.header?("header1") # => true
row.header?("header3") # => false
//}

• CSV::Row

CSV::Row#fields(*headers_and_or_indices) -> Array (27658.0)

• 2.3.0

• インスタンスメソッド

与えられた引数に対応する値の配列を返します。

与えられた引数に対応する値の配列を返します。

要素の探索に CSV::Row.field を使用しています。

@param headers_and_or_indices ヘッダの名前かインデックスか Range
のインスタンスか第 1 要素がヘッダの名前で
第 2 要素がオフセットになっている 2 要素
の配列をいくつでも指定します。混在するこ
とがで...

• CSV::Row
• Range

絞り込み条件を変える

CSV::Row#values_at(*headers_and_or_indices) -> Array (27658.0)

• 2.3.0

• インスタンスメソッド

与えられた引数に対応する値の配列を返します。

与えられた引数に対応する値の配列を返します。

要素の探索に CSV::Row.field を使用しています。

@param headers_and_or_indices ヘッダの名前かインデックスか Range
のインスタンスか第 1 要素がヘッダの名前で
第 2 要素がオフセットになっている 2 要素
の配列をいくつでも指定します。混在するこ
とがで...

• CSV::Row
• Range

CSV::Row#include?(name) -> bool (27487.0)

• 2.3.0

• インスタンスメソッド

自身のヘッダに与えられた値が含まれている場合は真を返します。 そうでない場合は偽を返します。

自身のヘッダに与えられた値が含まれている場合は真を返します。
そうでない場合は偽を返します。

@param name この行のヘッダに含まれているかどうか調べたい値を指定します。

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

row = CSV::Row.new(["header1", "header2"], [1, 2])
row.header?("header1") # => true
row.header?("header3") # => false
//}

• CSV::Row

CSV::Table#headers -> Array (27466.0)

• 2.3.0

• インスタンスメソッド

自身のヘッダ行を返します。

自身のヘッダ行を返します。

テーブルが空である場合は空の配列を返します。

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

row = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])
table = CSV::Table.new([row])
table.headers # => ["header1", "header2"]
//}

• CSV::Table

CSV::Row#field?(data) -> bool (27448.0)

• 2.3.0

• インスタンスメソッド

自身に与えられた値が含まれている場合は真を返します。 そうでない場合は偽を返します。

自身に与えられた値が含まれている場合は真を返します。
そうでない場合は偽を返します。

@param data この行に含まれているかどうか調べたい値を指定します。

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

row = CSV::Row.new(["header1", "header2", "header3", "header4"], [1, 2, 3, 4])
row.field?(1) # => true
row.field?(5) # => false
//}

• CSV::Row

CSV::Table#values_at(indices_or_headers) -> Array (19270.0)

• 2.3.0

• インスタンスメソッド

デフォルトのミックスモードでは、インデックスのリストを与えると行単位の 参照を行い、行の配列を返します。他の方法は列単位の参照と見なします。行 単位の参照では、返り値は行ごとの配列を要素に持つ配列です。

デフォルトのミックスモードでは、インデックスのリストを与えると行単位の
参照を行い、行の配列を返します。他の方法は列単位の参照と見なします。行
単位の参照では、返り値は行ごとの配列を要素に持つ配列です。

探索方法を変更したい場合は CSV::Table#by_col!,
CSV::Table#by_row! を使用してください。

アクセスモードを混在させることはできません。

//emlist[例 ロウモード][ruby]{
require "csv"

row1 = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])
r...

• CSV::Table

絞り込み条件を変える

CSV#header_convert {|field, field_info| ... } (19147.0)

• 2.3.0

• インスタンスメソッド

CSV#convert に似ていますが、ヘッダ行用のメソッドです。

CSV#convert に似ていますが、ヘッダ行用のメソッドです。

このメソッドはヘッダ行を読み込む前に呼び出さなければなりません。

@param name 変換器の名前を指定します。

//emlist[例 name を指定][ruby]{
require "csv"

csv = CSV.new("header1,header2\nrow1_1,row1_2", headers: true)
csv.header_convert(:symbol)
csv.first.headers # => [:header1, :header2]
//}

//emlist[例 ブロックを指定][...

• CSV

CSV::Row#field(header_or_index, minimum_index = 0) -> object | nil (18952.0)

• 2.3.0

• インスタンスメソッド

ヘッダの名前かインデックスで値を取得します。フィールドが見つからなかった場合は nil を返します。

ヘッダの名前かインデックスで値を取得します。フィールドが見つからなかった場合は nil を返します。

@param header_or_index ヘッダの名前かインデックスを指定します。

@param minimum_index このインデックスより後で、ヘッダの名前を探します。
重複しているヘッダがある場合に便利です。

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

row = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])

row.field("h...

• CSV::Row

CSV#return_headers? -> bool (18892.0)

• 2.3.0

• インスタンスメソッド

ヘッダを返す場合は、真を返します。 そうでない場合は、偽を返します。

ヘッダを返す場合は、真を返します。
そうでない場合は、偽を返します。

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

csv = CSV.new("header1,header2\nrow1_1,row1_2", headers: true, return_headers: false)
csv.return_headers? # => false
csv.shift # => #<CSV::Row "header1":"row1_1" "header2":"row1_2">

csv = CSV.new("header1,header2\nrow1_1,row1_2"...

• CSV

CSV#write_headers? -> bool (18874.0)

• 2.3.0

• インスタンスメソッド

ヘッダを出力先に書き込む場合は真を返します。 そうでない場合は偽を返します。

ヘッダを出力先に書き込む場合は真を返します。
そうでない場合は偽を返します。

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

csv = CSV.new("date1,date2\n2018-07-09,2018-07-10")
csv.write_headers? # => nil

header = ["header1", "header2"]
row = ["row1_1", "row1_2"]
result = CSV.generate(headers: header, write_headers: false) do |csv|
csv.write_hea...

• CSV

CSV#header_convert {|field| ... } (18847.0)

• 2.3.0

• インスタンスメソッド

CSV#convert に似ていますが、ヘッダ行用のメソッドです。

CSV#convert に似ていますが、ヘッダ行用のメソッドです。

このメソッドはヘッダ行を読み込む前に呼び出さなければなりません。

@param name 変換器の名前を指定します。

//emlist[例 name を指定][ruby]{
require "csv"

csv = CSV.new("header1,header2\nrow1_1,row1_2", headers: true)
csv.header_convert(:symbol)
csv.first.headers # => [:header1, :header2]
//}

//emlist[例 ブロックを指定][...

• CSV

絞り込み条件を変える

CSV#headers -> Array | true | nil (18748.0)

• 2.3.0

• インスタンスメソッド

nil を返した場合は、ヘッダは使用されません。 真を返した場合は、ヘッダを使用するが、まだ読み込まれていません。 配列を返した場合は、ヘッダは既に読み込まれています。

nil を返した場合は、ヘッダは使用されません。
真を返した場合は、ヘッダを使用するが、まだ読み込まれていません。
配列を返した場合は、ヘッダは既に読み込まれています。

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

csv = CSV.new("header1,header2\nrow1_1,row1_2")
csv.headers # => nil
csv = CSV.new("header1,header2\nrow1_1,row1_2", headers: true)
csv.headers # => true
csv.read
csv.headers # =>...

• CSV

CSV::Table#by_col -> CSV::Table (18628.0)

• 2.3.0

• インスタンスメソッド

カラムモードになっている新しい CSV::Table オブジェクトを返します。

カラムモードになっている新しい CSV::Table オブジェクトを返します。

元のテーブルモードを変更せずにメソッドチェーンできるので便利です。しか
し、大きなデータセットに対しても同じだけメモリを消費するので気をつけて
ください。

このメソッドは複製したテーブルを返すので、破壊的なメソッドはメソッド
チェーンに組込まないようにしてください。

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

row1 = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])
row2 = CSV::Row.new(["...

• CSV::Table

CSV::Table#by_col! -> self (18628.0)

• 2.3.0

• インスタンスメソッド

自身をカラムモードに変更します。

自身をカラムモードに変更します。

再びモードが変更されるまで、いくつかのメソッドはカラム単位で動きます。

@return 必ず自身を返すので安全にメソッドチェーンできます。

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

row1 = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])
row2 = CSV::Row.new(["header1", "header2"], ["row2_1", "row2_2"])
table = CSV::Table.new([row1, row2])
table....

• CSV::Table

CSV#skip_blanks? -> bool (18556.0)

• 2.3.0

• インスタンスメソッド

真である場合は、空行を読み飛ばします。

真である場合は、空行を読み飛ばします。

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

csv = CSV.new("header1,header2\n\nrow1_1,row1_2")
csv.skip_blanks? # => false
csv.read # => [["header1", "header2"], [], ["row1_1", "row1_2"]]
csv = CSV.new("header1,header2\n\nrow1_1,row1_2", skip_blanks: true)
csv.skip_blanks? # => tr...

• CSV

CSV#lineno -> Integer (18358.0)

• 2.3.0

• インスタンスメソッド

このファイルから読み込んだ最終行の行番号を返します。 フィールドに含まれる改行はこの値には影響しません。

このファイルから読み込んだ最終行の行番号を返します。
フィールドに含まれる改行はこの値には影響しません。

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

csv = CSV.new("header1,header2\nrow1_1,row1_2")
csv.lineno # => 0
csv.readline
csv.lineno # => 1
//}

• CSV

絞り込み条件を変える

CSV::Table#[](header) -> [String] | [nil] (10927.0)

• 2.3.0

• インスタンスメソッド

ミックスモードでは、このメソッドは引数に行番号を指定すれば行単位で動作 し、ヘッダの名前を指定すれば列単位で動作します。

ミックスモードでは、このメソッドは引数に行番号を指定すれば行単位で動作
し、ヘッダの名前を指定すれば列単位で動作します。

このメソッドを呼び出す前に CSV::Table#by_col! を呼び出すとカラム
モードになります。また CSV::Table#by_row! を呼び出すとロウモード
になります。

@param index ミックスモード・ロウモードでは、取得したい行の行番号を整数で指定します。
カラムモードでは、取得したい列の列番号を整数で指定します。
@param range 取得したい範囲を整数の範囲で指定します。
@param header 取得...

• CSV::Table

CSV::Table#[](index) -> CSV::Row | [String] | nil (10927.0)

• 2.3.0

• インスタンスメソッド

ミックスモードでは、このメソッドは引数に行番号を指定すれば行単位で動作 し、ヘッダの名前を指定すれば列単位で動作します。

ミックスモードでは、このメソッドは引数に行番号を指定すれば行単位で動作
し、ヘッダの名前を指定すれば列単位で動作します。

このメソッドを呼び出す前に CSV::Table#by_col! を呼び出すとカラム
モードになります。また CSV::Table#by_row! を呼び出すとロウモード
になります。

@param index ミックスモード・ロウモードでは、取得したい行の行番号を整数で指定します。
カラムモードでは、取得したい列の列番号を整数で指定します。
@param range 取得したい範囲を整数の範囲で指定します。
@param header 取得...

• CSV::Table

CSV::Table#[](range) -> [CSV::Row]| [Array] | nil (10927.0)

• 2.3.0

• インスタンスメソッド

ミックスモードでは、このメソッドは引数に行番号を指定すれば行単位で動作 し、ヘッダの名前を指定すれば列単位で動作します。

ミックスモードでは、このメソッドは引数に行番号を指定すれば行単位で動作
し、ヘッダの名前を指定すれば列単位で動作します。

このメソッドを呼び出す前に CSV::Table#by_col! を呼び出すとカラム
モードになります。また CSV::Table#by_row! を呼び出すとロウモード
になります。

@param index ミックスモード・ロウモードでは、取得したい行の行番号を整数で指定します。
カラムモードでは、取得したい列の列番号を整数で指定します。
@param range 取得したい範囲を整数の範囲で指定します。
@param header 取得...

• CSV::Table

CSV::Table#each {|column_name, values| ... } -> self (10813.0)

• 2.3.0

• インスタンスメソッド

デフォルトのミックスモードかロウモードでは、行単位で繰り返します。カラ ムモードでは、ブロックに列名と対応する値の配列を与え、列単位で繰り返し ます。

デフォルトのミックスモードかロウモードでは、行単位で繰り返します。カラ
ムモードでは、ブロックに列名と対応する値の配列を与え、列単位で繰り返し
ます。

//emlist[例 ロウモード][ruby]{
require "csv"

row1 = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])
row2 = CSV::Row.new(["header1", "header2"], ["row2_1", "row2_2"])
row3 = CSV::Row.new(["header1", "header2"], ["row3...

• CSV::Table

CSV::Table#each {|row| ... } -> self (10813.0)

• 2.3.0

• インスタンスメソッド

デフォルトのミックスモードかロウモードでは、行単位で繰り返します。カラ ムモードでは、ブロックに列名と対応する値の配列を与え、列単位で繰り返し ます。

デフォルトのミックスモードかロウモードでは、行単位で繰り返します。カラ
ムモードでは、ブロックに列名と対応する値の配列を与え、列単位で繰り返し
ます。

//emlist[例 ロウモード][ruby]{
require "csv"

row1 = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])
row2 = CSV::Row.new(["header1", "header2"], ["row2_1", "row2_2"])
row3 = CSV::Row.new(["header1", "header2"], ["row3...

• CSV::Table

絞り込み条件を変える

CSV::Row#[]=(header_or_index, value) (10552.0)

• 2.3.0

• インスタンスメソッド

ヘッダの名前かインデックスでフィールドを探し、値をセットします。

ヘッダの名前かインデックスでフィールドを探し、値をセットします。

末尾より後ろのインデックスを指定すると、ヘッダの名前は nil になります。
存在しないヘッダを指定すると、新しい要素を末尾に追加します。

@param header_or_index ヘッダの名前かインデックスを指定します。

@param value 値を指定します。

//emlist[例 ヘッダの名前で指定][ruby]{
require "csv"

row = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])

row["header1"] ...

• CSV::Row

CSV::Table#[]=(index_or_header, value) (10453.0)

• 2.3.0

• インスタンスメソッド

ミックスモードでは、このメソッドは引数に行番号を指定すれば行単位で動作 し、ヘッダの名前を指定すれば列単位で動作します。

ミックスモードでは、このメソッドは引数に行番号を指定すれば行単位で動作
し、ヘッダの名前を指定すれば列単位で動作します。

このメソッドを呼び出す前に CSV::Table#by_col! を呼び出すとカラム
モードになります。また CSV::Table#by_row! を呼び出すとロウモード
になります。

行には配列か CSV::Row のインスタンスを指定します。

列に値を一つだけ指定した場合は、全ての行にその値をコピーします。配列を
指定した場合は、上から順に値を割り当てます。余分な値は無視します。また、
値が不足している場合は nil を割り当てます。

既存の行または列のデータ...

• CSV::Row
• CSV::Table

CSV::Table#<<(row_or_array) -> self (10021.0)

• 2.3.0

• インスタンスメソッド

自身の最後に新しい行を追加します。

自身の最後に新しい行を追加します。

@param row_or_array CSV::Row のインスタンスか配列を指定します。
配列を指定した場合は CSV::Row に変換されます。

@return メソッドチェーンのために自身を返します。

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

row1 = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])
row2 = CSV::Row.new(["header1", "header2"], ["row2_1"...

• CSV::Row
• CSV::Table

CSV::Row#[](header_or_index, minimum_index = 0) -> object | nil (9952.0)

• 2.3.0

• インスタンスメソッド

ヘッダの名前かインデックスで値を取得します。フィールドが見つからなかった場合は nil を返します。

ヘッダの名前かインデックスで値を取得します。フィールドが見つからなかった場合は nil を返します。

@param header_or_index ヘッダの名前かインデックスを指定します。

@param minimum_index このインデックスより後で、ヘッダの名前を探します。
重複しているヘッダがある場合に便利です。

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

row = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])

row.field("h...

• CSV::Row

CSV::Table#==(other) -> bool (9898.0)

• 2.3.0

• インスタンスメソッド

自身の全ての行が比較対象と同じである場合は真を返します。 そうでない場合は偽を返します。

自身の全ての行が比較対象と同じである場合は真を返します。
そうでない場合は偽を返します。

@param other CSV::Table を指定します。

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

row1_1 = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])
row1_2 = CSV::Row.new(["header1", "header2"], ["row2_1", "row2_2"])
row2_1 = CSV::Row.new(["header1", "header2"], ["ro...

• CSV::Table

絞り込み条件を変える

CSV::Row#each {|header, field| ... } -> self (9841.0)

• 2.3.0

• インスタンスメソッド

与えられたブロックにヘッダとフィールドの組を渡して評価します。

与えられたブロックにヘッダとフィールドの組を渡して評価します。

@return メソッドチェーンのために自身を返します。

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

row = CSV::Row.new(["header1", "header2", "header3", "header4"], [1, 2, 3, 4])
row.each { |header, field| puts "#{header} - #{field}" }

# => header1 - 1
# => header2 - 2
# => header3 - 3
# => header4 -...

• CSV::Row

CSV#readline -> Array | CSV::Row (9823.0)

• 2.3.0

• インスタンスメソッド

String や IO をラップしたデータソースから一行だけ読み込んで フィールドの配列か CSV::Row のインスタンスを返します。

String や IO をラップしたデータソースから一行だけ読み込んで
フィールドの配列か CSV::Row のインスタンスを返します。

データソースは読み込み用にオープンされている必要があります。

@return ヘッダを使用しない場合は配列を返します。
ヘッダを使用する場合は CSV::Row を返します。

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

csv = CSV.new(DATA.read)
csv.readline # => ["header1", "header2"]
csv.readline # => ["row1_1", "r...

• CSV
• CSV::Row
• IO
• String

CSV::Row#[]=(header, offset, value) (9802.0)

• 2.3.0

• インスタンスメソッド

ヘッダの名前でフィールドを探し、値をセットします。

ヘッダの名前でフィールドを探し、値をセットします。

@param header ヘッダの名前を指定します。

@param offset このインデックスより後で、ヘッダの名前を探します。
重複しているヘッダがある場合に便利です。

@param value 値を指定します。

@see CSV::Row#field

• CSV::Row

CSV::Row#<<(arg) -> self (9772.0)

• 2.3.0

• インスタンスメソッド

自身に与えられたデータを追加します。

自身に与えられたデータを追加します。

@param arg 2 要素の配列か 1 要素のハッシュか任意のオブジェクトを指定します。
2 要素の配列を与えた場合は、ヘッダとフィールドのペアを追加します。
1 要素のハッシュを与えた場合は、キーをヘッダ、値をフィールドとして追加します。
それ以外の場合は、ヘッダを nil 、フィールドを与えられた値として追加します。

@return メソッドチェーンのために自身を返します。

//emlist[例 2要素の配列を指定][ruby]{
require "csv"

row = C...

• CSV::Row

CSV#readlines -> [Array] | CSV::Table (9664.0)

• 2.3.0

• インスタンスメソッド

残りの行を読み込んで配列の配列を返します。 self の生成時に headers オプションに偽でない値が指定されていた場合は CSV::Table オブジェクトを返します。

残りの行を読み込んで配列の配列を返します。
self の生成時に headers オプションに偽でない値が指定されていた場合は CSV::Table オブジェクトを返します。

データソースは読み込み用にオープンされている必要があります。

//emlist[例 headers: false][ruby]{
require "csv"

csv = CSV.new(DATA.read)
csv.read
# => [["header1", "header2"], ["row1_1", "row1_2"], ["row2_1", "row2_2"]]

__END__
header1,head...

• CSV
• CSV::Table

絞り込み条件を変える

CSV::Row#==(other) -> bool (9664.0)

• 2.3.0

• インスタンスメソッド

自身が other と同じヘッダやフィールドを持つ場合に真を返します。 そうでない場合は偽を返します。

自身が other と同じヘッダやフィールドを持つ場合に真を返します。
そうでない場合は偽を返します。

@param other 比較対象の CSV::Row のインスタンスを指定します。

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

row1 = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])
row2 = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])

row1 == row2 # => true
row2 << ["he...

• CSV::Row

CSV::Table#mode -> Symbol (9448.0)

• 2.3.0

• インスタンスメソッド

現在のアクセスモードを返します。

現在のアクセスモードを返します。

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

row = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])
table = CSV::Table.new([row])
table.mode # => :col_or_row
table.by_col!
table.mode # => :col
//}

• CSV::Table

CSV::Table#to_a -> [Array] (9364.0)

• 2.3.0

• インスタンスメソッド

配列の配列を返します。

配列の配列を返します。

一番目の要素はヘッダで、残りの要素はデータを表わします。

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

row1 = CSV::Row.new(["header1", "header2"], ["row1_1", "row1_2"])
row2 = CSV::Row.new(["header1", "header2"], ["row2_1", "row2_2"])
table = CSV::Table.new([row1, row2])
table.to_a # => [["header1", "header2"], ["row1_1", "...

• CSV::Table

CSV#each {|row| ... } -> nil (787.0)

• 2.3.0

• インスタンスメソッド

各行に対してブロックを評価します。

各行に対してブロックを評価します。

データソースは読み込み用にオープンされていなければなりません。

//emlist[例 CSV.new 時に :header => true を指定した場合][ruby]{
require "csv"

users = <<CSV
id,first name,last name,age
1,taro,tanaka,20
2,jiro,suzuki,18
3,ami,sato,19
4,yumi,adachi,21
CSV
csv = CSV.new(users, headers: true)
csv.each do |row|
p row
end

...

• CSV

CSV#convert {|field, field_info| ... } (676.0)

• 2.3.0

• インスタンスメソッド

引数 name で指定した変換器かブロックに各フィールドを渡して文字列から別 のオブジェクトへと変換します。

引数 name で指定した変換器かブロックに各フィールドを渡して文字列から別
のオブジェクトへと変換します。

引数 name を指定した場合は、組み込みの CSV::Converters を変換器
として利用するために使います。また、独自の変換器を追加することもできま
す。

ブロックパラメータを一つ受け取るブロックを与えた場合は、そのブロックは
フィールドを受け取ります。ブロックパラメータを二つ受け取るブロックを与
えた場合は、そのブロックは、フィールドと CSV::FieldInfo のインス
タンスを受け取ります。ブロックは変換後の値かフィールドそのものを返さな
ければなりません。
...

• CSV
• CSV::FieldInfo

絞り込み条件を変える

CSV#force_quotes? -> bool (664.0)

• 2.3.0

• インスタンスメソッド

出力される全てのフィールドがクオートされる場合は、真を返します。

出力される全てのフィールドがクオートされる場合は、真を返します。

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

rows = [["header1", "header2"], ["row1_1,", "row1_2"]]
result = CSV.generate(force_quotes: false) do |csv|
rows.each { |row| csv << row }
csv.force_quotes? # => false
end
print result

# => header1,header2
# "row1_1,",row1_2...

• CSV

CSV#read -> [Array] | CSV::Table (664.0)

• 2.3.0

• インスタンスメソッド

残りの行を読み込んで配列の配列を返します。 self の生成時に headers オプションに偽でない値が指定されていた場合は CSV::Table オブジェクトを返します。

残りの行を読み込んで配列の配列を返します。
self の生成時に headers オプションに偽でない値が指定されていた場合は CSV::Table オブジェクトを返します。

データソースは読み込み用にオープンされている必要があります。

//emlist[例 headers: false][ruby]{
require "csv"

csv = CSV.new(DATA.read)
csv.read
# => [["header1", "header2"], ["row1_1", "row1_2"], ["row2_1", "row2_2"]]

__END__
header1,head...

• CSV
• CSV::Table

CSV#convert {|field| ... } (376.0)

• 2.3.0

• インスタンスメソッド

引数 name で指定した変換器かブロックに各フィールドを渡して文字列から別 のオブジェクトへと変換します。

引数 name で指定した変換器かブロックに各フィールドを渡して文字列から別
のオブジェクトへと変換します。

引数 name を指定した場合は、組み込みの CSV::Converters を変換器
として利用するために使います。また、独自の変換器を追加することもできま
す。

ブロックパラメータを一つ受け取るブロックを与えた場合は、そのブロックは
フィールドを受け取ります。ブロックパラメータを二つ受け取るブロックを与
えた場合は、そのブロックは、フィールドと CSV::FieldInfo のインス
タンスを受け取ります。ブロックは変換後の値かフィールドそのものを返さな
ければなりません。
...

• CSV
• CSV::FieldInfo