Ruby CSV.convert用法及代碼示例

convert(converter_name) → array_of_procs

convert {|field, field_info| ... } → array_of_procs

• 沒有塊，安裝一個現場轉換器(Proc)。

• 使用塊，定義並安裝自定義字段轉換器。

• 返回已安裝字段轉換器的數組。

• 參數 converter_name 如果給定，應該是現有字段轉換器的名稱。

請參閱現場轉換器。

沒有塊，安裝一個現場轉換器：

csv = CSV.new('')
csv.convert(:integer)
csv.convert(:float)
csv.convert(:date)
csv.converters # => [:integer, :float, :date]

如果給定，則為每個字段調用該塊：

• 參數field 是字段值。

• 參數 field_info 是一個 CSV::FieldInfo 對象，其中包含有關該字段的詳細信息。

此處的示例假定事先執行：

string = "foo,0\nbar,1\nbaz,2\n"
path = 't.csv'
File.write(path, string)

給出塊的示例：

csv = CSV.open(path)
csv.convert {|field, field_info| p [field, field_info]; field.upcase }
csv.read # => [["FOO", "0"], ["BAR", "1"], ["BAZ", "2"]]

輸出：

["foo", #<struct CSV::FieldInfo index=0, line=1, header=nil>]
["0", #<struct CSV::FieldInfo index=1, line=1, header=nil>]
["bar", #<struct CSV::FieldInfo index=0, line=2, header=nil>]
["1", #<struct CSV::FieldInfo index=1, line=2, header=nil>]
["baz", #<struct CSV::FieldInfo index=0, line=3, header=nil>]
["2", #<struct CSV::FieldInfo index=1, line=3, header=nil>]

該塊不需要返回 String 對象：

csv = CSV.open(path)
csv.convert {|field, field_info| field.to_sym }
csv.read # => [[:foo, :"0"], [:bar, :"1"], [:baz, :"2"]]

如果給出converter_name，則不調用該塊：

csv = CSV.open(path)
csv.convert(:integer) {|field, field_info| fail 'Cannot happen' }
csv.read # => [["foo", 0], ["bar", 1], ["baz", 2]]

如果 converter_name 不是內置字段轉換器的名稱，則引發 parse-time 異常：

csv = CSV.open(path)
csv.convert(:nosuch) => [nil]
# Raises NoMethodError (undefined method `arity' for nil:NilClass)
csv.read