libcruft-util/version.hpp

104 lines
3.0 KiB
C++
Raw Normal View History

2011-05-23 17:18:52 +10:00
/*
2015-04-13 18:05:28 +10:00
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
2011-05-23 17:18:52 +10:00
*
2015-04-13 18:05:28 +10:00
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
2011-05-23 17:18:52 +10:00
*
2012-04-23 13:06:41 +10:00
* Copyright 2010 Danny Robson <danny@nerdcruft.net>
2011-05-23 17:18:52 +10:00
*/
#ifndef __UTIL_VERSION_HPP
#define __UTIL_VERSION_HPP
2011-05-23 17:18:52 +10:00
#include <array>
2011-05-23 17:18:52 +10:00
#include <string>
#include <ostream>
2016-01-19 18:31:35 +11:00
#include <limits>
2011-05-23 17:18:52 +10:00
namespace util {
2013-08-05 21:46:11 +10:00
struct version {
2016-01-19 18:31:35 +11:00
// underlying component value type
using value_t = unsigned;
static_assert (std::numeric_limits<value_t>::max () >= 2100'00'00,
"value_t must be sufficient to store a reasonable future year in YYYYMMDD format");
/// type of release.
///
/// * must be sorted from earliest to latest
/// * specific values aren't currently guaranteed.
2013-08-05 21:46:11 +10:00
enum release_t {
2016-01-19 18:31:35 +11:00
ALPHA,
BETA,
GAMMA,
PRODUCTION
2013-08-05 21:46:11 +10:00
};
version ();
version (unsigned _major);
version (unsigned _major, unsigned _minor);
version (unsigned _major, unsigned _minor, unsigned _point);
version (unsigned _major, unsigned _minor, unsigned _point, unsigned _build);
explicit version (const std::string& str);
explicit version (const char *str);
2013-08-05 21:46:11 +10:00
void sanity (void) const;
2016-01-19 18:31:35 +11:00
// named component indices
//
// * must start from zero and be monotonically increasing
enum offset_t {
MAJOR = 0,
MINOR = 1,
POINT = 2,
BUILD = 3
2013-08-05 21:46:11 +10:00
};
// fuck you too freebsd
#ifdef major
#undef major
#endif
#ifdef minor
#undef minor
#endif
2016-01-19 18:31:35 +11:00
unsigned major (void) const;
unsigned minor (void) const;
unsigned point (void) const;
unsigned build (void) const;
const unsigned* begin (void) const noexcept;
const unsigned* end (void) const noexcept;
const unsigned* cbegin (void) const noexcept;
const unsigned* cend (void) const noexcept;
const unsigned& operator[] (size_t) const;
unsigned& operator[] (size_t);
2013-08-05 21:46:11 +10:00
size_t size;
2016-01-19 18:31:35 +11:00
std::array<unsigned,4u> components;
release_t release = PRODUCTION;
2013-08-05 21:46:11 +10:00
static version parse (const std::string&);
static version parse (const char*);
bool operator< (const version& rhs) const noexcept;
bool operator> (const version& rhs) const noexcept;
bool operator>= (const version& rhs) const noexcept;
bool operator<= (const version& rhs) const noexcept;
bool operator== (const version& rhs) const noexcept;
};
2016-01-19 18:31:35 +11:00
std::ostream& operator<< (std::ostream& os, const util::version& rhs);
}
2013-08-05 21:46:11 +10:00
2011-05-23 17:18:52 +10:00
#endif // __VERSION_HPP