compareTo

compareTo

Compares the version information specified in this object to the version information specified in the version parameter.

Method of

InstallVersion object

Syntax

compareTo ( InstallVersion version);
compareTo ( String version);
compareTo ( int major, int minor, int release, int build);

Parameters

The compareTo method has the following parameters:

maj
The major version number.
min
Minor version number.
rev
Revision number.
bld
Build number.
version
An InstallVersion object or a String representing version information in the format "4.1.2.1234".

Returns

If the versions are the same, this method returns 0. If this version object represents a smaller (earlier) version than that represented by the version parameter, this method returns a negative number. Otherwise, it returns a positive number. In particular, this method returns one of the following values:

-4 
This version object has a smaller (earlier) major number than version.
-3 
This version object has a smaller (earlier) minor number than version.
-2 
This version object has a smaller (earlier) release number than version.
-1 
This version object has a smaller (earlier) build number than version.
The version numbers are the same; both objects represent the same version.
This version object has a larger (newer) build number than version.
This version object has a larger (newer) release number than version.
This version object has a larger (newer) minor number than version.
This version object has a larger (newer) major number than version.

The following constants are defined and available for checking the value returned by compareTo:

InstallVersion.MAJOR_DIFF
InstallVersion.MINOR_DIFF
InstallVersion.REL_DIFF
InstallVersion.BLD_DIFF
InstallVersion.EQUAL
InstallVersion.MAJOR_DIFF_MINUS
InstallVersion.MINOR_DIFF_MINUS
InstallVersion.REL_DIFF_MINUS
InstallVersion.BLD_DIFF_MINUS

Example

This code uses the compareTo method to determine whether or not version 3.2.1 of the Royal Airways software has been previously installed:

existingVI = InstallTrigger.getVersion("/royalairways/royalsw");
if ( existingVI.compareTo("3.2.1") <= 0 ) {
   // ... proceed to update ...
   }

Document Tags and Contributors

 Contributors to this page: Sheppy, trevorh, Fredchat, Rod Whiteley
 Last updated by: Sheppy,