【Ruby3.x】CSV::read()メソッドの使い方
readメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
readメソッドはCSVクラスに属し、CSV形式のデータを読み込むためのメソッドです。このメソッドは、指定されたファイルパス、IOオブジェクト、または文字列からCSVデータを解析し、Rubyで扱える形式に変換して返します。
主な用途としては、CSVファイルを一括で読み込み、その内容をプログラム内で操作する場合に利用されます。引数として、読み込みたいCSVデータのソース（ファイル名やCSV文字列など）を渡します。また、読み込み方法を細かく制御するためのオプションも多数用意されています。
例えば、headers: trueオプションを指定すると、CSVの1行目をヘッダ行として認識し、それ以降の行をデータとして扱います。この場合、戻り値は単なる配列の配列ではなく、ヘッダ情報を持つCSV::Tableオブジェクトとなります。これにより、列名（ヘッダ）を使ってデータにアクセスするといった、より直感的な操作が可能になります。
他にも、col_sepオプションで区切り文字（デフォルトはカンマ）を指定したり、encodingオプションでファイルの文字エンコーディングを指定したりできます。これにより、様々な形式のCSVデータに対応できます。
readメソッドは、データを配列の配列として、あるいはCSV::Tableオブジェクトとして一度にメモリに読み込むため、比較的規模の小さいCSVファイルを扱うのに適しています。シンプルにCSVデータを取得したい場合に非常に便利なメソッドです。
構文(syntax)
1require 'csv' 2 3csv_data = CSV.read('path/to/your_file.csv')
引数(parameters)
path, **options
- path: 読み込むCSVファイルのパス（文字列）
- options: 読み込み時のオプションをハッシュ形式で指定
戻り値(return)
Array<Array>
CSVファイルを読み込み、各行を配列とした配列を返します。