SDL_FALLTHROUGH3

Usage

#include "SDL3/SDL.h"

Header file

Defined in SDL3/SDL_begin_code.h

Overview

C compilers have gotten more aggressive about warning when a switch's case block does not end with a break or other flow control statement, flowing into the next case's code, as this is a common accident that leads to strange bugs. But sometimes falling through to the next case is the correct and desired behavior. This symbol lets an app communicate this intention to the compiler, so it doesn't generate a warning.

It is used like this:

switch (x) {
    case 1:
        DoSomethingOnlyForOne();
        SDL_FALLTHROUGH;  // tell the compiler this was intentional.
    case 2:
        DoSomethingForOneAndTwo();
        break;
}