Querying SDL Version

Include File(s): SDL_version.h

Introduction

These functions are used to collect or display information about the version of SDL that is currently being used by the program.

• The version number consists of three segments (X.Y.Z)

  • X = Major Version, which increments with massive changes, additions, and enhancements

  • Y = Minor Version, which increments with backwards-compatible changes to the major revision

  • Z = Patchlevel, which increments with fixes to the minor revision
    

  Example: The current version is 1.3.0

Here are macros (green

) that are useful in dealing with version information.

• SDL_VERSION

  • This macro gathers information from SDL_MAJOR_VERSION, SDL_MINOR_VERSION, AND SDL_PATCHLEVEL (#defines) and fills the structure SDL_version with that information.

• SDL_VERSIONNUM

  • A macro that converts version numbers into a numeric value.

• SDL_COMPILEDVERSION

  • A macro that produces the current SDL version number (major.minor.patchlevel)

• SDL_VERSION_ATLEAST

  • A macro that confirms whether a program was compiled with a version no older than the specified version.

Functions

CategoryCategory