Click above to get retro games delivered to your door ever month!

Syntax

READNEXT( nFd, nStart, nStop, aArray )

Purpose

Read the next n lines of a text file.

Arguments

     nFd -- DOS file handle, from a call to FOPEN() or FCREATE().

     nStart -- Start filling the array at this element number.

     nStop -- Stop filling the array at this element number.

     aArray -- Array to fill with the lines.

Setup

nFd is a valid DOS file handle. The file pointer has been set.

Example

     tmp = READNEXT( fd, 1, 20, line_ra )

Returns

The number of bytes read, or 0 if (nStart - nStop + 1) lines cannot be
read.

Side Effects

The file pointer is moved. The array is filled with the lines of text.

Artful Calls

None.

@SECTION = Clipper Calls

_tread(), _tlseek(), _exmgrab(), _exmback(), _storc(), _parni(), _parnl(),
_retni(), _stpchr()

Source File

AA_READ.C