【Ruby3.x】CSV::Table::by_col_or_row()メソッドの使い方

by_col_or_rowメソッドは、CSV::Tableオブジェクトに格納されたデータに対して、カラム名または行番号を使って柔軟にアクセスするメソッドです。このメソッドは、引数として指定された値の型に応じて、動作を変える特性を持っています。

具体的には、引数 key に文字列やシンボルを指定した場合、その key をカラム名として解釈し、該当するカラムに含まれるすべてのデータを CSV::Column オブジェクトとして返します。これにより、特定の列の情報をまとめて取得し、操作することが可能になります。例えば、「商品名」といった特定の列の全データを取得したい場合に利用します。

一方、引数 key に整数を指定した場合、その key を行番号（0から始まるインデックス）として解釈し、該当する行に含まれるすべてのデータを CSV::Row オブジェクトとして返します。これにより、特定の行の情報をまとめて取得し、操作することが可能です。例えば、CSVファイルの先頭の行（インデックス0）のデータを取得したい場合に利用します。

指定されたカラム名や行番号に対応するデータが見つからない場合は、nil を返します。このメソッドを使うことで、CSVファイルを読み込んだ後に、目的のデータへ直感的かつ効率的にアクセスできるようになり、CSVデータの処理を非常にスムーズに行うことができます。

Copy
1require 'csv'
2
3csv_table = CSV::Table.new([
4  CSV::Row.new(["ID", "Name"], ["1", "Alice"]),
5  CSV::Row.new(["ID", "Name"], ["2", "Bob"])
6])
7
8csv_table.send(:by_col_or_row, "Name")

引数なし

引数はありません

CSV::Table

このメソッドは、行または列のいずれかの形式でデータを保持する新しいCSV::Tableオブジェクトを返します。