【Ruby3.x】CSV::<<()メソッドの使い方
<<メソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
<<メソッドは、CSVオブジェクトに行を追加するメソッドです。
このメソッドは、RubyのCSVクラスのインスタンスが表すCSVファイルやデータストリームに対し、新しいデータの行を書き込むために使用されます。既存のCSVデータに情報を追加したり、プログラム上で新しいCSVデータを生成したりする際に利用します。
引数として、追加したいCSVの1行を構成する要素を渡します。例えば、csv_object << ["値1", "値2"] のように配列を渡すと、配列の各要素がCSVの1つの行の各カラムとして順に書き込まれます。また、csv_object << "値1", "値2" のように複数の引数をカンマで区切って直接渡すこともでき、この場合もそれぞれの引数が1つのCSV行のカラムとなります。
渡されたデータは、CSVライブラリによって自動的に適切なCSV形式の文字列に変換され、必要に応じてカンマや引用符を含む値が適切にエスケープ処理されます。これにより、開発者はCSVの書式に関する細かなルールを意識することなく、シンプルにデータを追加できます。
メソッドの実行後には、行が追加されたCSVオブジェクト自身が返されるため、連続して複数の行を追加するような操作も簡潔に記述できるため、非常に便利です。
構文(syntax)
1require 'csv' 2 3CSV.generate do |csv| 4 csv << ["data1", "data2", "data3"] 5end
引数(parameters)
row
- row: CSVの1行を表す配列
戻り値(return)
self
CSVオブジェクト自体を返します。これにより、メソッドチェーンで複数のCSV操作を連続して実行できるようになります。