|
Size: 1149
Comment: Added spaces in example.
|
Size: 1459
Comment: Added details from SDL_RWops page, added more related functions, and removed draft header.
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 3: | Line 3: |
| ||<tablewidth="100%" style="color: #FF0000;" :> DRAFT|| | |
| Line 23: | Line 22: |
| Uint8 buf[256]; | |
| Line 25: | Line 25: |
| extern Uint8 buf[256]; | |
| Line 29: | Line 28: |
| // Go on and use the data in buf... | |
| Line 32: | Line 32: |
| Note that if this fails to flush the stream to disk, this function reports an error, but the RWops is still invalid once this function returns. | SDL_RWclose closes and cleans up the SDL_RWops stream. It releases any resources used by the stream and frees the SDL_RWops itself with [[SDL_FreeRW]]. This returns 0 on success, or -1 if the stream failed to flush to its output (e.g. to disk). Note that if this fails to flush the stream to disk, this function reports an error, but the SDL_RWops is still invalid once this function returns. |
| Line 40: | Line 42: |
| .[[SDL_RWFromFile]] .[[SDL_RWFromFP]] .[[SDL_RWFromMem]] .[[SDL_RWFromConstMem]] |
SDL_RWclose
Use this function to close and free an allocated SDL_RWops structure.
Contents
Syntax
int SDL_RWclose(struct SDL_RWops* context)
Function Parameters
context |
SDL_RWops structure to close |
Return Value
Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.
Code Examples
Uint8 buf[256];
SDL_RWops *rw = SDL_RWFromFile("test.bin", "r");
if (rw != NULL) {
SDL_RWread(rw, buf, sizeof (buf), 1);
SDL_RWclose(rw);
}
// Go on and use the data in buf...
Remarks
SDL_RWclose closes and cleans up the SDL_RWops stream. It releases any resources used by the stream and frees the SDL_RWops itself with SDL_FreeRW. This returns 0 on success, or -1 if the stream failed to flush to its output (e.g. to disk).
Note that if this fails to flush the stream to disk, this function reports an error, but the SDL_RWops is still invalid once this function returns.
SDL_RWclose is actually a macro that calls the SDL_RWops's close method appropriately, to simplify application development.
