octave_packages/statistics-1.1.3/caseread.m

   1 ## Copyright (C) 2008 Bill Denney <bill@denney.ws>
   2 ##
   3 ## This program is free software; you can redistribute it and/or modify it under
   4 ## the terms of the GNU General Public License as published by the Free Software
   5 ## Foundation; either version 3 of the License, or (at your option) any later
   6 ## version.
   7 ##
   8 ## This program is distributed in the hope that it will be useful, but WITHOUT
   9 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  10 ## FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
  11 ## details.
  12 ##
  13 ## You should have received a copy of the GNU General Public License along with
  14 ## this program; if not, see <http://www.gnu.org/licenses/>.
  15
  16 ## -*- texinfo -*-
  17 ## @deftypefn {Function File} {@var{names} =} caseread (@var{filename})
  18 ## Read case names from an ascii file.
  19 ##
  20 ## Essentially, this reads all lines from a file as text and returns
  21 ## them in a string matrix.
  22 ## @seealso{casewrite, tblread, tblwrite, csv2cell, cell2csv, fopen}
  23 ## @end deftypefn
  24
  25 ## Author: Bill Denney <bill@denney.ws>
  26 ## Description: Read strings from a file
  27
  28 function names = caseread (f="")
  29
  30   ## Check arguments
  31   if nargin != 1
  32     print_usage ();
  33   endif
  34   if isempty (f)
  35     ## FIXME: open a file dialog box in this case when a file dialog box
  36     ## becomes available
  37     error ("caseread: filename must be given")
  38   endif
  39
  40   [fid msg] = fopen (f, "rt");
  41   if fid < 0 || (! isempty (msg))
  42     error ("caseread: cannot open %s: %s", f, msg);
  43   endif
  44
  45   names = {};
  46   t = fgetl (fid);
  47   while ischar (t)
  48     names{end+1} = t;
  49     t = fgetl (fid);
  50   endwhile
  51   if (fclose (fid) < 0)
  52     error ("caseread: error closing f")
  53   endif
  54   names = strvcat (names);
  55
  56 endfunction
  57
  58 ## Tests
  59 %!shared n
  60 %! n = ["a  ";"bcd";"ef "];
  61 %!assert (caseread ("caseread.dat"), n);