HelpSource/Classes/SemiColonFileReader.schelp

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