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
|
//============================================================================
//
// SSSS tt lll lll
// SS SS tt ll ll
// SS tttttt eeee ll ll aaaa
// SSSS tt ee ee ll ll aa
// SS tt eeeeee ll ll aaaaa -- "An Atari 2600 VCS Emulator"
// SS SS tt ee ll ll aa aa
// SSSS ttt eeeee llll llll aaaaa
//
// Copyright (c) 1995-2008 by Bradford W. Mott and the Stella team
//
// See the file "license" for information on usage and redistribution of
// this file, and for a DISCLAIMER OF ALL WARRANTIES.
//
// $Id: Serializer.hxx,v 1.14 2008/02/06 13:45:22 stephena Exp $
//============================================================================
#ifndef SERIALIZER_HXX
#define SERIALIZER_HXX
#include <fstream>
#include "bspf.hxx"
/**
This class implements a Serializer device, whereby data is
serialized and sent to an output binary file in a system-
independent way.
Bytes are written as characters, integers are written as 4 characters
(32-bit), strings are written as characters prepended by the length of the
string, boolean values are written using a special character pattern.
@author Stephen Anthony
@version $Id: Serializer.hxx,v 1.14 2008/02/06 13:45:22 stephena Exp $
*/
class Serializer
{
public:
/**
Creates a new Serializer device.
Open must be called with a valid file before this Serializer can
be used.
*/
Serializer(void);
/**
Destructor
*/
virtual ~Serializer(void);
public:
/**
Opens the given file for output. Multiple calls to this method
will close previously opened files.
@param fileName The filename to send the serialized data to.
@return Result of opening the file. True on success, false on failure
*/
bool open(const string& fileName);
/**
Closes the current output stream.
*/
void close(void);
/**
Answers whether the serializer is currently opened
*/
bool isOpen(void);
/**
Writes an byte value (8-bit) to the current output stream.
@param value The byte value to write to the output stream.
*/
void putByte(char value);
/**
Writes an int value (32-bit) to the current output stream.
@param value The int value to write to the output stream.
*/
void putInt(int value);
/**
Writes a string to the current output stream.
@param str The string to write to the output stream.
*/
void putString(const string& str);
/**
Writes a boolean value to the current output stream.
@param b The boolean value to write to the output stream.
*/
void putBool(bool b);
private:
// The stream to send the serialized data to.
fstream myStream;
enum {
TruePattern = 0xfe,
FalsePattern = 0x01
};
};
#endif
|