Sign in Join
FPDoc Onlineexperiment

FppRead function

In unit BaseUnix

Positional read: read from file descriptor at a certain position.

Declaration

pascal
function FpPRead(fd: cint; buf: PAnsiChar; nbytes: TSize; offset: TOff)
: TsSize

Description

FpPRead reads nbytes bytes from file descriptor fd into buffer buf starting at offset offset. Offset is measured from the start of the file. This function can only be used on files, not on pipes or sockets (i.e. any seekable file descriptor).

The function returns the number of bytes actually read, or -1 on error.

Errors

On error, -1 is returned.

See also

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.