SDL_SetPointerPropertyWithCleanup3
Set a pointer property in a group of properties with a cleanup function that is called when the property is deleted.
Usage
#include "SDL3/SDL.h"
bool SDL_SetPointerPropertyWithCleanup(SDL_PropertiesID props, const char *name, void *value, SDL_CleanupPropertyCallback cleanup, void *userdata);
Header file
Defined in SDL3/SDL_properties.h
Overview
The cleanup function is also called if setting the property fails for any reason.
For simply setting basic data types, like numbers, bools, or strings, use
SDL_SetNumberProperty ,
SDL_SetBooleanProperty , or
SDL_SetStringProperty
instead, as those functions will handle cleanup on your behalf. This function is only for more complex, custom data.
Function parameters
- props
-
the properties to modify.
- name
-
the name of the property to modify.
- value
-
the new value of the property, or NULL to delete the property.
- cleanup
-
the function to call when this property is deleted, or NULL if no cleanup is necessary.
- userdata
-
a pointer that is passed to the cleanup function.
Return value
Returns true on success or false on failure; call
SDL_GetError () for more information.
Thread safety
It is safe to call this function from any thread.