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

# FileWrite

Write data from a buffer to a given file handle.

## Declaration

Source position: filutilh.inc line 220

`function FileWrite(`
`Handle: THandle;`
`const Buffer;`
`Count: LongInt`
`):LongInt;`

## Description

FileWrite writes Count bytes from Buffer to the file with handle Handle. Prior to this call, the file must have been opened for writing. Buffer must be at least Count bytes large, or a memory access error may occur.

The function returns the number of bytes written, or -1 in case of an error.

For an example, see FileCreate.

## Errors

In case of error, -1 is returned.

## See also

FileClose |  | Close a file handle.
FileCreate |  | Create a new file and return a handle to it.
FileOpen |  | Open an existing file and return a file handle
FileRead |  | Read data from a file handle in a buffer.
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