mcs/class/corlib/System/Version.cs

   1 //
   2 // System.Version.cs
   3 //
   4 // Author:
   5 //   Miguel de Icaza (miguel@ximian.com)
   6 //
   7 // (C) Ximian, Inc.  http://www.ximian.com
   8 //
   9
  10 using System.Globalization;
  11
  12 namespace System {
  13
  14         [Serializable]
  15         public sealed class Version : ICloneable, IComparable {
  16
  17                 int major, minor, build, revision;
  18
  19                 private const int UNDEFINED = -1;
  20
  21                 private void CheckedSet (int defined, int major, int minor, int build, int revision)
  22                 {
  23                         // defined should be 2, 3 or 4
  24
  25                         if (major < 0) {
  26                                 throw new ArgumentOutOfRangeException ("major");
  27                         }
  28                         this.major = major;
  29
  30                         if (minor < 0) {
  31                                 throw new ArgumentOutOfRangeException ("minor");
  32                         }
  33                         this.minor = minor;
  34
  35                         if (defined == 2) {
  36                                 this.build = UNDEFINED;
  37                                 this.revision = UNDEFINED;
  38                                 return;
  39                         }
  40
  41                         if (build < 0) {
  42                                 throw new ArgumentOutOfRangeException ("build");
  43                         }
  44                         this.build = build;
  45
  46                         if (defined == 3) {
  47                                 this.revision = UNDEFINED;
  48                                 return;
  49                         }
  50
  51                         if (revision < 0) {
  52                                 throw new ArgumentOutOfRangeException ("revision");
  53                         }
  54                         this.revision = revision;
  55                 }
  56
  57                 public Version ()
  58                 {
  59                         CheckedSet (2, 0, 0, -1, -1);
  60                 }
  61
  62                 public Version (string version)
  63                 {
  64                         int n;
  65                         string [] vals;
  66                         int major = -1, minor = -1, build = -1, revision = -1;
  67
  68                         if (version == null) {
  69                                 throw new ArgumentNullException ("version");
  70                         }
  71
  72                         vals = version.Split (new Char [] {'.'});
  73                         n = vals.Length;
  74
  75                         if (n < 2 || n > 4) {
  76                                 throw new ArgumentException (Locale.GetText ("There must be 2, 3 or 4 components in the version string"));
  77                         }
  78
  79                         if (n > 0)
  80                                 major = int.Parse (vals [0]);
  81                         if (n > 1)
  82                                 minor = int.Parse (vals [1]);
  83                         if (n > 2)
  84                                 build = int.Parse (vals [2]);
  85                         if (n > 3)
  86                                 revision = int.Parse (vals [3]);
  87
  88                         CheckedSet (n, major, minor, build, revision);
  89                 }
  90
  91                 public Version (int major, int minor)
  92                 {
  93                         CheckedSet (2, major, minor, 0, 0);
  94                 }
  95
  96                 public Version (int major, int minor, int build)
  97                 {
  98                         CheckedSet (3, major, minor, build, 0);
  99                 }
 100
 101                 public Version (int major, int minor, int build, int revision)
 102                 {
 103                         CheckedSet (4, major, minor, build, revision);
 104                 }
 105
 106                 public int Build {
 107                         get {
 108                                 return build;
 109                         }
 110                 }
 111
 112                 public int Major {
 113                         get {
 114                                 return major;
 115                         }
 116                 }
 117
 118                 public int Minor {
 119                         get {
 120                                 return minor;
 121                         }
 122                 }
 123
 124                 public int Revision {
 125                         get {
 126                                 return revision;
 127                         }
 128                 }
 129
 130                 public object Clone ()
 131                 {
 132                         return new Version (major, minor, build, revision);
 133                 }
 134
 135                 public int CompareTo (object version)
 136                 {
 137                         Version v;
 138
 139                         // LAMESPEC: Docs are unclear whether an
 140                         // ArgumentNullException should be thrown are
 141                         // that a value > 0 should be returned.
 142                         if (version == null)
 143                                 return 1;
 144                         //      throw new ArgumentNullException ("version");
 145
 146                         if (! (version is Version))
 147                                 throw new ArgumentException (Locale.GetText ("Argument to Version.CompareTo must be a Version"));
 148
 149                         v = version as Version;
 150
 151                         if (this.major > v.major)
 152                                 return 1;
 153                         else if (this.major < v.major)
 154                                 return -1;
 155
 156                         if (this.minor > v.minor)
 157                                 return 1;
 158                         else if (this.minor < v.minor)
 159                                 return -1;
 160
 161                         if (this.build > v.build)
 162                                 return 1;
 163                         else if (this.build < v.build)
 164                                 return -1;
 165
 166                         if (this.revision > v.revision)
 167                                 return 1;
 168                         else if (this.revision < v.revision)
 169                                 return -1;
 170
 171                         return 0;
 172                 }
 173
 174                 public override bool Equals (object obj)
 175                 {
 176                         Version x;
 177
 178                         if (obj == null || !(obj is Version))
 179                                 return false;
 180
 181                         x = (Version) obj;
 182
 183                         if ((x.major == major) &&
 184                             (x.minor == minor) &&
 185                             (x.build == build) &&
 186                             (x.revision == revision))
 187                                 return true;
 188                         return false;
 189                 }
 190
 191                 public override int GetHashCode ()
 192                 {
 193                         return (revision << 24) | (build << 16) | (minor << 8) | major;
 194                 }
 195
 196                 // <summary>
 197                 //   Returns a stringified representation of the version, format:
 198                 //   major.minor[.build[.revision]]
 199                 // </summary>
 200                 public override string ToString ()
 201                 {
 202                         string mm = major.ToString () + "." + minor.ToString ();
 203
 204                         if (build != UNDEFINED)
 205                                 mm = mm + "." + build.ToString ();
 206                         if (revision != UNDEFINED)
 207                                 mm = mm + "." + revision.ToString ();
 208
 209                         return mm;
 210                 }
 211
 212                 // <summary>
 213                 //    LAME: This API is lame, since there is no way of knowing
 214                 //    how many fields a Version object has, it is unfair to throw
 215                 //    an ArgumentException, but this is what the spec claims.
 216                 //
 217                 //    ie, Version a = new Version (1, 2);  a.ToString (3) should
 218                 //    throw the expcetion.
 219                 // </summary>
 220                 public string ToString (int fields)
 221                 {
 222                         if (fields == 0)
 223                                 return "";
 224                         if (fields == 1)
 225                                 return major.ToString ();
 226                         if (fields == 2)
 227                                 return major.ToString () + "." + minor.ToString ();
 228                         if (fields == 3){
 229                                 if (build == UNDEFINED)
 230                                         throw new ArgumentException (Locale.GetText ("fields is larger than the number of components defined in this instance"));
 231                                 return major.ToString () + "." + minor.ToString () + "." +
 232                                         build.ToString ();
 233                         }
 234                         if (fields == 4){
 235                                 if (build == UNDEFINED || revision == UNDEFINED)
 236                                         throw new ArgumentException (Locale.GetText ("fields is larger than the number of components defined in this instance"));
 237                                 return major.ToString () + "." + minor.ToString () + "." +
 238                                         build.ToString () + "." + revision.ToString ();
 239                         }
 240                         throw new ArgumentException (Locale.GetText ("Invalid fields parameter: ") + fields.ToString());
 241                 }
 242
 243                 public static bool operator== (Version v1, Version v2)
 244                 {
 245                         return v1.Equals (v2);
 246                 }
 247
 248                 public static bool operator!= (Version v1, Version v2)
 249                 {
 250                         return !v1.Equals (v2);
 251                 }
 252
 253                 public static bool operator> (Version v1, Version v2)
 254                 {
 255                         return v1.CompareTo (v2) > 0;
 256                 }
 257
 258                 public static bool operator>= (Version v1, Version v2)
 259                 {
 260                         return v1.CompareTo (v2) >= 0;
 261                 }
 262
 263                 public static bool operator< (Version v1, Version v2)
 264                 {
 265                         return v1.CompareTo (v2) < 0;
 266                 }
 267
 268                 public static bool operator<= (Version v1, Version v2)
 269                 {
 270                         return v1.CompareTo (v2) <= 0;
 271                 }
 272
 273         }
 274 }
 275
 276
 277