[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] | Reference for unit 'sysutils' (#rtl)

# FileRead

Read data from a file handle in a buffer.

## Declaration

Source position: filutilh.inc line 219

`function FileRead(`
`Handle: THandle;`
`out Buffer;`
`Count: LongInt`
`):LongInt;`

## Description

FileRead reads Count bytes from file-handle Handle and stores them into Buffer. Buffer must be at least Count bytes long. No checking on this is performed, so be careful not to overwrite any memory. Handle must be the result of a FileOpen call.

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

For an example, see FileCreate

## Errors

On error, -1 is returned.

## See also

FileClose |  | Close a file handle.
FileWrite |  | Write data from a buffer to a given file handle.
FileCreate |  | Create a new file and return a handle to it.
FileOpen |  | Open an existing file and return a file handle
FileTruncate |  | Truncate an open file to a given size.
FileSeek |  | Set the current file position on a file handle.

Documentation generated on: May 14 2021