class IO

IO extensions

Public Class Methods

readrows(filename, options={}) click to toggle source

Reads the entire file specified by name as individual lines as with IO#readlines, and returns those lines in an array of rows, where each row is an array of fields.

@return [Array<Array<String>>] an array of rows, where each row is an array of fields.

@example

IO.readrows("my.tsv")
 => [["A1","B1","C1"],["A2","B2","C2"],["A3","B3","C3"]]

@param [String] filename @param [Hash] options

- Rows are separated by _row_ option, which defaults to Ruby's record separator $/ or "\n" 
- Cols are separated by _col_ option, which defaults to Ruby's string split separator $; or "\t"

@example with options suitable for a file using TSV (Tab Separated Values)

IO.readrows("my.tsv", :row=>"\n", :col=>"\t")

Note: the col option is sent along to String#split, so can be a string or a regexp.

@see

  • File#readline

  • File#readlines

  • File#readrow

# File lib/sixarm_ruby_ramp/io.rb, line 31
def IO.readrows(filename, options={})
  row_sep||=options[:row]||$/||"\n"
  col_sep||=options[:col]||$;||"\t"
  return IO.readlines(filename, row_sep).map{|line| line.chomp(row_sep).split(col_sep)}
end

Public Instance Methods

readrow(options={}) click to toggle source

Read a line as with IO#readline and return the line as a row of fields.

Note: the col option is sent along to String#split, so can be a string or a regexp.

@return [Array<String>] fields

@param [Hash] options

  • Rows are separated by row option, which defaults to Ruby's record separator $/ or “n”

  • Cols are separated by col option, which defaults to Ruby's string split separator $; or “t”

@example

file = File.new("my.tsv")
file.readrow() => ["A1","B1","C1"]
file.readrow() => ["A2","B2","C2"]
file.readrow() => ["A3","B3","C3"]]

@example with options suitable for a file using TSV (Tab Separated Values)

file = File.new("my.tsv")
file.readrow(:row=>"\n", :col=>"\t") => ["A1","B1","C1"] 
file.readrow(:row=>"\n", :col=>"\t") => ["A2","B2","C2"] 
file.readrow(:row=>"\n", :col=>"\t") => ["A3","B3","C3"]

@see File#readline @see File#readlines @see File#readrows

# File lib/sixarm_ruby_ramp/io.rb, line 64
def readrow(options={})
  row_sep||=options[:row]||$/||"\n"
  col_sep||=options[:col]||$;||"\t"
 return readline(row_sep).chomp(row_sep).split(col_sep)
end