annotate scripts/io/fileread.m @ 10081:debb5b35a1a7

implement fileread
author Jaroslav Hajek <highegg@gmail.com>
date Mon, 11 Jan 2010 10:54:58 +0100
parents
children c146b308739f
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
10081
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
1 ## Copyright (C) 2010 VZLU Prague
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
2 ##
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
3 ## This program is free software; you can redistribute it and/or modify
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
4 ## it under the terms of the GNU General Public License as published by
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
5 ## the Free Software Foundation; either version 3 of the License, or
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
6 ## (at your option) any later version.
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
7 ##
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
8 ## This program is distributed in the hope that it will be useful,
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
9 ## but WITHOUT ANY WARRANTY; without even the implied warranty of
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
10 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
11 ## GNU General Public License for more details.
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
12 ##
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
13 ## You should have received a copy of the GNU General Public License
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
14 ## along with this program; if not, see
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
15 ## <http://www.gnu.org/licenses/>.
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
16
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
17 ## -*- texinfo -*-
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
18 ## @deftypefn {Function File} {@var{str} =} fileread (@var{filename})
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
19 ## Read the contents of a file and return it as a string.
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
20 ## @seealso{fread, textread}
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
21 ## @end deftypefn
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
22
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
23 function str = fileread (filename)
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
24
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
25 if (nargin != 1)
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
26 print_usage ();
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
27 endif
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
28
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
29 if (! ischar (filename))
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
30 error ("fileread: argument must be a string");
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
31 endif
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
32
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
33 fid = fopen (filename, "r");
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
34 if (fid < 0)
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
35 error ("fileread: cannot open file");
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
36 endif
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
37
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
38 unwind_protect
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
39 str = fread (fid, "*char");
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
40 unwind_protect_cleanup
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
41 fclose (fid)
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
42 end_unwind_protect
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
43
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
44 endfunction
debb5b35a1a7 implement fileread
Jaroslav Hajek <highegg@gmail.com>
parents:
diff changeset
45