SDL_SeekIO

Seek within an SDL_IOStream data stream.

Header File

Defined in <SDL3/SDL_iostream.h>

Syntax

Sint64 SDL_SeekIO(SDL_IOStream *context, Sint64 offset, SDL_IOWhence whence);

Function Parameters

SDL_IOStream * context a pointer to an SDL_IOStream structure.
Sint64 offset an offset in bytes, relative to whence location; can be negative.
SDL_IOWhence whence any of SDL_IO_SEEK_SET, SDL_IO_SEEK_CUR, SDL_IO_SEEK_END.

Return Value

(Sint64) Returns the final offset in the data stream after the seek or -1 on failure; call SDL_GetError() for more information.

Remarks

This function seeks to byte offset, relative to whence.

whence may be any of the following values:

If this stream can not seek, it will return -1.

Thread Safety

This function is not thread safe.

Version

This function is available since SDL 3.2.0.

See Also


CategoryAPI, CategoryAPIFunction, CategoryIOStream