【Ruby3.x】CSV::Writer::<<()メソッドの使い方
<<メソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
<<メソッドはCSVファイルへ行データを追記するメソッドです。Rubyの標準ライブラリであるCSV::Writerクラスに属しており、CSV形式のデータを外部のストリームやファイルに書き出す際に利用されます。
このメソッドの主な機能は、与えられたデータをCSVの新しい一行として出力ストリームに書き込むことです。引数には、配列、文字列、またはその他のオブジェクトを指定できます。
引数が配列の場合、配列の各要素がCSVの各カラムとして扱われ、設定された区切り文字（デフォルトはカンマ）で結合されて1行のデータとして出力されます。これにより、複数のデータをまとめてCSVの1行として書き出すことが容易になります。
引数が文字列の場合、その文字列全体が1行としてそのまま出力されます。この際、文字列内に改行コードが含まれている場合は、それもそのまま反映されます。
その他のオブジェクトが渡された場合は、そのオブジェクトのto_sメソッドが呼び出され、文字列に変換された後、1行として書き込まれます。
<<メソッドは、自身であるCSV::Writerオブジェクトを返します。この特性により、メソッドチェーンを使用して連続的に複数の行を書き込むことが可能となり、コードの簡潔さを保ちながら効率的なデータ書き込みを実現できます。CSVファイルへプログラムからデータを簡単に出力したい場合に非常に便利な機能です。
構文(syntax)
1writer << ["value1", "value2", "value3"]
引数(parameters)
row
- row: CSVとして書き込む行を表す配列、またはCSV::Rowオブジェクト
戻り値(return)
CSV
CSV::Writerクラスの<<メソッドは、自身（CSV::Writerオブジェクト）を返します。これにより、メソッドチェーンでの連続した操作が可能になります。