| | DEFUN_DLD (dlmread, args,,"-*- texinfo -*-\n\
@deftypefn {Loadable Function} {@var{data} =} dlmread (@var{file})\n\
@deftypefnx {Loadable Function} {@var{data} =} dlmread (@var{file}, @var{sep})\n\
@deftypefnx {Loadable Function} {@var{data} =} dlmread (@var{file}, @var{sep}, @var{r0}, @var{c0})\n\
@deftypefnx {Loadable Function} {@var{data} =} dlmread (@var{file}, @var{sep}, @var{range})\n\
@deftypefnx {Loadable Function} {@var{data} =} dlmread (@dots{}, \"emptyvalue\", @var{EMPTYVAL})\n\
Read the matrix @var{data} from a text file. If not defined the separator\n\
between fields is determined from the file itself. Otherwise the\n\
separation character is defined by @var{sep}.\n\
\n\
Given two scalar arguments @var{r0} and @var{c0}, these define the starting\n\
row and column of the data to be read. These values are indexed from zero,\n\
such that the first row corresponds to an index of zero.\n\
\n\
The @var{range} parameter may be a 4-element vector containing the upper\n\
left and lower right corner @code{[@var{R0},@var{C0},@var{R1},@var{C1}]}\n\
where the lowest index value is zero. Alternatively, a spreadsheet style\n\
range such as 'A2..Q15' or 'T1:AA5' can be used. The lowest alphabetical\n\
index 'A' refers to the first column. The lowest row index is 1.\n\
\n\
@var{file} should be a file name or file id given by @code{fopen}. In the\n\
latter case, the file is read until end of file is reached.\n\
\n\
The \"emptyvalue\" option may be used to specify the value used to fill empty\n\
fields. The default is zero.\n\
@seealso{csvread, textscan, textread, dlmwrite}\n\
@end deftypefn") |
