blob: 4be85fb848f4d5677e21ca0e31d4c406b3a48dfc (
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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
|
#pragma once
#include <memory>
#include "../ValueBroker.h"
namespace crepe {
class DB;
/**
* \brief Save data manager
*
* This class provides access to a simple key-value store that stores
* - integers (8-64 bit, signed or unsigned)
* - real numbers (float or double)
* - string (std::string)
*
* The underlying database is a key-value store.
*/
class SaveManager {
public:
/**
* \brief Get a read/write reference to a value and initialize it if it does not yet exist
*
* \param key The value key
* \param default_value Value to initialize \c key with if it does not already exist in the database
*
* \return Read/write reference to the value
*/
template <typename T>
ValueBroker<T> get(const std::string & key, const T & default_value);
/**
* \brief Get a read/write reference to a value
*
* \param key The value key
*
* \return Read/write reference to the value
*
* \note Attempting to read this value before it is initialized (i.e. set)
* will result in an exception
*/
template <typename T>
ValueBroker<T> get(const std::string & key);
/**
* \brief Set a value directly
*
* \param key The value key
* \param value The value to store
*/
template <typename T>
void set(const std::string & key, const T & value);
/**
* \brief Check if the save file has a value for this \c key
*
* \param key The value key
*
* \returns True if the key exists, or false if it does not
*/
bool has(const std::string & key);
private:
SaveManager();
virtual ~SaveManager() = default;
private:
/**
* \brief Serialize an arbitrary value to STL string
*
* \tparam T Type of arbitrary value
*
* \returns String representation of value
*/
template <typename T>
std::string serialize(const T &) const noexcept;
/**
* \brief Deserialize an STL string back to type \c T
*
* \tparam T Type of value
* \param value Serialized value
*
* \returns Deserialized value
*/
template <typename T>
T deserialize(const std::string & value) const noexcept;
public:
// singleton
static SaveManager & get_instance();
SaveManager(const SaveManager &) = delete;
SaveManager(SaveManager &&) = delete;
SaveManager & operator=(const SaveManager &) = delete;
SaveManager & operator=(SaveManager &&) = delete;
private:
/**
* \brief Create an instance of DB and return its reference
*
* \returns DB instance
*
* This function exists because DB is a facade class, which can't directly be
* used in the API without workarounds
*
* TODO: better solution
*/
static DB & get_db();
};
} // namespace crepe
|