Wiki Page Content

Differences between revisions 13 and 14
Revision 13 as of 2011-01-12 00:13:16
Size: 2098
Editor: SheenaSmith
Comment: update content - RWops stream
Revision 14 as of 2013-06-15 16:06:19
Size: 2121
Comment: Updated return type, return value and example.
Deletions are marked like this. Additions are marked like this.
Line 11: Line 11:
long SDL_RWseek(SDL_RWops* context,
                long offset,
                int whence)
Sint64 SDL_RWseek(SDL_RWops* context,
   long offset,
                  int whence)
Line 24: Line 24:
Returns the final offset in the data stream after the seek. Returns the final offset in the data stream after the seek or -1 on error.
Line 34: Line 34:
  long length;   Sint64 length;

SDL_RWseek

Use this function to seek within an SDL_RWops data stream.

Syntax

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

green

Function Parameters

context

a data stream containing the seek function???

offset

an offset in bytes, relative to whence location; can be negative

whence

any of RW_SEEK_SET, RW_SEEK_CUR, RW_SEEK_END; see Remarks for details

Return Value

Returns the final offset in the data stream after the seek or -1 on error.

Code Examples

*

#include <stdio.h>
#include "SDL_rwops.h"

int main()
{
  Sint64 length;
  SDL_RWops *rw=SDL_RWFromFile("myfile.bin","rb");
  if(rw==NULL)
  {
    fprintf(stderr,"Couldn't open myfile.bin\n");
    return(1);
  }

  /* Seek to 0 bytes from the end of the file -- i.e. the exact end of file */
  length=SDL_RWseek(rw,0,SEEK_END);
  SDL_RWclose(rw);
  if(length<0)
  {
    fprintf(stderr,"Could not seek inside myfile.bin\n");
    return(2);
  }

  fprintf(stderr,"myfile.bin is %d bytes long\n",length);
  return(0);
}


*

Remarks

*
This is not a predefined function, just a macro that calls whatever seek function has been placed in the SDL_RWops structure.
*

SDL_RWseek seeks to offset relative to whence. green

whence may be any of the following values:

RW_SEEK_SET

seek from the beginning of data

RW_SEEK_CUR

seek relative to current read point

RW_SEEK_END

seek relative to the end of data


CategoryAPI, CategoryIO

None: SDL_RWseek (last edited 2015-06-20 20:01:11 by PhilippWiesemann)

Feedback
Please include your contact information if you'd like to receive a reply.
Submit