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
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
|
//
// srecord - Manipulate EPROM load files
// Copyright (C) 2009-2011 Peter Miller
//
// This program is free software; you can redistribute it and/or modify
// it under the terms of the GNU Lesser 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 Lesser General Public License
// along with this program. If not, see <http://www.gnu.org/licenses/>.
//
#ifndef SRECORD_INPUT_FILE_MIF_H
#define SRECORD_INPUT_FILE_MIF_H
#include <srecord/input/file.h>
namespace srecord {
/**
* The srecord::input_file_mif class is used to represent the parse state
* when reading a Memory Initialization File (MIF) formatted file.
*/
class input_file_mif:
public input_file
{
public:
/**
* The destructor.
*/
virtual ~input_file_mif();
/**
* The create class method is used to create new dynamically
* allocated instances of this class.
*
* @param file_name
* The name of the file to be read.
* @returns
* smart pointer to new instance
*/
static pointer create(const std::string &file_name);
protected:
// See base class for documentation.
bool read(record &record);
// See base class for documentation.
const char *get_file_format_name(void) const;
// See base class for documentation.
const char *format_option_name(void) const;
private:
/**
* The constructor.
* It is private on putpose, use the #create class method instead.
*
* @param file_name
* The name of the file to be read.
*/
input_file_mif(const std::string &file_name);
enum state_t
{
state_header,
state_eof,
state_address,
state_data
};
/**
* The state instance variable is used to remember the parse state
* as we progress through the file.
*/
state_t state;
/**
* The address instance variable is used to remember where we are
* up to in the input file, so it may be associated with data bytes.
*/
unsigned long address;
/**
* The lex_radix instance variable is used to remember the numeric
* radix to be used when parsing numbers.
*/
unsigned lex_radix;
/**
* The lex_addr_radix instance variable is used to remember the
* numeric radix to be used when parsing address values.
*/
unsigned lex_addr_radix;
/**
* The lex_data_radix instance variable is used to remember the
* numeric radix to be used when parsing data values.
*/
unsigned lex_data_radix;
enum token_t
{
token_address_radix,
token_begin,
token_bin,
token_bracket_left,
token_bracket_right,
token_colon,
token_content,
token_data_radix,
token_dec,
token_depth,
token_dot,
token_dotdot,
token_end,
token_eof,
token_equals,
token_hex,
token_junk,
token_minus,
token_number,
token_oct,
token_semicolon,
token_width
};
/**
* The lex method is used to obtain the next lexical token from the
* input stream.
*/
token_t lex(void);
/**
* The token_value instance variable is used to remember the
* numeric value of token_number returns from #lex.
*/
long token_value;
/**
* The lex_addr method is used to obtain the next lexical token
* from the input stream, using the address radix.
*/
token_t lex_addr(void);
/**
* The lex_data method is used to obtain the next lexical token
* from the input stream, using the data radix.
*/
token_t lex_data(void);
/**
* The syntax_error method is used to report parse errors when
* reading the file.
*
* @param text
* The text of the error message.
*/
void syntax_error(const char *text);
void get_equals(void);
long get_number(void);
void get_semicolon(void);
int get_radix(void);
void get_colon(void);
unsigned width;
unsigned width_in_bytes;
/**
* The default constructor. Do not use.
*/
input_file_mif();
/**
* The copy constructor. Do not use.
*/
input_file_mif(const input_file_mif &);
/**
* The assignment operator. Do not use.
*/
input_file_mif &operator=(const input_file_mif &);
};
};
// vim: set ts=8 sw=4 et :
#endif // SRECORD_INPUT_FILE_MIF_H
|