185
|
1 /* |
|
2 * Pack.h -- binary data serialization |
|
3 * |
|
4 * Copyright (c) 2013 David Demelier <markand@malikania.fr> |
|
5 * |
|
6 * Permission to use, copy, modify, and/or distribute this software for any |
|
7 * purpose with or without fee is hereby granted, provided that the above |
|
8 * copyright notice and this permission notice appear in all copies. |
|
9 * |
|
10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES |
|
11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF |
|
12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR |
|
13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES |
|
14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN |
|
15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF |
|
16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
|
17 */ |
|
18 |
|
19 #ifndef _PACK_H_ |
|
20 #define _PACK_H_ |
|
21 |
|
22 #include <cstdint> |
|
23 #include <fstream> |
|
24 #include <stdexcept> |
|
25 #include <string> |
|
26 |
|
27 /** |
|
28 * @class Pack |
|
29 * @brief Serialize binary data to files |
|
30 * |
|
31 * This class write and read binary data from files. It currently |
|
32 * support: |
|
33 * uint8_t, |
|
34 * uint16_t, |
|
35 * uint32_t, |
|
36 * uint64_t |
|
37 */ |
|
38 class Pack { |
|
39 public: |
|
40 /** |
|
41 * @enum Endian |
|
42 * @brief Endian mode |
|
43 */ |
|
44 enum Endian { |
|
45 Little, //! Little endian |
|
46 Big //! Big endian |
|
47 }; |
|
48 |
|
49 public: |
219
|
50 /** |
|
51 * Host system endian mode. |
|
52 */ |
185
|
53 static const Endian mode; |
|
54 |
|
55 /** |
|
56 * @struct TypeInfo |
|
57 * @brief Type information |
|
58 * |
|
59 * Used for conversions. |
|
60 */ |
|
61 template <typename T> |
|
62 struct TypeInfo { |
|
63 static const bool supported = false; |
|
64 }; |
|
65 |
|
66 /** |
266
|
67 * Convert data only if the requested endian is different. |
185
|
68 * |
|
69 * @param value the value to convert if needed |
|
70 * @param endian the endian mode |
|
71 * @return the converted value |
|
72 */ |
|
73 template <typename T> |
266
|
74 static inline T convert(T value, Endian endian) |
|
75 { |
|
76 static_assert(TypeInfo<T>::supported, "unsupported type"); |
|
77 |
|
78 if (endian != mode) |
|
79 return TypeInfo<T>::convert(value, endian); |
|
80 |
|
81 return value; |
|
82 } |
|
83 |
|
84 /** |
|
85 * Write nothing, stop recursion. |
|
86 */ |
|
87 static void write(std::ostream &, Endian) |
|
88 { |
|
89 } |
185
|
90 |
|
91 /** |
266
|
92 * Write binary data to the stream. |
|
93 * |
|
94 * @param out the output stream |
|
95 * @param endian the endian mode |
|
96 * @param args the arguments |
|
97 * @throw std::runtime_exception on error |
|
98 */ |
|
99 template <typename T, typename... Args> |
|
100 static void write(std::ostream &out, Endian endian, const T &value, const Args&... args) |
|
101 { |
|
102 T ret = convert(value, endian); |
|
103 out.write(reinterpret_cast<const char *>(&ret), TypeInfo<T>::size); |
|
104 write(out, endian, args...); |
|
105 } |
|
106 |
|
107 /** |
|
108 * Write binary data to the file. |
185
|
109 * |
|
110 * @param path the path to the file |
|
111 * @param endian the endian mode |
|
112 * @param args the arguments |
|
113 * @throw std::runtime_exception on error |
|
114 */ |
|
115 template <typename... Args> |
266
|
116 static void write(const std::string &path, Endian endian, const Args&... args) |
185
|
117 { |
|
118 std::ofstream out; |
|
119 |
|
120 out.open(path, std::ios_base::binary); |
|
121 if (!out.is_open()) |
|
122 throw std::runtime_error("Can't open file for writing"); |
|
123 |
266
|
124 write(out, endian, args...); |
|
125 } |
|
126 |
|
127 /** |
|
128 * Read nothing, stop recursion. |
|
129 */ |
|
130 static void read(std::istream &, Endian) |
|
131 { |
185
|
132 } |
|
133 |
|
134 /** |
266
|
135 * Read binary data from the stream. |
|
136 * |
|
137 * @param in the input stream |
|
138 * @param endian the endian mode |
|
139 * @param args the arguments |
|
140 * @throw std::runtime_exception on error |
|
141 */ |
|
142 template <typename T, typename... Args> |
|
143 static void read(std::istream &in, Endian endian, T &value, Args&... args) |
|
144 { |
|
145 in.read(reinterpret_cast<char *>(&value), TypeInfo<T>::size); |
|
146 value = convert(value, endian); |
|
147 read(in, endian, args...); |
|
148 } |
|
149 |
|
150 /** |
|
151 * Read binary data from the file. |
185
|
152 * |
|
153 * @param path the path to the file |
|
154 * @param endian the endian mode |
|
155 * @param args the arguments |
|
156 * @throw std::runtime_exception on error |
|
157 */ |
|
158 template <typename... Args> |
266
|
159 static void read(const std::string &path, Endian endian, Args&&... args) |
185
|
160 { |
|
161 std::ifstream in; |
|
162 |
|
163 in.open(path, std::ios_base::binary); |
|
164 if (!in.is_open()) |
|
165 throw std::runtime_error("Can't open file for reading"); |
|
166 |
266
|
167 read(in, endian, args...); |
185
|
168 } |
|
169 }; |
|
170 |
|
171 template <> |
|
172 struct Pack::TypeInfo<uint8_t> { |
266
|
173 static constexpr const bool supported = true; |
|
174 static constexpr const size_t size = sizeof (uint8_t); |
|
175 |
|
176 static constexpr uint8_t convert(uint8_t v, Endian endian) |
|
177 { |
|
178 return v; |
|
179 } |
185
|
180 }; |
|
181 |
|
182 template <> |
|
183 struct Pack::TypeInfo<uint16_t> { |
266
|
184 static constexpr const bool supported = true; |
|
185 static constexpr const size_t size = sizeof (uint16_t); |
|
186 |
|
187 static constexpr uint16_t convert(uint16_t v, Endian endian) |
|
188 { |
|
189 return (((v >> 8) & 0x00FFL) | ((v << 8) & 0xFF00L)); |
|
190 } |
185
|
191 }; |
|
192 |
|
193 template <> |
|
194 struct Pack::TypeInfo<uint32_t> { |
266
|
195 static constexpr const bool supported = true; |
|
196 static constexpr const size_t size = sizeof (uint32_t); |
|
197 |
|
198 static constexpr uint32_t convert(uint32_t v, Endian endian) |
|
199 { |
|
200 return ((((v) >> 24) & 0x000000FFL) |
|
201 | (((v) >> 8) & 0x0000FF00L) |
|
202 | (((v) << 8) & 0x00FF0000L) |
|
203 | (((v) << 24) & 0xFF000000L)); |
|
204 } |
185
|
205 }; |
|
206 |
|
207 template <> |
|
208 struct Pack::TypeInfo<uint64_t> { |
266
|
209 static constexpr const bool supported = true; |
|
210 static constexpr const size_t size = sizeof (uint64_t); |
185
|
211 |
266
|
212 static constexpr uint64_t convert(uint64_t v, Endian endian) |
|
213 { |
185
|
214 return ((((v) & 0xff00000000000000ull) >> 56) |
|
215 | (((v) & 0x00ff000000000000ull) >> 40) |
|
216 | (((v) & 0x0000ff0000000000ull) >> 24) |
|
217 | (((v) & 0x000000ff00000000ull) >> 8 ) |
|
218 | (((v) & 0x00000000ff000000ull) << 8 ) |
|
219 | (((v) & 0x0000000000ff0000ull) << 24) |
|
220 | (((v) & 0x000000000000ff00ull) << 40) |
|
221 | (((v) & 0x00000000000000ffull) << 56)); |
266
|
222 } |
|
223 }; |
185
|
224 |
|
225 #endif // !_PACK_H_ |