HelpSource/Classes/CSVFileReader.schelp

   1 class:: CSVFileReader
   2 summary:: file reader for comma separated data
   3 related:: Classes/File
   4 categories:: Files
   5
   6 description::
   7 CSVFileReader reads comma-separated text files into 2D arrays line by line.
   8
   9 For tab delimited files use link::Classes/TabFileReader::. For semi-colon-delimited files use link::Classes/SemiColonFileReader::. For space-delimited files, or custom delimiters, use link::Classes/FileReader::.
  10
  11 Examples::
  12
  13 code::
  14 (
  15 // write a test file:
  16 f = File("CSVReadTest.sc", "w");
  17 f.write(
  18 "Some,comma,delimited,items, in line 1
  19
  20 and then, some more, with several commas,,,, in line 3
  21 "
  22 );
  23 f.close;
  24 )
  25
  26
  27         // open file, read and put strings into array, close file.
  28 x = CSVFileReader.read("CSVReadTest.sc").postcs;
  29
  30         // can skip empty lines:
  31 x = CSVFileReader.read("CSVReadTest.sc", true).postcs;
  32
  33         // can skip blank entries caused by multiple commas:
  34 x = CSVFileReader.read("CSVReadTest.sc", true, true).postcs;
  35
  36         // do file open/close by hand if you prefer:
  37 f = File("CSVReadTest.sc", "r"); f.isOpen;
  38 t = CSVFileReader(f);
  39 t.read(true, true).postcs;
  40 f.close;
  41
  42 (
  43 // write a test file with numbers:
  44 f = File("CSVReadTestNum.sc", "w");
  45
  46 (1..10).do { |n| f.write(n.asString ++ ","); };
  47 f.close;
  48 )
  49
  50 x = CSVFileReader.read("CSVReadTestNum.sc", true, true).postcs;
  51 x.collect(_.collect(_.interpret));      // convert to numbers.
  52
  53         // or do it immediately:
  54 x = CSVFileReader.readInterpret("CSVReadTestNum.sc").postcs;
  55
  56 (
  57 // write a test file with several lines of numbers:
  58 f = File("CSVReadTestNum.sc", "w");
  59
  60 (1..100).do { |n|
  61         f.write(n.asString ++ if (n % 10 != 0, ",", Char.nl)); };
  62 f.close;
  63 )
  64
  65
  66 x = CSVFileReader.readInterpret("CSVReadTestNum.sc", true, true).postln;
  67 ::