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

unconverted_fields?メソッドは、CSVファイルから読み込んだデータが、期待通りの型に自動的に変換されなかったフィールド（項目）が存在するかどうかを確認するメソッドです。RubyのCSVライブラリでは、CSV.parseなどのメソッドでCSVデータを読み込む際に、「コンバータ」と呼ばれる設定をオプションとして指定することができます。このコンバータは、例えばCSV内の「123」のような数字の文字列をRubyの数値型Integerに、あるいは「2023-01-01」のような日付文字列をDate型に、といった具合に、特定の列の値を自動的に変換する役割を担っています。

unconverted_fields?メソッドは、CSVデータが行ごとに処理され、コンバータによる自動変換が試行された後に、まだ本来変換されるべきであったにもかかわらず、何らかの理由で元の文字列のまま残ってしまったフィールド（例えば、「abc」という文字列を数値型に変換しようとした場合など）があるかどうかをチェックします。もし、そのような変換されなかったフィールドが一つでも存在すればtrue（真）を返します。一方で、すべてのフィールドがコンバータによって正しく変換されたか、あるいはそもそもコンバータが指定されていなかった場合にはfalse（偽）を返します。このメソッドを利用することで、CSVから読み込んだデータが意図通りに型変換されているかを簡単に確認でき、データの整合性チェックやエラー処理の実装に役立ちます。

Copy
1require 'csv'
2
3# CSV::Rowオブジェクトのインスタンスに対して呼び出します。
4row = CSV::Row.new(["header1", "header2"], ["value1", "value2"])
5result = row.unconverted_fields?

引数なし

引数はありません

true or false

CSVオブジェクトに未変換のフィールドが存在するかどうかを真偽値で返します。