[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
        ReadChunkRecords -- read record elements from the current chunk into
                            a buffer. (V36)

   SYNOPSIS
        actual = ReadChunkRecords(iff, buf, bytesPerRecord, numRecords);
        D0                        A0   A1   D0              D1

        long readchunkrecords(struct iffhandle *, aptr, long, long);

   FUNCTION
        Reads records from the current chunk into buffer. Truncates attempts
        to read past end of chunk (only whole records are read; remaining
        bytes that are not of a whole record size are left unread and
        available for readchunkbytes()).

   INPUTS
        iff - pointer to iffhandle structure.
        buf - pointer to buffer area to receive data.
        bytesPerRecord  - size of data records to read.
        numRecords - number of data records to read.

   RESULT
        actual - (positive) number of whole records read if successful or a
                 (negative) IFFERR_#? error code if unsuccessful.

   SEE ALSO
        readchunkbytes(), parseiff(), writechunkrecords(),
        <libraries/iffparse.h>