SDL_CPUPauseInstruction - A macro to insert a CPU-specific "pause" instruction into the program.
Contents
Availability
This macro is available since SDL 3.2.0.
Simple Directmedia Layer SDL 3.2.10 SDL_CPUPauseInstruction(3)
Description
This can be useful in busy-wait loops, as it serves as a hint to the CPU as to the program's intent; some
CPUs can use this to do more efficient processing. On some platforms, this doesn't do anything, so using
this macro might just be a harmless no-op.
Note that if you are busy-waiting, there are often more-efficient approaches with other synchronization
primitives: mutexes, semaphores, condition variables, etc.
Header File
Defined in SDL3/SDL_atomic.h
Name
SDL_CPUPauseInstruction - A macro to insert a CPU-specific "pause" instruction into the program.
Synopsis
#include"SDL3/SDL.h"#defineSDL_CPUPauseInstruction()DoACPUPauseInACompilerAndArchitectureSpecificWay
Thread Safety
This macro is safe to use from any thread.
