【Ruby3.x】CSV::FieldInfo::new()メソッドの使い方
newメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
newメソッドは、CSVファイルの各フィールド（個々のデータ項目）に関する詳細なメタ情報を管理するCSV::FieldInfoクラスの新しいインスタンスを生成するメソッドです。
CSV::FieldInfoクラスは、CSVデータから読み込まれた特定のフィールドが元のファイル上のどこに位置していたか（例えば、何行目の何列目か）や、対応するヘッダ行の項目名が何であったかといった情報を保持します。これにより、単なるデータ値だけでなく、そのデータが持つ文脈情報を把握できるようになります。
通常、このnewメソッドをプログラマが直接呼び出すことはほとんどありません。Rubyの標準ライブラリであるCSVパーサーがCSVファイルを読み込む際に、内部で各フィールドの情報を自動的に抽出し、その情報をもとにCSV::FieldInfoオブジェクトを生成します。
生成されたCSV::FieldInfoオブジェクトは、CSV::TableクラスやCSV::Rowクラスのメソッド（例えば、field_infoメソッドなど）を通じて提供されます。プログラマはこの提供されたオブジェクトを利用することで、CSVデータの内容だけでなく、そのデータが元のファイル内で持つ詳細な情報も取得し、例えばCSVファイルの検証や、より複雑なデータ処理を行う際に役立てることができます。
このように、newメソッドはCSV::FieldInfoオブジェクトの生命サイクルを管理する重要な役割を担いますが、その利用は主にCSVライブラリの内部実装によって行われることを理解しておくことが重要です。
構文(syntax)
1CSV::FieldInfo.new(0, "column_name", 1, ["header1", "header2"])
引数(parameters)
value, row, col, header_line = nil, field_index = nil
- value: フィールドの値
- row: フィールドが含まれる行のインデックス (0から始まる整数)
- col: フィールドが含まれる列のインデックス (0から始まる整数)
- header_line = nil: ヘッダー行のインデックス (省略可能)
- field_index = nil: フィールドのインデックス (省略可能)
戻り値(return)
CSV::FieldInfo
CSV::FieldInfoオブジェクトを新しく生成して返します。このオブジェクトは、CSVデータのフィールドに関する情報（型など）を保持します。