【Ruby3.x】CSV::Row::<<()メソッドの使い方
<<メソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
<<メソッドはCSVの行に新しいデータを追加するメソッドです。
RubyのCSV::Rowクラスは、CSVファイルにおける1行分のデータを表現するためのクラスです。この行は、列名(ヘッダ)とその値のペアとして、あるいは単に値の配列として扱うことができます。
この<<メソッドは、既存のCSV::Rowオブジェクトの末尾に新しい要素(データ)を追記する目的で使用されます。具体的には、以下のいずれかの形式でデータを追加できます。
- 単一の値: 文字列や数値など、任意のオブジェクトを1つの列の値として行の末尾に追加します。この場合、新しく追加された列に対応するヘッダは
nilとなります。 - キーと値のペア:
[キー, 値]の形式で配列を渡すことで、指定されたキー(列名)と値のセットを新しい列として行の末尾に追加します。このメソッドでは、既存のキーに対する値の更新は行われず、常に新しい列が末尾に追加されます。
このメソッドを使うことで、CSVの1行データに対して、新しい項目を柔軟に追記し、行の構造を拡張することが可能になります。既存のデータに影響を与えることなく、新しい列を末尾に追加する際に便利です。メソッドの呼び出し後には、変更が適用されたCSV::Rowオブジェクト自身が返されます。
構文(syntax)
1require 'csv' 2 3row = CSV::Row.new(["column_a"], ["value_a"]) 4row << "new_value"
引数(parameters)
value
- value: CSVの1行に追加する値
戻り値(return)
CSV::Row
CSV::Row オブジェクトに新しい要素を追加した結果として、自身と同じ CSV::Row オブジェクトを返します。