SDL_version

A structure that contains information about the version of SDL in use.

Data Fields

Code Examples

SDL_version compiled;
SDL_version linked;

SDL_VERSION(&compiled);
SDL_GetVersion(&linked);
printf("We compiled against SDL version %d.%d.%d ...\n",
       compiled.major, compiled.minor, compiled.patch);
printf("But we are linking against SDL version %d.%d.%d.\n",
       linked.major, linked.minor, linked.patch);

Remarks

Represents the library's version as three levels:

• major revision (increments with massive changes, additions, and enhancements)
• minor revision (increments with backwards-compatible changes to the major revision), and
• patchlevel (increments with fixes to the minor revision)

The macro SDL_VERSION can be used to populate this structure with information.

Related Functions

• SDL_GetVersion

Related Macros

• SDL_VERSIONNUM

This macro turns the version numbers into a numeric value:

• (1,2,3) -> (1203)

SDL_VERSIONNUM(X, Y, Z)
((X)*1000 + (Y)*100 + (Z))

• This assumes that there will never be more than 100 patchlevels.

• SDL_COMPILEDVERSION

This is the version number macro for the current SDL version.

SDL_COMPILEDVERSION \
SDL_VERSIONNUM(SDL_MAJOR_VERSION, SDL_MINOR_VERSION, SDL_PATCHLEVEL)

• SDL_VERSION_ATLEAST

This macro will evaluate to true if compiled with SDL at least X.Y.Z.

SDL_VERSION_ATLEAST(X, Y, Z) \
(SDL_COMPILEDVERSION >= SDL_VERSIONNUM(X, Y, Z))

CategoryStruct