OLD | NEW |
1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef BASE_VERSION_H_ | 5 #ifndef BASE_VERSION_H_ |
6 #define BASE_VERSION_H_ | 6 #define BASE_VERSION_H_ |
7 #pragma once | 7 #pragma once |
8 | 8 |
9 #include <string> | 9 #include <string> |
10 #include <vector> | 10 #include <vector> |
11 | 11 |
12 #include "base/base_api.h" | 12 #include "base/base_api.h" |
13 #include "base/basictypes.h" | 13 #include "base/basictypes.h" |
14 #include "base/gtest_prod_util.h" | 14 #include "base/gtest_prod_util.h" |
15 | 15 |
16 // Version represents a dotted version number, like "1.2.3.4", supporting | 16 // Version represents a dotted version number, like "1.2.3.4", supporting |
17 // parsing and comparison. | 17 // parsing and comparison. |
18 // Each component is limited to a uint16. | |
19 class BASE_API Version { | 18 class BASE_API Version { |
20 public: | 19 public: |
21 // Exposed only so that a Version can be stored in STL containers; | 20 // The only thing you can legally do to a default constructed |
22 // any call to the methods below on a default-constructed Version | 21 // Version object is assign to it. |
23 // will DCHECK. | |
24 Version(); | 22 Version(); |
25 | 23 |
26 ~Version(); | 24 // Initializes from a decimal dotted version number, like "0.1.1". |
| 25 // Each component is limited to a uint16. Call IsValid() to learn |
| 26 // the outcome. |
| 27 explicit Version(const std::string& version_str); |
27 | 28 |
28 // The version string must be made up of 1 or more uint16's separated | 29 // Returns true if the object contains a valid version number. |
29 // by '.'. Returns NULL if string is not in this format. | 30 bool IsValid() const; |
| 31 |
| 32 // Returns NULL if the string is not in the proper format. |
30 // Caller is responsible for freeing the Version object once done. | 33 // Caller is responsible for freeing the Version object once done. |
| 34 // DO NOT USE FOR NEWER CODE. |
31 static Version* GetVersionFromString(const std::string& version_str); | 35 static Version* GetVersionFromString(const std::string& version_str); |
32 | 36 |
33 // Creates a copy of this version. Caller takes ownership. | 37 // Creates a copy of this version object. Caller takes ownership. |
| 38 // DO NOT USE FOR NEWER CODE. |
34 Version* Clone() const; | 39 Version* Clone() const; |
35 | 40 |
36 bool Equals(const Version& other) const; | 41 bool Equals(const Version& other) const; |
37 | 42 |
38 // Returns -1, 0, 1 for <, ==, >. | 43 // Returns -1, 0, 1 for <, ==, >. |
39 int CompareTo(const Version& other) const; | 44 int CompareTo(const Version& other) const; |
40 | 45 |
41 // Return the string representation of this version. | 46 // Return the string representation of this version. |
42 const std::string GetString() const; | 47 const std::string GetString() const; |
43 | 48 |
44 const std::vector<uint16>& components() const { return components_; } | 49 const std::vector<uint16>& components() const { return components_; } |
45 | 50 |
46 private: | 51 private: |
47 bool InitFromString(const std::string& version_str); | |
48 | |
49 bool is_valid_; | |
50 std::vector<uint16> components_; | 52 std::vector<uint16> components_; |
51 | |
52 FRIEND_TEST_ALL_PREFIXES(VersionTest, DefaultConstructor); | |
53 FRIEND_TEST_ALL_PREFIXES(VersionTest, GetVersionFromString); | |
54 FRIEND_TEST_ALL_PREFIXES(VersionTest, Compare); | |
55 }; | 53 }; |
56 | 54 |
57 #endif // BASE_VERSION_H_ | 55 #endif // BASE_VERSION_H_ |
OLD | NEW |