com.ibm.icu.util
Class VersionInfo

java.lang.Object
  com.ibm.icu.util.VersionInfo

All Implemented Interfaces:

Comparable<VersionInfo>

public final class VersionInfo
extends Object
implements Comparable<VersionInfo>

Class to store version numbers of the form major.minor.milli.micro.

Author:

synwee

Status:

Stable ICU 2.6.

Field Summary

static VersionInfo	ICU_DATA_VERSION Deprecated. This API is ICU internal only.
static String	ICU_DATA_VERSION_PATH Deprecated. This API is ICU internal only.
static VersionInfo	ICU_VERSION ICU4J current release version
static VersionInfo	UCOL_BUILDER_VERSION Collation builder code version.
static VersionInfo	UCOL_RUNTIME_VERSION Collation runtime version (sort key generator, string comparisons).
static VersionInfo	UCOL_TAILORINGS_VERSION This is the version of collation tailorings.
static VersionInfo	UNICODE_1_0 Unicode 1.0 version
static VersionInfo	UNICODE_1_0_1 Unicode 1.0.1 version
static VersionInfo	UNICODE_1_1_0 Unicode 1.1.0 version
static VersionInfo	UNICODE_1_1_5 Unicode 1.1.5 version
static VersionInfo	UNICODE_2_0 Unicode 2.0 version
static VersionInfo	UNICODE_2_1_2 Unicode 2.1.2 version
static VersionInfo	UNICODE_2_1_5 Unicode 2.1.5 version
static VersionInfo	UNICODE_2_1_8 Unicode 2.1.8 version
static VersionInfo	UNICODE_2_1_9 Unicode 2.1.9 version
static VersionInfo	UNICODE_3_0 Unicode 3.0 version
static VersionInfo	UNICODE_3_0_1 Unicode 3.0.1 version
static VersionInfo	UNICODE_3_1_0 Unicode 3.1.0 version
static VersionInfo	UNICODE_3_1_1 Unicode 3.1.1 version
static VersionInfo	UNICODE_3_2 Unicode 3.2 version
static VersionInfo	UNICODE_4_0 Unicode 4.0 version
static VersionInfo	UNICODE_4_0_1 Unicode 4.0.1 version
static VersionInfo	UNICODE_4_1 Unicode 4.1 version
static VersionInfo	UNICODE_5_0 Unicode 5.0 version
static VersionInfo	UNICODE_5_1 Unicode 5.1 version
static VersionInfo	UNICODE_5_2 Unicode 5.2 version
static VersionInfo	UNICODE_6_0 Unicode 6.0 version
static VersionInfo	UNICODE_6_1 Unicode 6.1 version

Method Summary

int	compareTo(VersionInfo other) Compares other with this VersionInfo.
boolean	equals(Object other) Checks if this version information is equals to the argument version
static VersionInfo	getInstance(int major) Returns an instance of VersionInfo with the argument version.
static VersionInfo	getInstance(int major, int minor) Returns an instance of VersionInfo with the argument version.
static VersionInfo	getInstance(int major, int minor, int milli) Returns an instance of VersionInfo with the argument version.
static VersionInfo	getInstance(int major, int minor, int milli, int micro) Returns an instance of VersionInfo with the argument version.
static VersionInfo	getInstance(String version) Returns an instance of VersionInfo with the argument version.
int	getMajor() Returns the major version number
int	getMicro() Returns the micro version number
int	getMilli() Returns the milli version number
int	getMinor() Returns the minor version number
static VersionInfo	javaVersion() Deprecated. This API is ICU internal only.
static void	main(String[] args) Main method prints out ICU version information
String	toString() Returns the String representative of VersionInfo in the format of "major.minor.milli.micro"

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

UNICODE_1_0

public static final VersionInfo UNICODE_1_0

Unicode 1.0 version

Status:

Stable ICU 2.6.

UNICODE_1_0_1

public static final VersionInfo UNICODE_1_0_1

Unicode 1.0.1 version

Status:

Stable ICU 2.6.

UNICODE_1_1_0

public static final VersionInfo UNICODE_1_1_0

Unicode 1.1.0 version

