(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_GetAppMetadataProperty

Get metadata about your app.

Header File

Syntax

const char * SDL_GetAppMetadataProperty(const char *name);

Function Parameters

const char *

name

the name of the metadata property to get.

Return Value

(const char *) Returns the current value of the metadata property, or the default if it is not set, NULL for properties with no default.

Remarks

This returns metadata previously set using SDL_SetAppMetadata() or SDL_SetAppMetadataProperty(). See SDL_SetAppMetadataProperty() for the list of available properties and their meanings.

Thread Safety

It is safe to call this function from any thread, although the string returned is not protected and could potentially be freed if you call SDL_SetAppMetadataProperty() to set that property from another thread.

Version

This function is available since SDL 3.1.3.