Scroll to navigation

SDL_DestroyRW(3) SDL3 FUNCTIONS SDL_DestroyRW(3)

NAME

SDL_DestroyRW - Use this function to free an SDL_RWops
structure allocated by SDL_CreateRW ().

SYNOPSIS

#include "SDL3/SDL.h"
void SDL_DestroyRW(SDL_RWops *context);

DESCRIPTION

Applications do not need to use this function unless they are providing their own SDL_RWops
implementation. If you just need an

SDL_RWops
to read/write a common data source, you should use the built-in implementations in SDL, like

SDL_RWFromFile () or SDL_RWFromMem (), etc, and call the close method on those SDL_RWops
pointers when you are done with them.

Only use SDL_DestroyRW () on pointers returned by

SDL_CreateRW (). The pointer is invalid as soon as this function returns. Any extra memory allocated during creation of the

SDL_RWops
is not freed by SDL_DestroyRW (); the programmer must be responsible for managing that memory in their close method.

FUNCTION PARAMETERS

the SDL_RWops
structure to be freed

AVAILABILITY

This function is available since SDL 3.0.0.

SEE ALSO

SDL_CreateRW(3)

SDL 3.0.0 SDL