Version:   Racket Version Checking
1 Installed Patch Level
patchlevel
2 Checking Available Versions
check-version
3 Version Utilities
valid-version?
version->list
version<?
version<=?
alpha-version?
version->integer
6.11

Version: Racket Version Checking

The "version" collection contains several version-related pieces that are used by Racket. See also version from racket/base.

1 Installed Patch Level

 (require version/patchlevel) package: base

Indicates the current installed patch level, which is normally zero, but may be updated by patches to DrRacket.

2 Checking Available Versions

 (require version/check) package: base

procedure

(check-version)  (or/c symbol? list?)

Checks the currently available version on the PLT website (http://download.racket-lang.org) and returns a value that indicates the current state of the current installation:

3 Version Utilities

 (require version/utils) package: base
The version/utils library provides a few of convenient utilities for dealing with version strings. Unless explicitly noted, these functions do not handle legacy versions of Racket.

procedure

(valid-version? v)  boolean?

  v : any/c
Returns #t if v is a valid Racket version string, #f otherwise.

procedure

(version->list str)

  (list/c integer? integer? integer? integer?)
  str : valid-version?
Returns a list of four numbers that the given version string represent. str is assumed to be a valid version.

procedure

(version<? str1 str2)  boolean?

  str1 : valid-version?
  str2 : valid-version?
Returns #t if str1 represents a version that is strictly smaller than str2, #f otherwise. str1 and str2 are assumed to be valid versions.

procedure

(version<=? str1 str2)  boolean?

  str1 : valid-version?
  str2 : valid-version?
Returns #t if str1 represents a version that is smaller than or equal to str2, #f otherwise. str1 and str2 are assumed to be valid versions.

procedure

(alpha-version? str)  boolean?

  str : valid-version?
Returns #t if the version that str represents is an alpha version. str is assumed to be a valid version.

procedure

(version->integer str)  (or/c integer? #f)

  str : string?
Converts the version string into an integer. For version "X.YY.ZZZ.WWW", the result will be XYYZZZWWW. This function works also for legacy Racket versions, by translating "XYY.ZZZ" to XYYZZZ000. The resulting integer can thefore be used to conveniently compare any two (valid) version strings. If the version string is invalid the resulting value is #f.

Note that this is the only function that deals with legacy version strings.