Read some data from a given file. The request is directly given to the filesystem - no buffering is involved. For small amounts of data it's probably better to use the buffered I/O routines.
INPUTS
file
filehandle
buffer
pointer to buffer for the data
length
number of bytes to read. The filesystem is advised to try to fulfill the request as good as possible.
RESULT
The number of bytes actually read, 0 if the end of the file was reached, -1 if an error happened. IoErr() will give additional information in that case.
EXAMPLE
SEE ALSO
NOTES
BUGS
INTERNALS
HISTORY
20.10.1998 hkiel
Amiga Research OS
06.12.1997 srittau
Do not use IOFileSys->io_Args
Small changes and bugfixes
14.04.1997 aros
Polish
27.01.1997 ldp
Polish
09.12.1996 aros
Added empty templates for all missing functions
Moved #include's into first column
24.10.1996 aros
Use the official AROS macros over the __AROS versions.
13.09.1996 digulla
Use IPTR
13.08.1996 digulla
Replaced <dos/dosextens.h> by "dos_intern.h" or added "dos_intern.h"
Replaced __AROS_LA by __AROS_LHA