Status:

Stable ICU 2.6.

UNICODE_1_1_5

public static final VersionInfo UNICODE_1_1_5

Unicode 1.1.5 version

Status:

Stable ICU 2.6.

UNICODE_2_0

public static final VersionInfo UNICODE_2_0

Unicode 2.0 version

Status:

Stable ICU 2.6.

UNICODE_2_1_2

public static final VersionInfo UNICODE_2_1_2

Unicode 2.1.2 version

Status:

Stable ICU 2.6.

UNICODE_2_1_5

public static final VersionInfo UNICODE_2_1_5

Unicode 2.1.5 version

Status:

Stable ICU 2.6.

UNICODE_2_1_8

public static final VersionInfo UNICODE_2_1_8

Unicode 2.1.8 version

Status:

Stable ICU 2.6.

UNICODE_2_1_9

public static final VersionInfo UNICODE_2_1_9

Unicode 2.1.9 version

Status:

Stable ICU 2.6.

UNICODE_3_0

public static final VersionInfo UNICODE_3_0

Unicode 3.0 version

Status:

Stable ICU 2.6.

UNICODE_3_0_1

public static final VersionInfo UNICODE_3_0_1

Unicode 3.0.1 version

Status:

Stable ICU 2.6.

UNICODE_3_1_0

public static final VersionInfo UNICODE_3_1_0

Unicode 3.1.0 version

Status:

Stable ICU 2.6.

UNICODE_3_1_1

public static final VersionInfo UNICODE_3_1_1

Unicode 3.1.1 version

Status:

Stable ICU 2.6.

UNICODE_3_2

public static final VersionInfo UNICODE_3_2

Unicode 3.2 version

Status:

Stable ICU 2.6.

UNICODE_4_0

public static final VersionInfo UNICODE_4_0

Unicode 4.0 version

Status:

Stable ICU 2.6.

UNICODE_4_0_1

public static final VersionInfo UNICODE_4_0_1

Unicode 4.0.1 version

Status:

Stable ICU 3.4.

UNICODE_4_1

public static final VersionInfo UNICODE_4_1

Unicode 4.1 version

Status:

Stable ICU 3.4.

UNICODE_5_0

public static final VersionInfo UNICODE_5_0

Unicode 5.0 version

Status:

Stable ICU 3.4.

UNICODE_5_1

public static final VersionInfo UNICODE_5_1

Unicode 5.1 version

Status:

Stable ICU 4.2.

UNICODE_5_2

public static final VersionInfo UNICODE_5_2

Unicode 5.2 version

Status:

Stable ICU 4.4.

UNICODE_6_0

public static final VersionInfo UNICODE_6_0

Unicode 6.0 version

Status:

Stable ICU 4.6.

UNICODE_6_1

public static final VersionInfo UNICODE_6_1

Unicode 6.1 version

Status:

Stable ICU 49.

ICU_VERSION

public static final VersionInfo ICU_VERSION

ICU4J current release version

Status:

Stable ICU 2.8.

ICU_DATA_VERSION_PATH

public static final String ICU_DATA_VERSION_PATH

Deprecated. This API is ICU internal only.

Data version string for ICU's internal data. Used for appending to data path (e.g. icudt43b)

See Also:

Constant Field Values

Status:

Internal. This API is ICU internal only.

ICU_DATA_VERSION

public static final VersionInfo ICU_DATA_VERSION

Deprecated. This API is ICU internal only.

Data version in ICU4J.

Status:

Internal. This API is ICU internal only.

UCOL_RUNTIME_VERSION

public static final VersionInfo UCOL_RUNTIME_VERSION

Collation runtime version (sort key generator, string comparisons). If the version is different, sort keys for the same string could be different. This value may change in subsequent releases of ICU.

Status:

Stable ICU 2.8.

UCOL_BUILDER_VERSION

public static final VersionInfo UCOL_BUILDER_VERSION

Collation builder code version. When this is different, the same tailoring might result in assigning different collation elements to code points. This value may change in subsequent releases of ICU.

Status:

Stable ICU 2.8.

UCOL_TAILORINGS_VERSION

