LPC Library Functions: read_buffer

NAME

read_buffer() - read from a file and return a buffer, or return part of a buffer as a string

SYNOPSIS

string | buffer read_buffer( string | buffer src, int start, int len );

DESCRIPTION

If 'src' is a string (filename), then the filename will be read, starting at byte # 'start', for 'len' bytes, and returned as a buffer. If neither argument is given, the entire file is read.

If 'src' is a buffer, then characters are read from the buffer beginning at byte # 'start' in the buffer, for 'len' bytes, and returned as a string.

Note that the maximum number of bytes you can read from a file and into a buffer is controlled via the 'maximum byte transfer' parameter in the runtime config file.

This function is only available if the driver flag NO_BUFFER_TYPE is not defined.

SEE ALSO

write_buffer(), allocate_buffer(), bufferp(), read_bytes(), write_bytes() Truilkan