seekr

Purpose

Moves the pointer in a .dat or .fmt file to a particular row.

Format

y = seekr(fh, r)

Parameters

• fh (scalar) – file handle of an open file.

• r (scalar) – the row number to which the pointer is to be moved.

Returns

y (scalar) – the row number to which the pointer has been moved.

Remarks

If r = -1, the current row number will be returned.

If r = 0, the pointer will be moved to the end of the file, just past the end of the last row.

rowsf() returns the number of rows in a file.

seekr(fh, 0) == rowsf(fh) + 1;

Danger

Do NOT try to seek beyond the end of a file.

See also

Functions open, readr(), rowsf()

previous

searchsourcepath

next

select (dataloop)