SDL_rwops.h

Función SDL_RWseek

Sintaxis

Sint64 SDL_RWseek(SDL_RWops *context,
                  Sint64 offset, int whence);

Descripción

Busca dentro de un stream SDL_RWops.

Parámetros

context
Un puntero a una estructura SDL_RWops.
offset
Un desplazamiento en bytes, relativo a la posición whence.
whence
Uno de los valores RW_SEEK_SET, RW_SEEK_CUR, RW_SEEK_END.

Valor de retorno

Devuelve el desplazamiento final en el stream después de la búsqueda, o -1 en caso de error.

Observaciones

Esta función busca el desplazamiento de bytes offset, relativo a whence.

whence puede ser cualquiera de los siguientes valores:

  • RW_SEEK_SET: búsqueda desde el principio de los datos.
  • RW_SEEK_CUR: búsqueda relativa al punto de lectura actual.
  • RW_SEEK_END: búsqueda relativa al final de los datos.

Si el stream no admite búsqueda, devolverá -1.

SDL_RWseek() es en realidad una función envoltorio que llama al método de búsqueda de SDL_RWops apropiadamente, para simplificar el desarrollo de aplicaciones.

Antes de SDL 2.0.10, esta función era una macro.