Seek a position on a file stream.

This function is compatible with the following targets:

ANSI

BeOS

EMB/RTOS

Mac OS

Palm OS

Win32

#include <unistd.h>

long lseek(int fildes, long offset, int origin);

Parameters for this facility are:

fildes	int	The file descriptor
offset	long	The offset to move in bytes
origin	int	The starting point of the seek

The function lseek() sets the file position location a specified byte offset from a specified initial location.

The origin of the offset must be one of the positions in "The lseek offset positions.."

Macro	Meaning
SEEK_SET	Beginning of file
SEEK_CUR	Current Position
SEEK_END	End of File

If successful, lseek() returns the number of bytes offset. If unsuccessful, it returns a value of negative one long integer.

"fseek"

"ftell"

"open"

Refer to "Example of close() usage.".