Scroll to navigation

XDF_SEEK(3) xdffileio library manual XDF_SEEK(3)

NAME

xdf_seek - move the sample pointer of a xDF file

SYNOPSIS

#include <xdfio.h>

off_t xdf_seek(struct xdf* xdf, off_t offset, int whence);

DESCRIPTION

xdf_seek() repositions the current sample pointer according to the couple (offset,whence) where whence can be:

The offset is set to offset bytes.
The offset is set to its current location plus offset bytes.
The offset is set to the size of the file plus offset bytes.

The file referenced by xdf should have been opened with mode XDF_READ and xdf_prepare_arrays(3) should have been successfully called on it.

RETURN VALUE

Upon successful completion, xdf_seek() returns the resulting offset location as measured in number of samples from the beginning of the recording. Otherwise, a value of -1 is returned and errno is set to indicate the error.

ERRORS

xdf is NULL or whence is none of the allowed values.
No successfull call to xdf_prepare_transfer(3) have been done on xdf or it has been opened using the mode XDF_WRITE.
The requested offset is out of the range of the recording.
The call was interrupted by a signal before any data was read; see signal(7).
A low-level I/O error occurred while reading from the inode.
Stale file handle. This error can occur for NFS and for other file systems

SEE ALSO

xdf_define_arrays(3), xdf_prepare_transfer(3)

2010 EPFL