STSkipTo(3) Impressario STSkipTo(3)NAMESTSkipTo - skip forward in a STIFF stream
SYNOPSIS
#include <stdio.h>
#include <stiff.h>
int STSkipTo(STStream *st, unsigned long offset);
DESCRIPTIONSTSkipTo skips forward in a STIFF stream. This function can be used to
skip over unneeded data. The stream descriptor st must be a valid open
STIFF stream pointer. offset specifies the location in the STIFF stream
to skip to. The location is specified in bytes from the start of the
stream and must not be less than the current stream offset.
If the file descriptor associated with st is seekable, then STSkipTo can
also be used to skip backward.
RETURN VALUESTSkipTo returns 0 if execution was successful. -1 is returned and
STerrno is set if an execution error has occurred.
EXECUTION ERROR CODESSTSkipTo will fail under the following circumstances.
STENEEDSEEK Operation requires seeking on a stream.
STESYSCALL System call failed.
SEE ALSOlibstiff(3).
Page 1