.\" This manpage content is licensed under Creative Commons
.\"  Attribution 4.0 International (CC BY 4.0)
.\"   https://creativecommons.org/licenses/by/4.0/
.\" This manpage was generated from SDL's wiki page for SDL_SetPropertyWithCleanup:
.\"   https://wiki.libsdl.org/SDL_SetPropertyWithCleanup
.\" Generated with SDL/build-scripts/wikiheaders.pl
.\"  revision SDL-3.1.0
.\" Please report issues in this manpage's content at:
.\"   https://github.com/libsdl-org/sdlwiki/issues/new
.\" Please report issues in the generation of this manpage from the wiki at:
.\"   https://github.com/libsdl-org/SDL/issues/new?title=Misgenerated%20manpage%20for%20SDL_SetPropertyWithCleanup
.\" SDL can be found at https://libsdl.org/
.de URL
\$2 \(laURL: \$1 \(ra\$3
..
.if \n[.g] .mso www.tmac
.TH SDL_SetPropertyWithCleanup 3 "SDL 3.1.0" "SDL" "SDL3 FUNCTIONS"
.SH NAME
SDL_SetPropertyWithCleanup \- Set a property on a set of properties with a cleanup function that is called when the property is deleted 
.SH SYNOPSIS
.nf
.B #include \(dqSDL3/SDL.h\(dq
.PP
.BI "int SDL_SetPropertyWithCleanup(SDL_PropertiesID props, const char *name, void *value, void (SDLCALL *cleanup)(void *userdata, void *value), void *userdata);
.fi
.SH DESCRIPTION
The cleanup function is also called if setting the property fails for any
reason\[char46]

.SH FUNCTION PARAMETERS
.TP
.I props
the properties to modify
.TP
.I name
the name of the property to modify
.TP
.I value
the new value of the property, or NULL to delete the property
.TP
.I cleanup
the function to call when this property is deleted, or NULL if no cleanup is necessary
.TP
.I userdata
a pointer that is passed to the cleanup function
.SH RETURN VALUE
Returns 0 on success or a negative error code on failure; call

.BR SDL_GetError
() for more information\[char46]

.SH THREAD SAFETY
It is safe to call this function from any thread\[char46]

.SH AVAILABILITY
This function is available since SDL 3\[char46]0\[char46]0\[char46]

.SH SEE ALSO
.BR SDL_GetProperty (3),
.BR SDL_SetProperty (3)