検索結果

csv (114517.0)

• 2.2.0

• ライブラリ

CSV (Comma Separated Values) を扱うライブラリです。

CSV (Comma Separated Values) を扱うライブラリです。


このバージョンの CSV ライブラリは FasterCSV から始まりました。
FasterCSV は Ruby1.8 に標準添付されている CSV ライブラリの置き換えとして開発されました。
このライブラリはユーザの関心事を解決するためにデザインされています。
主なゴールが三つあります。

(1) ピュア Ruby のままで元の CSV ライブラリよりもかなり速くすること
(2) 小さくメンテナンスしやすいコードベースであること (FasterCSV はかなり大きく
機能豊かになりました。構文...

• CSV
• CSV::FieldInfo
• CSV::MalformedCSVError
• CSV::Row
• CSV::Table
• parse_csv
• to_csv

CSV.open(filename, mode = "rb", options = Hash.new) -> CSV (52057.0)

• 2.2.0

• 特異メソッド

このメソッドは IO オブジェクトをオープンして CSV でラップします。 これは CSV ファイルを書くための主要なインターフェイスとして使うことを意図しています。

このメソッドは IO オブジェクトをオープンして CSV でラップします。
これは CSV ファイルを書くための主要なインターフェイスとして使うことを意図しています。

このメソッドは IO.open と同じように動きます。ブロックが与えられた場合は
ブロックに CSV オブジェクトを渡し、ブロック終了時にそれをクローズします。
ブロックが与えられなかった場合は CSV オブジェクトを返します。

データが Encoding.default_external と異なる場合は、mode にエンコー
ディングを指定する文字列を埋め込まなければなりません。データをどのよう
に解析するか決定するため...

• CSV
• File
• IO

CSV.open(filename, mode = "rb", options = Hash.new) {|csv| ... } -> nil (52057.0)

• 2.2.0

• 特異メソッド

このメソッドは IO オブジェクトをオープンして CSV でラップします。 これは CSV ファイルを書くための主要なインターフェイスとして使うことを意図しています。

このメソッドは IO オブジェクトをオープンして CSV でラップします。
これは CSV ファイルを書くための主要なインターフェイスとして使うことを意図しています。

このメソッドは IO.open と同じように動きます。ブロックが与えられた場合は
ブロックに CSV オブジェクトを渡し、ブロック終了時にそれをクローズします。
ブロックが与えられなかった場合は CSV オブジェクトを返します。

データが Encoding.default_external と異なる場合は、mode にエンコー
ディングを指定する文字列を埋め込まなければなりません。データをどのよう
に解析するか決定するため...

• CSV
• File
• IO

CSV.open(filename, options = Hash.new) -> CSV (52057.0)

• 2.2.0

• 特異メソッド

このメソッドは IO オブジェクトをオープンして CSV でラップします。 これは CSV ファイルを書くための主要なインターフェイスとして使うことを意図しています。

このメソッドは IO オブジェクトをオープンして CSV でラップします。
これは CSV ファイルを書くための主要なインターフェイスとして使うことを意図しています。

このメソッドは IO.open と同じように動きます。ブロックが与えられた場合は
ブロックに CSV オブジェクトを渡し、ブロック終了時にそれをクローズします。
ブロックが与えられなかった場合は CSV オブジェクトを返します。

データが Encoding.default_external と異なる場合は、mode にエンコー
ディングを指定する文字列を埋め込まなければなりません。データをどのよう
に解析するか決定するため...

• CSV
• File
• IO

CSV.open(filename, options = Hash.new) {|csv| ... } -> nil (52057.0)

• 2.2.0

• 特異メソッド

このメソッドは IO オブジェクトをオープンして CSV でラップします。 これは CSV ファイルを書くための主要なインターフェイスとして使うことを意図しています。

このメソッドは IO オブジェクトをオープンして CSV でラップします。
これは CSV ファイルを書くための主要なインターフェイスとして使うことを意図しています。

このメソッドは IO.open と同じように動きます。ブロックが与えられた場合は
ブロックに CSV オブジェクトを渡し、ブロック終了時にそれをクローズします。
ブロックが与えられなかった場合は CSV オブジェクトを返します。

データが Encoding.default_external と異なる場合は、mode にエンコー
ディングを指定する文字列を埋め込まなければなりません。データをどのよう
に解析するか決定するため...

• CSV
• File
• IO

絞り込み条件を変える

CSV.new(data, options = Hash.new) -> CSV (52000.0)

• 2.2.0

• 特異メソッド

このメソッドは CSV ファイルを読み込んだり、書き出したりするために String か IO のインスタンスをラップします。

このメソッドは CSV ファイルを読み込んだり、書き出したりするために
String か IO のインスタンスをラップします。

ラップされた文字列の先頭から読み込むことになります。
文字列に追記したい場合は CSV.generate を使用してください。
他の位置から処理したい場合はあらかじめそのように設定した StringIO を渡してください。

@param data String か IO のインスタンスを指定します。
String のインスタンスを指定した場合、CSV#string を使用して
後からデータを取り出すことが出来ます。...

• ARGF
• CSV
• CSV::Row
• CSV::Table
• IO
• String
• StringIO

CSV.read(path, options = Hash.new) -> [Array] | CSV::Table (51727.0)

• 2.2.0

• 特異メソッド

CSV ファイルを配列の配列にするために使います。 headers オプションに偽でない値を指定した場合は CSV::Table オブジェクトを返します。

CSV ファイルを配列の配列にするために使います。
headers オプションに偽でない値を指定した場合は CSV::Table オブジェクトを返します。

@param path CSV ファイルのパスを指定します。

@param options CSV.new のオプションと同じオプションを指定できます。
:encoding というキーを使用すると入力のエンコーディングを指定することができます。
入力のエンコーディングか Encoding.default_external と異なる場合は
必ず指定...

• CSV
• CSV::Table

CSV.readlines(path, options = Hash.new) -> [Array] | CSV::Table (51727.0)

• 2.2.0

• 特異メソッド

CSV ファイルを配列の配列にするために使います。 headers オプションに偽でない値を指定した場合は CSV::Table オブジェクトを返します。

CSV ファイルを配列の配列にするために使います。
headers オプションに偽でない値を指定した場合は CSV::Table オブジェクトを返します。

@param path CSV ファイルのパスを指定します。

@param options CSV.new のオプションと同じオプションを指定できます。
:encoding というキーを使用すると入力のエンコーディングを指定することができます。
入力のエンコーディングか Encoding.default_external と異なる場合は
必ず指定...

• CSV
• CSV::Table

CSV.instance(data = $stdout, options = Hash.new) -> CSV (51583.0)

• 2.2.0

• 特異メソッド

このメソッドは CSV.new のように CSV のインスタンスを返します。 しかし、返される値は Object#object_id と与えられたオプションを キーとしてキャッシュされます。

このメソッドは CSV.new のように CSV のインスタンスを返します。
しかし、返される値は Object#object_id と与えられたオプションを
キーとしてキャッシュされます。

ブロックが与えられた場合、生成されたインスタンスをブロックに渡して評価した
結果を返します。

@param data String か IO のインスタンスを指定します。

@param options CSV.new のオプションと同じオプションを指定できます。

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

options = { headers: true }

text...

• CSV
• IO
• String

CSV.instance(data = $stdout, options = Hash.new) {|csv| ... } -> object (51583.0)

• 2.2.0

• 特異メソッド

このメソッドは CSV.new のように CSV のインスタンスを返します。 しかし、返される値は Object#object_id と与えられたオプションを キーとしてキャッシュされます。

このメソッドは CSV.new のように CSV のインスタンスを返します。
しかし、返される値は Object#object_id と与えられたオプションを
キーとしてキャッシュされます。

ブロックが与えられた場合、生成されたインスタンスをブロックに渡して評価した
結果を返します。

@param data String か IO のインスタンスを指定します。

@param options CSV.new のオプションと同じオプションを指定できます。

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

options = { headers: true }

text...

• CSV
• IO
• String

絞り込み条件を変える

CSV.generate(str = "", options = Hash.new) {|csv| ... } -> String (51544.0)

• 2.2.0

• 特異メソッド

このメソッドは与えられた文字列をラップして CSV のオブジェクトとしてブロックに渡します。 ブロック内で CSV オブジェクトに行を追加することができます。 ブロックを評価した結果は文字列を返します。

このメソッドは与えられた文字列をラップして CSV のオブジェクトとしてブロックに渡します。
ブロック内で CSV オブジェクトに行を追加することができます。
ブロックを評価した結果は文字列を返します。

このメソッドに与えられた文字列は変更されるので、新しい文字列オブジェクトが必要な
場合は Object#dup で複製してください。

@param str 文字列を指定します。デフォルトは空文字列です。

@param options CSV.new のオプションと同じオプションを指定できます。
:encoding というキーを使用すると出力のエンコーディン...

• CSV

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

• 2.2.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#readlines -> [Array] | CSV::Table (51517.0)

• 2.2.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#gets -> Array | CSV::Row (51466.0)

• 2.2.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#readline -> Array | CSV::Row (51466.0)

• 2.2.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#shift -> Array | CSV::Row (51466.0)

• 2.2.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::Table#to_csv(options = Hash.new) -> String (51460.0)

• 2.2.0

• インスタンスメソッド

CSV の文字列に変換して返します。

CSV の文字列に変換して返します。

ヘッダを一行目に出力します。その後に残りのデータを出力します。

デフォルトでは、ヘッダを出力します。オプションに :write_headers =>
false を指定するとヘッダを出力しません。

//emlist[][ruby]{
require 'csv'
csv = CSV.new("a,b,c\n1,2,3", headers: true)
table = csv.read
p table.to_csv # => "a,b,c\n1,2,3\n"
p table.to_csv(write_head...

• CSV::Table

CSV::Row#to_csv -> String (51424.0)

• 2.2.0

• インスタンスメソッド

自身を CSV な文字列として返します。ヘッダは使用しません。

自身を CSV な文字列として返します。ヘッダは使用しません。

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

row = CSV::Row.new(["header1", "header2"], [1, 2])
row.to_csv # => "1,2\n"
row.to_csv( {col_sep: "|", row_sep: "<br>"} ) # => "1|2<br>"
//}

• CSV::Row

CSV#<<(row) -> self (51415.0)

• 2.2.0

• インスタンスメソッド

自身に row を追加します。

自身に row を追加します。

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

@param row 配列か CSV::Row のインスタンスを指定します。
CSV::Row のインスタンスが指定された場合は、CSV::Row#fields の値
のみが追加されます。

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

File.write("test.csv", <<CSV)
id,first name,last name,age
1,taro,tanaka,20
2,jiro,suzuki,18...

• CSV
• CSV::Row

CSV#add_row(row) -> self (51415.0)

• 2.2.0

• インスタンスメソッド

自身に row を追加します。

自身に row を追加します。

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

@param row 配列か CSV::Row のインスタンスを指定します。
CSV::Row のインスタンスが指定された場合は、CSV::Row#fields の値
のみが追加されます。

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

File.write("test.csv", <<CSV)
id,first name,last name,age
1,taro,tanaka,20
2,jiro,suzuki,18...

• CSV
• CSV::Row

絞り込み条件を変える

CSV#puts(row) -> self (51415.0)

• 2.2.0

• インスタンスメソッド

自身に row を追加します。

自身に row を追加します。

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

@param row 配列か CSV::Row のインスタンスを指定します。
CSV::Row のインスタンスが指定された場合は、CSV::Row#fields の値
のみが追加されます。

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

File.write("test.csv", <<CSV)
id,first name,last name,age
1,taro,tanaka,20
2,jiro,suzuki,18...

• CSV
• CSV::Row

CSV.table(path, options = Hash.new) -> CSV::Table | [Array] (51358.0)

• 2.2.0

• 特異メソッド

以下と同等のことを行うメソッドです。

以下と同等のことを行うメソッドです。

//emlist[][ruby]{
CSV.read( path, { headers: true,
converters: :numeric,
header_converters: :symbol }.merge(options) )
//}

@param path ファイル名を指定します。

@param options CSV.new のオプションと同じオプションを指定できます。


@see CSV.read

• CSV

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

• 2.2.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| ... } (51307.0)

• 2.2.0

• インスタンスメソッド

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

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

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

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

• CSV
• CSV::FieldInfo

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

• 2.2.0

• インスタンスメソッド

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

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

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

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

• CSV
• CSV::FieldInfo

絞り込み条件を変える

CSV#convert(name) (51307.0)

• 2.2.0

• インスタンスメソッド

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

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

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

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

• CSV
• CSV::FieldInfo

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

• 2.2.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#header_convert {|field| ... } (51265.0)

• 2.2.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#header_convert(name) (51265.0)

• 2.2.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.filter(input, options = Hash.new) {|row| ... } (51247.0)

• 2.2.0

• 特異メソッド

このメソッドは CSV データに対して Unix のツール群のようなフィルタを構築 するのに便利です。

このメソッドは CSV データに対して Unix のツール群のようなフィルタを構築
するのに便利です。

与えられたブロックに一行ずつ渡されます。ブロックに渡された行は必要であ
れば変更することができます。ブロックの評価後に行を全て output に書き込
みます。

@param input String か IO のインスタンスを指定します。
デフォルトは ARGF です。

@param output String か IO のインスタンスを指定します。
デフォルトは $stdout です。

@param options ":in...

• CSV
• IO
• String

絞り込み条件を変える

CSV.filter(input, output, options = Hash.new) {|row| ... } (51247.0)

• 2.2.0

• 特異メソッド

このメソッドは CSV データに対して Unix のツール群のようなフィルタを構築 するのに便利です。

このメソッドは CSV データに対して Unix のツール群のようなフィルタを構築
するのに便利です。

与えられたブロックに一行ずつ渡されます。ブロックに渡された行は必要であ
れば変更することができます。ブロックの評価後に行を全て output に書き込
みます。

@param input String か IO のインスタンスを指定します。
デフォルトは ARGF です。

@param output String か IO のインスタンスを指定します。
デフォルトは $stdout です。

@param options ":in...

• CSV
• IO
• String

CSV.filter(options = Hash.new) {|row| ... } (51247.0)

• 2.2.0

• 特異メソッド

このメソッドは CSV データに対して Unix のツール群のようなフィルタを構築 するのに便利です。

このメソッドは CSV データに対して Unix のツール群のようなフィルタを構築
するのに便利です。

与えられたブロックに一行ずつ渡されます。ブロックに渡された行は必要であ
れば変更することができます。ブロックの評価後に行を全て output に書き込
みます。

@param input String か IO のインスタンスを指定します。
デフォルトは ARGF です。

@param output String か IO のインスタンスを指定します。
デフォルトは $stdout です。

@param options ":in...

• CSV
• IO
• String

CSV#unconverted_fields? -> bool (51235.0)

• 2.2.0

• インスタンスメソッド

パースした結果が unconverted_fields というメソッドを持つ場合に真を返します。 そうでない場合は、偽を返します。

パースした結果が unconverted_fields というメソッドを持つ場合に真を返します。
そうでない場合は、偽を返します。


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

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

• CSV

CSV#write_headers? -> bool (51235.0)

• 2.2.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#return_headers? -> bool (51217.0)

• 2.2.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.generate_line(row, options = Hash.new) -> String (51217.0)

• 2.2.0

• 特異メソッド

このメソッドは一つの Array オブジェクトを CSV 文字列に変換するためのショートカットです。 複数行のCSVを扱う際はCSV#<<を使うとより高速です。

このメソッドは一つの Array オブジェクトを CSV 文字列に変換するためのショートカットです。
複数行のCSVを扱う際はCSV#<<を使うとより高速です。

このメソッドは可能であれば row に含まれる最初の nil でない値を用いて出力の
エンコーディングを推測します。

@param row 文字列の配列を指定します。

@param options CSV.new のオプションと同じオプションを指定できます。
:encoding というキーを使用すると出力のエンコーディングを指定することができます。
:row_sep ...

• Array
• CSV

CSV#field_size_limit -> Integer (51199.0)

• 2.2.0

• インスタンスメソッド

フィールドサイズの最大値を返します。

フィールドサイズの最大値を返します。

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

csv = CSV.new(DATA)
csv.field_size_limit # => nil
p csv.read # => [["a", "b"], ["\n2\n2\n", ""]]

DATA.rewind
csv = CSV.new(DATA, field_size_limit: 4)
p csv.field_size_limit # => 4
csv.read # => #<CSV::MalformedCSVError: Field size exceeded on l...

• CSV

CSV#force_quotes? -> bool (51199.0)

• 2.2.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#rewind -> 0 (51193.0)

• 2.2.0

• インスタンスメソッド

IO#rewind に似ています。CSV#lineno を 0 にします。

IO#rewind に似ています。CSV#lineno を 0 にします。

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

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

@see IO#rewind

• CSV

CSV#col_sep -> String (51181.0)

• 2.2.0

• インスタンスメソッド

カラム区切り文字列として使用する文字列を返します。

カラム区切り文字列として使用する文字列を返します。

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

users =<<-EOS
id|first name|last name|age
1|taro|tanaka|20
2|jiro|suzuki|18
3|ami|sato|19
4|yumi|adachi|21
EOS

csv = CSV.new(users, headers: true, col_sep: "|")
csv.col_sep # => "|"
csv.first.to_a # => [["id", "1"], ["first name", "taro"...

• CSV

絞り込み条件を変える

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

• 2.2.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#skip_blanks? -> bool (51181.0)

• 2.2.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.foreach(path, options = Hash.new) {|row| ... } -> nil (51175.0)

• 2.2.0

• 特異メソッド

このメソッドは CSV ファイルを読むための主要なインターフェイスです。 各行が与えられたブロックに渡されます。

このメソッドは CSV ファイルを読むための主要なインターフェイスです。
各行が与えられたブロックに渡されます。

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

# UTF-32BE な CSV ファイルを読み込んで UTF-8 な row をブロックに渡します
CSV.foreach("a.csv", encoding: "UTF-32BE:UTF-8"){|row| p row }
//}

@param path CSV ファイルのパスを指定します。

@param options CSV.new のオプションと同じオプションを指定できます。
...

• CSV

CSV.parse(str, options = Hash.new) -> Array (51145.0)

• 2.2.0

• 特異メソッド

このメソッドは文字列を簡単にパースすることができます。 ブロックを与えた場合は、ブロックにそれぞれの行を渡します。 ブロックを省略した場合は、配列の配列を返します。

このメソッドは文字列を簡単にパースすることができます。
ブロックを与えた場合は、ブロックにそれぞれの行を渡します。
ブロックを省略した場合は、配列の配列を返します。

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

@param options CSV.new のオプションと同じオプションを指定できます。

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

s = <<EOS
id,first name,last name,age
1,taro,tanaka,20
2,jiro,suzuki,18
EOS

pp CSV.parse(s)
# => ...

• CSV

CSV.parse(str, options = Hash.new) {|row| ... } -> nil (51145.0)

• 2.2.0

• 特異メソッド

このメソッドは文字列を簡単にパースすることができます。 ブロックを与えた場合は、ブロックにそれぞれの行を渡します。 ブロックを省略した場合は、配列の配列を返します。

このメソッドは文字列を簡単にパースすることができます。
ブロックを与えた場合は、ブロックにそれぞれの行を渡します。
ブロックを省略した場合は、配列の配列を返します。

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

@param options CSV.new のオプションと同じオプションを指定できます。

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

s = <<EOS
id,first name,last name,age
1,taro,tanaka,20
2,jiro,suzuki,18
EOS

pp CSV.parse(s)
# => ...

• CSV

絞り込み条件を変える

CSV.parse_line(line, options = Hash.new) -> Array (51139.0)

• 2.2.0

• 特異メソッド

このメソッドは一行の CSV 文字列を配列に変換するためのショートカットです。

このメソッドは一行の CSV 文字列を配列に変換するためのショートカットです。

@param line 文字列を指定します。複数行の文字列を指定した場合は、一行目以外は無視します。

@param options CSV.new のオプションと同じオプションを指定できます。

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

p CSV.parse_line("1,taro,tanaka,20")
# => ["1", "taro", "tanaka", "20"]

p CSV.parse_line("1|taro|tanaka|20", col_sep: '|')
#...

• CSV

CSV#header_converters -> Array (51127.0)

• 2.2.0

• インスタンスメソッド

現在有効なヘッダ用変換器のリストを返します。

現在有効なヘッダ用変換器のリストを返します。

組込みの変換器は名前を返します。それ以外は、オブジェクトを返します。

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

csv = CSV.new("HEADER1,HEADER2\nrow1_1,row1_2", headers: true, header_converters: CSV::HeaderConverters.keys)
csv.header_converters # => [:downcase, :symbol]
csv.read.to_a # => header2], ["row1_1",...

• CSV

CSV#converters -> Array (51109.0)

• 2.2.0

• インスタンスメソッド

現在の変換器のリストを返します。

現在の変換器のリストを返します。

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

csv = CSV.new("header1,header2\nrow1_1,row1_2", converters: CSV::Converters.keys)
csv.converters # => [:integer, :float, :integer, :float, :date, :date_time, :date_time, :integer, :float]
//}

@see CSV::Converters

• CSV

CSV#header_row? -> bool (51109.0)

• 2.2.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#lineno -> Integer (51109.0)

• 2.2.0

• インスタンスメソッド

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

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

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

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

• CSV

絞り込み条件を変える

CSV#row_sep -> String (51109.0)

• 2.2.0

• インスタンスメソッド

行区切り文字列として使用する文字列を返します。

行区切り文字列として使用する文字列を返します。

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

csv = CSV.new("header1,header2|row1_1,row1_2", row_sep: "|")
csv.row_sep # => "|"
csv.read # => [["header1", "header2"], ["row1_1", "row1_2"]]
//}

@see CSV.new

• CSV

CSV#inspect -> String (51091.0)

• 2.2.0

• インスタンスメソッド

ASCII 互換文字列で自身の情報を表したものを返します。

ASCII 互換文字列で自身の情報を表したものを返します。

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

csv = CSV.new("header1,header2\nrow1_1,row1_2")
csv.inspect # => "<#CSV io_type:StringIO encoding:UTF-8 lineno:0 col_sep:\",\" row_sep:\"\\n\" quote_char:\"\\\"\">"
//}

• CSV

CSV#quote_char -> String (51091.0)

• 2.2.0

• インスタンスメソッド

フィールドをクオートするのに使用する文字列を返します。

フィールドをクオートするのに使用する文字列を返します。

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

csv = CSV.new("header1,header2\nrow1_1,row1_2", quote_char: "'")
csv.quote_char # => "'"
//}

@see CSV.new

• CSV

CSV#encoding -> Encoding (51073.0)

• 2.2.0

• インスタンスメソッド

読み書きするときに使用するエンコーディングを返します。

読み書きするときに使用するエンコーディングを返します。

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

csv = CSV.new("header1,header2\nrow1_1,row1_2", headers: true)
csv.encoding # => #<Encoding:UTF-8>
//}

• CSV

CSV::MalformedCSVError (51049.0)

• 2.2.0

• クラス

不正な CSV をパースしようとしたときに発生する例外です。

不正な CSV をパースしようとしたときに発生する例外です。

絞り込み条件を変える

CSV::Converters -> Hash (51037.0)

• 2.2.0

• 定数

このハッシュは名前でアクセスできる組み込みの変換器を保持しています。

このハッシュは名前でアクセスできる組み込みの変換器を保持しています。

CSV#convert で使用する変換器として使用できます。
また CSV.new のオプションとして使用することもできます。

: :integer
Kernel.#Integer を使用してフィールドを変換します。
: :float
Kernel.#Float を使用してフィールドを変換します。
: :numeric
:integer と :float の組み合わせです。
: :date
Date.parse を使用してフィールドを変換します。
: :date_time
DateTime.pars...

• CSV

CSV::HeaderConverters -> Hash (51037.0)

• 2.2.0

• 定数

このハッシュは名前でアクセスできる組み込みのヘッダ用変換器を保存しています。

このハッシュは名前でアクセスできる組み込みのヘッダ用変換器を保存しています。

CSV#header_convert で使用する変換器として使用できます。
また CSV.new のオプションとして使用することもできます。

: :downcase
ヘッダの文字列に対して String#downcase を呼び出します。
: :symbol
ヘッダの文字列を小文字に変換してから、空白文字列 (\s) をアンダースコアに
置換し、非英数字 (\W) を削除します。最後に String#to_sym を呼び出します。

全ての組み込みのヘッダ用変換器は、実際に変換する前にヘッダのデータ...

• CSV

CSV#binmode -> self (51001.0)

• 2.2.0

• インスタンスメソッド

IO#binmode に委譲します。

IO#binmode に委譲します。


@see IO#binmode

• CSV

CSV#binmode? -> bool (51001.0)

• 2.2.0

• インスタンスメソッド

IO#binmode? に委譲します。

IO#binmode? に委譲します。


@see IO#binmode?

• CSV

CSV#close -> nil (51001.0)

• 2.2.0

• インスタンスメソッド

IO#close に委譲します。

IO#close に委譲します。


@see IO#close

• CSV

絞り込み条件を変える

CSV#close_read -> nil (51001.0)

• 2.2.0

• インスタンスメソッド

IO#close_read に委譲します。

IO#close_read に委譲します。


@see IO#close_read

• CSV

CSV#close_write -> nil (51001.0)

• 2.2.0

• インスタンスメソッド

IO#close_write に委譲します。

IO#close_write に委譲します。


@see IO#close_write

• CSV

CSV#closed? -> bool (51001.0)

• 2.2.0

• インスタンスメソッド

IO#closed? に委譲します。

IO#closed? に委譲します。


@see IO#closed?

• CSV

CSV#eof -> bool (51001.0)

• 2.2.0

• インスタンスメソッド

IO#eof, IO#eof? に委譲します。

IO#eof, IO#eof? に委譲します。


@see IO#eof, IO#eof?

• CSV

CSV#eof? -> bool (51001.0)

• 2.2.0

• インスタンスメソッド

IO#eof, IO#eof? に委譲します。

IO#eof, IO#eof? に委譲します。


@see IO#eof, IO#eof?

• CSV

絞り込み条件を変える

CSV#external_encoding -> Encoding | nil (51001.0)

• 2.2.0

• インスタンスメソッド

IO#external_encoding に委譲します。

IO#external_encoding に委譲します。

• CSV

CSV#fcntl(cmd, arg = 0) -> Integer (51001.0)

• 2.2.0

• インスタンスメソッド

IO#fcntl に委譲します。

IO#fcntl に委譲します。

• CSV

CSV#fileno -> Integer (51001.0)

• 2.2.0

• インスタンスメソッド

IO#fileno, IO#to_i に委譲します。

IO#fileno, IO#to_i に委譲します。

• CSV

CSV#flock(operation) -> 0 | false (51001.0)

• 2.2.0

• インスタンスメソッド

File#flock に委譲します。

File#flock に委譲します。

• CSV

CSV#flush -> self (51001.0)

• 2.2.0

• インスタンスメソッド

IO#flush に委譲します。

IO#flush に委譲します。

• CSV

絞り込み条件を変える

CSV#fsync -> 0 | nil (51001.0)

• 2.2.0

• インスタンスメソッド

IO#fsync に委譲します。

IO#fsync に委譲します。

• CSV

CSV#internal_encoding -> Encoding | nil (51001.0)

• 2.2.0

• インスタンスメソッド

IO#internal_encoding に委譲します。

IO#internal_encoding に委譲します。


@see IO#internal_encoding

• CSV

CSV#ioctl(cmd, arg = 0) -> Integer (51001.0)

• 2.2.0

• インスタンスメソッド

IO#ioctl に委譲します。

IO#ioctl に委譲します。


@see IO#ioctl

• CSV

CSV#isatty -> bool (51001.0)

• 2.2.0

• インスタンスメソッド

IO#isatty, IO#tty? に委譲します。

IO#isatty, IO#tty? に委譲します。


@see IO#isatty, IO#tty?

• CSV

CSV#path -> String (51001.0)

• 2.2.0

• インスタンスメソッド

IO#path に委譲します。

IO#path に委譲します。


@see IO#path

• CSV

絞り込み条件を変える

CSV#pid -> Integer | nil (51001.0)

• 2.2.0

• インスタンスメソッド

IO#pid に委譲します。

IO#pid に委譲します。


@see IO#pid

• CSV

CSV#pos -> Integer (51001.0)

• 2.2.0

• インスタンスメソッド

IO#pos, IO#tell に委譲します。

IO#pos, IO#tell に委譲します。


@see IO#pos, IO#tell

• CSV

CSV#pos=(n) (51001.0)

• 2.2.0

• インスタンスメソッド

IO#pos= に委譲します。

IO#pos= に委譲します。


@see IO#pos=

• CSV

CSV#reopen(io) -> self (51001.0)

• 2.2.0

• インスタンスメソッド

IO#reopen に委譲します。

IO#reopen に委譲します。


@see IO#reopen

• CSV

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

• 2.2.0

• インスタンスメソッド

IO#seek に委譲します。

IO#seek に委譲します。


@see IO#seek

• CSV

絞り込み条件を変える

CSV#stat -> File::Stat (51001.0)

• 2.2.0

• インスタンスメソッド

IO#stat に委譲します。

IO#stat に委譲します。


@see IO#stat

• CSV

CSV#string -> String (51001.0)

• 2.2.0

• インスタンスメソッド

StringIO#string に委譲します。

StringIO#string に委譲します。


@see StringIO#string

• CSV

CSV#sync -> bool (51001.0)

• 2.2.0

• インスタンスメソッド

IO#sync に委譲します。

IO#sync に委譲します。


@see IO#sync

• CSV

CSV#sync=(newstate) (51001.0)

• 2.2.0

• インスタンスメソッド

IO#sync= に委譲します。

IO#sync= に委譲します。


@see IO#sync=

• CSV

CSV#tell -> Integer (51001.0)

• 2.2.0

• インスタンスメソッド

IO#pos, IO#tell に委譲します。

IO#pos, IO#tell に委譲します。


@see IO#pos, IO#tell

• CSV

絞り込み条件を変える

CSV#to_i -> Integer (51001.0)

• 2.2.0

• インスタンスメソッド

IO#fileno, IO#to_i に委譲します。

IO#fileno, IO#to_i に委譲します。

• CSV

CSV#to_io -> self (51001.0)

• 2.2.0

• インスタンスメソッド

IO#to_io に委譲します。

IO#to_io に委譲します。


@see IO#to_io

• CSV

CSV#truncate(path, length) -> 0 (51001.0)

• 2.2.0

• インスタンスメソッド

File#truncate に委譲します。

File#truncate に委譲します。


@see File#truncate

• CSV

CSV#tty? -> bool (51001.0)

• 2.2.0

• インスタンスメソッド

IO#isatty, IO#tty? に委譲します。

IO#isatty, IO#tty? に委譲します。


@see IO#isatty, IO#tty?

• CSV

CSV::ConverterEncoding -> Encoding (51001.0)

• 2.2.0

• 定数

すべての変換器で使用するエンコーディングです。

すべての変換器で使用するエンコーディングです。

• CSV

絞り込み条件を変える

CSV::DEFAULT_OPTIONS -> Hash (51001.0)

• 2.2.0

• 定数

このオプションは呼び出し側で上書きしなかったときに使用するオプションです。

このオプションは呼び出し側で上書きしなかったときに使用するオプションです。

: :col_sep
","
: :row_sep
:auto
: :quote_char
'"'
: :field_size_limit
nil
: :converters
nil
: :unconverted_fields
nil
: :headers
false
: :return_headers
false
: :header_converters
nil
: :skip_blanks
false
: :force_quotes
false
: :skip_lin...

• CSV

CSV::DateMatcher -> Regexp (51001.0)

• 2.2.0

• 定数

日付 (Date) 形式のデータを発見したり変換したりするための正規表現です。

日付 (Date) 形式のデータを発見したり変換したりするための正規表現です。

• CSV

CSV::DateTimeMatcher -> Regexp (51001.0)

• 2.2.0

• 定数

日時 (DateTime) 形式のデータを発見したり変換したりするための正規表現です。

日時 (DateTime) 形式のデータを発見したり変換したりするための正規表現です。

• CSV

CSV::VERSION -> String (51001.0)

• 2.2.0

• 定数

ライブラリのバージョンを表す文字列です。

ライブラリのバージョンを表す文字列です。

• CSV

CSV (43165.0)

• 2.2.0

• クラス

このクラスは CSV ファイルやデータに対する完全なインターフェイスを提供します。

このクラスは CSV ファイルやデータに対する完全なインターフェイスを提供します。

=== 読み込み

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

csv_text = <<~CSV_TEXT
Ruby,1995
Rust,2010
CSV_TEXT

IO.write "sample.csv", csv_text

# ファイルから一行ずつ
CSV.foreach("sample.csv") do |row|
p row
end
# => ["Ruby", "1995"]
# ["Rust", "2010"]

# ファイルから一度に
p CSV.r...

絞り込み条件を変える

String#parse_csv(**options) -> [String] (42550.0)

• 2.2.0

• インスタンスメソッド

CSV.parse_line(self, options) と同様です。

CSV.parse_line(self, options) と同様です。

1 行の CSV 文字列を、文字列の配列に変換するためのショートカットです。

@param options CSV.new と同様のオプションを指定します。

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

p "Matz,Ruby\n".parse_csv # => ["Matz", "Ruby"]
p "Matz|Ruby\r\n".parse_csv(col_sep: '|', row_sep: "\r\n") # => ...

• CSV.parse_line
• String

Array#to_csv(**options) -> String (42460.0)

• 2.2.0

• インスタンスメソッド

CSV.generate_line(self, options) と同様です。

CSV.generate_line(self, options) と同様です。

Array オブジェクトを 1 行の CSV 文字列に変換するためのショートカットです。

@param options CSV.generate_line と同様のオプションを指定します。

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

p [1, 'Matz', :Ruby, Date.new(1965, 4, 14)].to_csv # => "1,Matz,Ruby,1965-04-14\n"
p [1, 'Matz',...

• Array

CSV::Table#to_s(options = Hash.new) -> String (42160.0)

• 2.2.0

• インスタンスメソッド

CSV の文字列に変換して返します。

CSV の文字列に変換して返します。

ヘッダを一行目に出力します。その後に残りのデータを出力します。

デフォルトでは、ヘッダを出力します。オプションに :write_headers =>
false を指定するとヘッダを出力しません。

//emlist[][ruby]{
require 'csv'
csv = CSV.new("a,b,c\n1,2,3", headers: true)
table = csv.read
p table.to_csv # => "a,b,c\n1,2,3\n"
p table.to_csv(write_head...

• CSV::Table

CSV::Row#to_s -> String (42124.0)

• 2.2.0

• インスタンスメソッド

自身を CSV な文字列として返します。ヘッダは使用しません。

自身を CSV な文字列として返します。ヘッダは使用しません。

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

row = CSV::Row.new(["header1", "header2"], [1, 2])
row.to_csv # => "1,2\n"
row.to_csv( {col_sep: "|", row_sep: "<br>"} ) # => "1|2<br>"
//}

• CSV::Row

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

• 2.2.0

• インスタンスメソッド

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

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

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

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

• CSV::Table

絞り込み条件を変える