NAME

SDL_SetStringProperty - Set a string property in a group of properties.

SYNOPSIS

#include <SDL3/SDL_properties.h>

bool SDL_SetStringProperty(SDL_PropertiesID props, const char *name, const char *value);

DESCRIPTION

This function makes a copy of the string; the caller does not have to preserve the data after this call completes.

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.

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.

AVAILABILITY

This function is available since SDL 3.2.0.

SEE ALSO

SDL_GetStringProperty(3)