SDL_RWwrite
Use this function to write to an SDL_RWops data stream.
Contents
Syntax
size_t SDL_RWwrite(struct SDL_RWops* context,
const void* ptr,
size_t size,
size_t num)
Function Parameters
context |
a pointer to an SDL_RWops structure |
ptr |
a pointer to a buffer containing data to write |
size |
the size of an object to write, in bytes |
num |
the number of objects to write |
Return Value
Returns the number of objects written, which will be less than num on error; call SDL_GetError() for more information.
Code Examples
SDL_RWops *rw = SDL_RWFromFile("hello.txt", "w");
if(rw != NULL) {
const char *str = "Hello World";
size_t len = SDL_strlen(str);
if (SDL_RWwrite(rw, str, 1, len) != len) {
printf("Couldn't fully write string\n");
} else {
printf("Wrote %d 1-byte blocks\n", len);
}
SDL_RWclose(rw);
}
Remarks
This function writes exactly num objects each of size size from the area pointed at by ptr to the stream. If this fails for any reason, it'll return less than num to demonstrate how far the write progressed. On success, it returns num.
SDL_RWwrite is actually a macro that calls the SDL_RWops's write method appropriately, to simplify application development.
