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;
}