Get the name of a display in UTF-8 encoding.
Defined in <SDL3/SDL_video.h>
const char * SDL_GetDisplayName(SDL_DisplayID displayID);| SDL_DisplayID | displayID | the instance ID of the display to query. |
(const char *) Returns the name of a display or NULL on failure; call SDL_GetError() for more information.
This function should only be called on the main thread.
This function is available since SDL 3.2.0.
// Example program // Use SDL3 to log the name of every display found #include <SDL3/SDL_log.h> #include <SDL3/SDL_main.h> #include <SDL3/SDL_video.h> int main(int argc, char** argv) { if (!SDL_Init(SDL_INIT_VIDEO)) { SDL_Log("Unable to initialize SDL: %s", SDL_GetError()); return 0; } int num_displays; SDL_DisplayID *displays = SDL_GetDisplays(&num_displays); for(int i = 0; i < num_displays; i++) { SDL_Log("Found display named '%s'", SDL_GetDisplayName(displays[i])); } SDL_free(displays); return 0; }