15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef BASE_VERSION_H_ 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define BASE_VERSION_H_ 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <string> 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <vector> 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/base_export.h" 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/basictypes.h" 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)namespace base { 15c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Version represents a dotted version number, like "1.2.3.4", supporting 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// parsing and comparison. 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class BASE_EXPORT Version { 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The only thing you can legally do to a default constructed 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Version object is assign to it. 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Version(); 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ~Version(); 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Initializes from a decimal dotted version number, like "0.1.1". 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Each component is limited to a uint16. Call IsValid() to learn 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the outcome. 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) explicit Version(const std::string& version_str); 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns true if the object contains a valid version number. 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool IsValid() const; 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns true if the version wildcard string is valid. The version wildcard 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // string may end with ".*" (e.g. 1.2.*, 1.*). Any other arrangement with "*" 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // is invalid (e.g. 1.*.3 or 1.2.3*). This functions defaults to standard 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Version behavior (IsValid) if no wildcard is present. 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static bool IsValidWildcardString(const std::string& wildcard_string); 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Commonly used pattern. Given a valid version object, compare if a 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |version_str| results in a newer version. Returns true if the 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // string represents valid version and if the version is greater than 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // than the version of this object. 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool IsOlderThan(const std::string& version_str) const; 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool Equals(const Version& other) const; 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns -1, 0, 1 for <, ==, >. 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int CompareTo(const Version& other) const; 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Given a valid version object, compare if a |wildcard_string| results in a 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // newer version. This function will default to CompareTo if the string does 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // not end in wildcard sequence ".*". IsValidWildcard(wildcard_string) must be 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // true before using this function. 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int CompareToWildcardString(const std::string& wildcard_string) const; 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Return the string representation of this version. 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const std::string GetString() const; 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const std::vector<uint16>& components() const { return components_; } 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint16> components_; 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 66c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)} // namespace base 67c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 68c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)// TODO(xhwang) remove this when all users are updated to explicitly use the 69c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)// namespace 70c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)using base::Version; 71c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif // BASE_VERSION_H_ 73