#pragma once #ifdef __GNUC__ #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wunused-parameter" #endif //===- VersionTuple.h - Version Number Handling -----------------*- C++ -*-===// // // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. // See https://llvm.org/LICENSE.txt for license information. // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception // //===----------------------------------------------------------------------===// /// /// \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/DenseMapInfo.h" #include "llvm/ADT/Hashing.h" #include "llvm/ADT/Optional.h" #include "llvm/Support/HashBuilder.h" #include #include namespace llvm { class raw_ostream; class StringRef; /// 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 getMinor() const { if (!HasMinor) return None; return Minor; } /// Retrieve the subminor version number, if provided. Optional getSubminor() const { if (!HasSubminor) return None; return Subminor; } /// Retrieve the build version number, if provided. Optional getBuild() const { if (!HasBuild) return None; return Build; } /// Return a version tuple that contains only the first 3 version components. VersionTuple withoutBuild() const { if (HasBuild) return VersionTuple(Major, Minor, Subminor); return *this; } /// Return a version tuple that contains only components that are non-zero. VersionTuple normalize() const { VersionTuple Result = *this; if (Result.Build == 0) { Result.HasBuild = false; if (Result.Subminor == 0) { Result.HasSubminor = false; if (Result.Minor == 0) Result.HasMinor = false; } } return Result; } /// 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); } friend llvm::hash_code hash_value(const VersionTuple &VT) { return llvm::hash_combine(VT.Major, VT.Minor, VT.Subminor, VT.Build); } template friend void addHash(HashBuilderImpl &HBuilder, const VersionTuple &VT) { HBuilder.add(VT.Major, VT.Minor, VT.Subminor, VT.Build); } /// 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); // Provide DenseMapInfo for version tuples. template <> struct DenseMapInfo { static inline VersionTuple getEmptyKey() { return VersionTuple(0x7FFFFFFF); } static inline VersionTuple getTombstoneKey() { return VersionTuple(0x7FFFFFFE); } static unsigned getHashValue(const VersionTuple &Value) { unsigned Result = Value.getMajor(); if (auto Minor = Value.getMinor()) Result = detail::combineHashValue(Result, *Minor); if (auto Subminor = Value.getSubminor()) Result = detail::combineHashValue(Result, *Subminor); if (auto Build = Value.getBuild()) Result = detail::combineHashValue(Result, *Build); return Result; } static bool isEqual(const VersionTuple &LHS, const VersionTuple &RHS) { return LHS == RHS; } }; } // end namespace llvm #endif // LLVM_SUPPORT_VERSIONTUPLE_H #ifdef __GNUC__ #pragma GCC diagnostic pop #endif