CBL_READ_FILE

Reads bytes from a file.

Syntax:
call "CBL_READ_FILE" using file-handle
                           file-offset
                           byte-count
                           flags
                           buffer
Parameters:
Using call prototype (see Library Routines - Key) Picture (32-bit systems)
file-handle cblt-bytestream-handle pic x(4) comp-5.
file-offset cblt-x8-compx pic x(8) comp-x.
byte-count cblt-x4-compx pic x(4) comp-x.
flags cblt-x1-compx pic x comp-x.
buffer pic x(n). pic x(n).
On Entry:
file-handle The file handle returned when the file was opened.
file-offset The offset in the file at which to read. This field is currently limited to a maximum value of x"00FFFFFFFF".
byte-count The number of bytes to read.
flags This parameter can take the following values:
0 Standard read
128 Return the current file size in file-offset
On Exit:
file-offset Contains the current file size on return if flags is set to 128 on entry.
buffer The buffer into which the bytes are read. It is your responsibility to ensure that the buffer is large enough to hold the number of bytes to be read.
Comments:

The success of the call can be checked by examining RETURN-CODE.

When using this routine to read a file that is contained in a .lbr file, the end-of-file status is not returned. To ensure you only read the file you want, obtain the size of the file first (set flags to 128), and only read up to that size.

See Also: