HelpSource/Classes/TabFileReader.schelp

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