public static final VersionInfo UCOL_TAILORINGS_VERSION

This is the version of collation tailorings. This value may change in subsequent releases of ICU.

Status:

Stable ICU 2.8.

Method Detail

getInstance

public static VersionInfo getInstance(String version)

Returns an instance of VersionInfo with the argument version.

Parameters:

version - version String in the format of "major.minor.milli.micro" or "major.minor.milli" or "major.minor" or "major", where major, minor, milli, micro are non-negative numbers <= 255. If the trailing version numbers are not specified they are taken as 0s. E.g. Version "3.1" is equivalent to "3.1.0.0".

Returns:

an instance of VersionInfo with the argument version.

Throws:

IllegalArgumentException - when the argument version is not in the right format

Status:

Stable ICU 2.6.

getInstance

public static VersionInfo getInstance(int major,
                                      int minor,
                                      int milli,
                                      int micro)

Returns an instance of VersionInfo with the argument version.

Parameters:

major - major version, non-negative number <= 255.

minor - minor version, non-negative number <= 255.

milli - milli version, non-negative number <= 255.

micro - micro version, non-negative number <= 255.

Throws:

IllegalArgumentException - when either arguments are negative or > 255

Status:

Stable ICU 2.6.

getInstance

public static VersionInfo getInstance(int major,
                                      int minor,
                                      int milli)

Returns an instance of VersionInfo with the argument version. Equivalent to getInstance(major, minor, milli, 0).

Parameters:

major - major version, non-negative number <= 255.

minor - minor version, non-negative number <= 255.

milli - milli version, non-negative number <= 255.

Throws:

IllegalArgumentException - when either arguments are negative or > 255

Status:

Stable ICU 2.6.

getInstance

public static VersionInfo getInstance(int major,
                                      int minor)

Returns an instance of VersionInfo with the argument version. Equivalent to getInstance(major, minor, 0, 0).

Parameters:

major - major version, non-negative number <= 255.

minor - minor version, non-negative number <= 255.

Throws:

IllegalArgumentException - when either arguments are negative or > 255

Status:

Stable ICU 2.6.

getInstance

public static VersionInfo getInstance(int major)

Returns an instance of VersionInfo with the argument version. Equivalent to getInstance(major, 0, 0, 0).

Parameters:

major - major version, non-negative number <= 255.

Throws:

IllegalArgumentException - when either arguments are negative or > 255

Status:

Stable ICU 2.6.

javaVersion

public static VersionInfo javaVersion()

Deprecated. This API is ICU internal only.

Status:

Internal. This API is ICU internal only.

toString

public String toString()

Returns the String representative of VersionInfo in the format of "major.minor.milli.micro"

Overrides:

toString in class Object

Returns:

String representative of VersionInfo

Status:

Stable ICU 2.6.

getMajor

public int getMajor()

Returns the major version number

Returns:

the major version number

Status:

Stable ICU 2.6.

getMinor

public int getMinor()

Returns the minor version number

Returns:

the minor version number

Status:

Stable ICU 2.6.

getMilli

public int getMilli()

Returns the milli version number

Returns:

the milli version number

Status:

Stable ICU 2.6.

getMicro

public int getMicro()

Returns the micro version number

Returns:

the micro version number

Status:

Stable ICU 2.6.

equals

public boolean equals(Object other)

Checks if this version information is equals to the argument version

Overrides:

equals in class Object

Parameters:

other - object to be compared

Returns:

true if other is equals to this object's version information, false otherwise

Status:

Stable ICU 2.6.

compareTo

public int compareTo(VersionInfo other)

Compares other with this VersionInfo.

Specified by:

compareTo in interface Comparable<VersionInfo>

Parameters:

other - VersionInfo to be compared

Returns:

0 if the argument is a VersionInfo object that has version information equals to this object. Less than 0 if the argument is a VersionInfo object that has version information greater than this object. Greater than 0 if the argument is a VersionInfo object that has version information less than this object.

Status:

Stable ICU 2.6.

main

public static void main(String[] args)

Main method prints out ICU version information

Parameters:

args - arguments (currently not used)

Status:

Stable ICU 4.6.