SDL_RWwrite

Use this function to write to a data source -or- *call the write function in an SDL_RWops structure.*

Syntax

size_t SDL_RWwrite(struct SDL_RWops* context,
                   const void*       ptr,
                   size_t            size,
                   size_t            num)

Function Parameters

green

Return Value

Returns the number of objects written, or 0 at error or end of file; call SDL_GetError() for more information.

-or-

*>>On success,>> _it returns the number of memory blocks you told it to write >> >>. If it couldn't write that exact number of blocks, or the write didn't work at all, it returns _-1 ^{a negative error code}*; call SDL_GetError() for more information.

Code Examples

*

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

int main()
{
  int written;
  char *str="Hello World";

  SDL_RWops *rw=SDL_RWFromFile("test.bin","wb");
  if(rw==NULL)
  {
    fprintf(stderr,"Couldn't open test.bin\n");
    return(1);
  }

  written=SDL_RWwrite(rw,str,1,strlen(str));
  SDL_RWclose(rw);
  if(written<0)
  {
    fprintf(stderr,"Couldn't write to test.bin\n");
    return(2);
  }

  fprintf(stderr,"Wrote %d 1-byte blocks\n",written);
  return(0);
}

*

Remarks

*
This is not a built-in function. This is a macro that calls whatever write function happens to be in the SDL_RWops structure.
*

SDL_RWwrite writes exactly num objects each of size size from the area pointed at by ptr to data source. green

Related Functions

• SDL_RWclose (Macro) *

• SDL_RWFromFile *

• SDL_RWread (Macro) *

• SDL_RWseek(Macro) *

green

CategoryAPI, CategoryIO