SDL_NORETURN(3)

SDL_NORETURN3

A macro to tag a function as never-returning.

Usage

#include "SDL3/SDL.h"

#define SDL_NORETURN __attribute__((noreturn))

Header file

Defined in SDL3/SDL_begin_code.h

Overview

This is a hint to the compiler that a function does not return. An example of a function like this is the C runtime's exit() function.

This hint can lead to code optimizations, and help analyzers understand code flow better. On compilers without noreturn support, this is defined to nothing.

This symbol is used in SDL's headers, but apps and other libraries are welcome to use it for their own interfaces as well.

Availability

This macro is available since SDL 3.2.0.

From libsdl3-doc 3.2.10+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.