//===- VersionTuple.h - Version Number Handling -----------------*- C++ -*-===// // // The LLVM Compiler Infrastructure // // This file is distributed under the University of Illinois Open Source // License. See LICENSE.TXT for details. // //===----------------------------------------------------------------------===// /// /// \file /// Defines the llvm::VersionTuple class, which represents a version in /// the form major[.minor[.subminor]]. /// //===----------------------------------------------------------------------===// #ifndef LLVM_SUPPORT_VERSIONTUPLE_H #define LLVM_SUPPORT_VERSIONTUPLE_H #include "llvm/ADT/Optional.h" #include "llvm/ADT/StringRef.h" #include "llvm/Support/raw_ostream.h" #include <string> #include <tuple> namespace llvm { /// Represents a version number in the form major[.minor[.subminor[.build]]]. class VersionTuple { unsigned Major : 32; unsigned Minor : 31; unsigned HasMinor : 1; unsigned Subminor : 31; unsigned HasSubminor : 1; unsigned Build : 31; unsigned HasBuild : 1; public: VersionTuple() : Major(0), Minor(0), HasMinor(false), Subminor(0), HasSubminor(false), Build(0), HasBuild(false) {} explicit VersionTuple(unsigned Major) : Major(Major), Minor(0), HasMinor(false), Subminor(0), HasSubminor(false), Build(0), HasBuild(false) {} explicit VersionTuple(unsigned Major, unsigned Minor) : Major(Major), Minor(Minor), HasMinor(true), Subminor(0), HasSubminor(false), Build(0), HasBuild(false) {} explicit VersionTuple(unsigned Major, unsigned Minor, unsigned Subminor) : Major(Major), Minor(Minor), HasMinor(true), Subminor(Subminor), HasSubminor(true), Build(0), HasBuild(false) {} explicit VersionTuple(unsigned Major, unsigned Minor, unsigned Subminor, unsigned Build) : Major(Major), Minor(Minor), HasMinor(true), Subminor(Subminor), HasSubminor(true), Build(Build), HasBuild(true) {} /// Determine whether this version information is empty /// (e.g., all version components are zero). bool empty() const { return Major == 0 && Minor == 0 && Subminor == 0 && Build == 0; } /// Retrieve the major version number. unsigned getMajor() const { return Major; } /// Retrieve the minor version number, if provided. Optional<unsigned> getMinor() const { if (!HasMinor) return None; return Minor; } /// Retrieve the subminor version number, if provided. Optional<unsigned> getSubminor() const { if (!HasSubminor) return None; return Subminor; } /// Retrieve the build version number, if provided. Optional<unsigned> getBuild() const { if (!HasBuild) return None; return Build; } /// Determine if two version numbers are equivalent. If not /// provided, minor and subminor version numbers are considered to be zero. friend bool operator==(const VersionTuple &X, const VersionTuple &Y) { return X.Major == Y.Major && X.Minor == Y.Minor && X.Subminor == Y.Subminor && X.Build == Y.Build; } /// Determine if two version numbers are not equivalent. /// /// If not provided, minor and subminor version numbers are considered to be /// zero. friend bool operator!=(const VersionTuple &X, const VersionTuple &Y) { return !(X == Y); } /// Determine whether one version number precedes another. /// /// If not provided, minor and subminor version numbers are considered to be /// zero. friend bool operator<(const VersionTuple &X, const VersionTuple &Y) { return std::tie(X.Major, X.Minor, X.Subminor, X.Build) < std::tie(Y.Major, Y.Minor, Y.Subminor, Y.Build); } /// Determine whether one version number follows another. /// /// If not provided, minor and subminor version numbers are considered to be /// zero. friend bool operator>(const VersionTuple &X, const VersionTuple &Y) { return Y < X; } /// Determine whether one version number precedes or is /// equivalent to another. /// /// If not provided, minor and subminor version numbers are considered to be /// zero. friend bool operator<=(const VersionTuple &X, const VersionTuple &Y) { return !(Y < X); } /// Determine whether one version number follows or is /// equivalent to another. /// /// If not provided, minor and subminor version numbers are considered to be /// zero. friend bool operator>=(const VersionTuple &X, const VersionTuple &Y) { return !(X < Y); } /// Retrieve a string representation of the version number. std::string getAsString() const; /// Try to parse the given string as a version number. /// \returns \c true if the string does not match the regular expression /// [0-9]+(\.[0-9]+){0,3} bool tryParse(StringRef string); }; /// Print a version number. raw_ostream &operator<<(raw_ostream &Out, const VersionTuple &V); } // end namespace llvm #endif // LLVM_SUPPORT_VERSIONTUPLE_H