summaryrefslogtreecommitdiff
path: root/src/Digest.hpp
blob: 189b537692603d66090f676a25f63c54c903d024 (plain)
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
93
94
// Copyright (C) 2020-2021 Joel Rosdahl and other contributors
//
// See doc/AUTHORS.adoc for a complete list of contributors.
//
// 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 3 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

#pragma once

#include "Util.hpp"

#include "third_party/fmt/core.h"

#include <cstdint>
#include <string>

// Digest represents the binary form of the final digest (AKA hash or checksum)
// produced by the hash algorithm.
class Digest
{
public:
  Digest() = default;

  // Access the raw byte buffer, which is `size()` bytes long.
  const uint8_t* bytes() const;
  uint8_t* bytes();

  // Size of the digest in bytes.
  constexpr static size_t size();

  // Format the digest as hex string.
  std::string to_string() const;

  bool operator==(const Digest& other) const;
  bool operator!=(const Digest& other) const;

private:
  constexpr static size_t k_digest_size = 20;
  uint8_t m_bytes[k_digest_size];
};

inline const uint8_t*
Digest::bytes() const
{
  return m_bytes;
}

inline uint8_t*
Digest::bytes()
{
  return m_bytes;
}

inline constexpr size_t
Digest::size()
{
  return k_digest_size;
}

inline std::string
Digest::to_string() const
{
  // The first two bytes are encoded as four lowercase base16 digits to maintain
  // compatibility with the cleanup algorithm in older ccache versions and to
  // allow for up to four uniform cache levels. The rest are encoded as
  // lowercase base32hex digits without padding characters.
  const size_t base16_bytes = 2;
  return Util::format_base16(m_bytes, base16_bytes)
         + Util::format_base32hex(m_bytes + base16_bytes,
                                  size() - base16_bytes);
}

inline bool
Digest::operator==(const Digest& other) const
{
  return memcmp(bytes(), other.bytes(), size()) == 0;
}

inline bool
Digest::operator!=(const Digest& other) const
{
  return !(*this == other);
}