1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
/*********************************************************************/
// dar - disk archive - a backup/restoration program
// Copyright (C) 2002-2020 Denis Corbin
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License
// as published by the Free Software Foundation; either version 2
// of the License, or (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
//
// to contact the author : http://dar.linux.free.fr/email.html
/*********************************************************************/
/// \file archive_version.hpp
/// \brief class archive_version that rules which archive format to follow
/// \ingroup API
#ifndef ARCHIVE_VERSION_HPP
#define ARCHIVE_VERSION_HPP
#include "../my_config.h"
#include <string>
#include "integers.hpp"
namespace libdar
{
/// \addtogroup API
/// @{
// no need to dig into this from API
class generic_file;
/// class archive_version manages the version of the archive format
class archive_version
{
public:
/// archive_version constructor
/// \param[in] x is the version number
/// \param[in] fix is a decimal-like
/// \note the fix argument must only be used when the current stable version need to be increased
/// due to a bug fix. This let the concurrent development version to keep the same version (usually x+1)
/// while having the stable version using a slightly different format to fix a bug.
archive_version(U_16 x = 0, unsigned char fix = 0);
archive_version(const archive_version & ref) = default;
archive_version(archive_version && ref) noexcept = default;
archive_version & operator = (const archive_version & ref) = default;
archive_version & operator = (archive_version && ref) noexcept = default;
~archive_version() = default;
bool operator < (const archive_version & ref) const { return value() < ref.value(); };
bool operator >= (const archive_version & ref) const { return value() >= ref.value(); };
bool operator == (const archive_version & ref) const { return value() == ref.value(); };
bool operator != (const archive_version & ref) const { return value() != ref.value(); };
bool operator > (const archive_version & ref) const { return value() > ref.value(); };
bool operator <= (const archive_version & ref) const { return value() <= ref.value(); };
void dump(generic_file & f) const;
void read(generic_file & f);
/// provides the version information as a human readable string
std::string display() const;
private:
U_16 version;
unsigned char fix;
U_I value() const { return (U_I)(version)*256 + fix; };
static unsigned char to_digit(unsigned char val);
static unsigned char to_char(unsigned char val);
};
extern const archive_version empty_archive_version();
/// @}
} // end of namespace
#endif
|
