Navigation

Operators and Keywords

Function List:

C++ API

Built-in Function: data = dlmread (file)
Built-in Function: data = dlmread (file, sep)
Built-in Function: data = dlmread (file, sep, r0, c0)
Built-in Function: data = dlmread (file, sep, range)
Built-in Function: data = dlmread (…, "emptyvalue", EMPTYVAL)

Read the matrix data from a text file which uses the delimiter sep between data values.

If sep is not defined the separator between fields is determined from the file itself.

Given two scalar arguments r0 and c0, these define the starting row and column of the data to be read. These values are indexed from zero, such that the first row corresponds to an index of zero.

The range parameter may be a 4-element vector containing the upper left and lower right corner [R0,C0,R1,C1] where the lowest index value is zero. Alternatively, a spreadsheet style range such as "A2..Q15" or "T1:AA5" can be used. The lowest alphabetical index 'A' refers to the first column. The lowest row index is 1.

file should be a file name or file id given by fopen. In the latter case, the file is read until end of file is reached.

The "emptyvalue" option may be used to specify the value used to fill empty fields. The default is zero.

See also: csvread, textscan, textread, dlmwrite.

Package: octave