Wiki Page Content

Differences between revisions 7 and 8
Revision 7 as of 2010-04-20 18:59:22
Size: 1687
Editor: SheenaSmith
Comment: added minor macros
Revision 8 as of 2010-04-28 20:43:03
Size: 1774
Editor: SheenaSmith
Comment: add link to major macro
Deletions are marked like this. Additions are marked like this.
Line 28: Line 28:

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

DRAFT

SDL_version

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

Data Fields

Uint8

major

major version

Uint8

minor

minor version

Uint8

patch

update version

Code Examples

Include: Nothing found for "## End 1"!

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

If you are linking to SDL dynamically, then it is possible that the current version will be different than the version you compiled against. This function returns the current version, while SDL_VERSION() is a macro that tells you what version you compiled with.

This function may be called safely at any time, even before SDL_Init().

Related Macros

Related Functions


CategoryAPI, CategoryVersion

You can add your code example here

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.

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

None: SDL_version (last edited 2010-09-03 00:19:43 by SheenaSmith)

(Page Info.)
Feedback
Please include your contact information if you'd like to receive a reply.
Submit