.\" This manpage content is licensed under Creative Commons
.\"  Attribution 4.0 International (CC BY 4.0)
.\"   https://creativecommons.org/licenses/by/4.0/
.\" This manpage was generated from SDL's wiki page for SDL_RWseek:
.\"   https://wiki.libsdl.org/SDL_RWseek
.\" Generated with SDL/build-scripts/wikiheaders.pl
.\"  revision SDL-prerelease-3.0.0-3508-g7c089f4e5
.\" Please report issues in this manpage's content at:
.\"   https://github.com/libsdl-org/sdlwiki/issues/new
.\" Please report issues in the generation of this manpage from the wiki at:
.\"   https://github.com/libsdl-org/SDL/issues/new?title=Misgenerated%20manpage%20for%20SDL_RWseek
.\" SDL can be found at https://libsdl.org/
.de URL
\$2 \(laURL: \$1 \(ra\$3
..
.if \n[.g] .mso www.tmac
.TH SDL_RWseek 3 "SDL 3.0.0" "SDL" "SDL3 FUNCTIONS"
.SH NAME
SDL_RWseek \- Seek within an 
.BR SDL_RWops
 data stream\[char46]
.SH SYNOPSIS
.nf
.B #include \(dqSDL3/SDL.h\(dq
.PP
.BI "Sint64 SDL_RWseek(SDL_RWops *context, Sint64 offset, int whence);
.fi
.SH DESCRIPTION
This function seeks to byte
.BR offset
, relative to
.BR whence
\[char46]
.BR whence
may be any of the following values:


\(bu 
.BR
.BR SDL_RW_SEEK_SET
: seek from the beginning of data

\(bu 
.BR
.BR SDL_RW_SEEK_CUR
: seek relative to current read point

\(bu 
.BR
.BR SDL_RW_SEEK_END
: seek relative to the end of data

If this stream can not seek, it will return -1\[char46]


.BR SDL_RWseek
() is actually a wrapper function that calls the

.BR SDL_RWops
's
.BR seek
method appropriately, to simplify
application development\[char46]

.SH FUNCTION PARAMETERS
.TP
.I context
a pointer to an 
.BR SDL_RWops
 structure
.TP
.I offset
an offset in bytes, relative to
.B whence
location; can be negative
.TP
.I whence
any of 
.BR
.BR SDL_RW_SEEK_SET
, 
.BR
.BR SDL_RW_SEEK_CUR
, 
.BR
.BR SDL_RW_SEEK_END

.SH RETURN VALUE
Returns the final offset in the data stream after the seek or a negative
error code on failure; call 
.BR SDL_GetError
() for more
information\[char46]

.SH AVAILABILITY
This function is available since SDL 3\[char46]0\[char46]0\[char46]

.SH SEE ALSO
.BR SDL_RWclose (3),
.BR SDL_RWFromConstMem (3),
.BR SDL_RWFromFile (3),
.BR SDL_RWFromMem (3),
.BR SDL_RWread (3),
.BR SDL_RWtell (3),
.BR SDL_RWwrite (3)