U_VERSION

Return UI Toolkit version number

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
xcall U_VERSION([version][, version_full])

Arguments

version

(optional) Returned with the current UI Toolkit version with a one-character version number. (a)

version_full

(optional) Returned with the current Toolkit version with a two-digit version number. (a)

Discussion

U_VERSION returns the current Toolkit version. If your application is linked against tklib.elb, tklib_qcheck.elb, TKLIB_SH.EXE or uses Synergex.SynergyDE.tklib.dll, version and version_full return the version of the ELB or DLL in use.

Version is returned in the form v.r.mm, where v is the major version number, r is the major revision number, and mm is the minor revision number. For the major version number (v), values higher than 9 are represented by capital Latin letters: A for 10, B for 11, and so forth.

Version_full is returned in the form vv.r.mm, where vv is the major version number, r is the major revision number, and mm is the minor revision number. The major version number (vv) is in decimal notation, so a major version higher than 9 is represented by two decimal digits (10, 11, etc.). A major version lower than 10 is represented by a single decimal digit preceded by a space (i.e., “ 9”).

Examples

In the following example, vers is returned with the number of the UI Toolkit version currently in use. For example, if the current version is 9.3, vers will contain “ 9.3.1”:

xcall u_version(vers)

If the current version is 10.3, vers in the following will contain “A.3.1”, and vers_full will contain “10.3.1”:

xcall u_version(vers, vers_full)