1/*****************************************************************************/
2/* */
3/* studyexpr.h */
4/* */
5/* Study an expression tree */
6/* */
7/* */
8/* */
9/* (C) 2003-2012, Ullrich von Bassewitz */
10/* Roemerstrasse 52 */
11/* D-70794 Filderstadt */
12/* EMail: uz@cc65.org */
13/* */
14/* */
15/* This software is provided 'as-is', without any expressed or implied */
16/* warranty. In no event will the authors be held liable for any damages */
17/* arising from the use of this software. */
18/* */
19/* Permission is granted to anyone to use this software for any purpose, */
20/* including commercial applications, and to alter it and redistribute it */
21/* freely, subject to the following restrictions: */
22/* */
23/* 1. The origin of this software must not be misrepresented; you must not */
24/* claim that you wrote the original software. If you use this software */
25/* in a product, an acknowledgment in the product documentation would be */
26/* appreciated but is not required. */
27/* 2. Altered source versions must be plainly marked as such, and must not */
28/* be misrepresented as being the original software. */
29/* 3. This notice may not be removed or altered from any source */
30/* distribution. */
31/* */
32/*****************************************************************************/
33
34
35
36#ifndef STUDYEXPR_H
37#define STUDYEXPR_H
38
39
40
41/* common */
42#include "exprdefs.h"
43
44
45
46/*****************************************************************************/
47/* Data */
48/*****************************************************************************/
49
50
51
52/* Flags */
53#define ED_OK 0x00 /* Nothing special */
54#define ED_TOO_COMPLEX 0x01 /* Expression is too complex */
55#define ED_ERROR 0x02 /* Error evaluating the expression */
56
57/* Symbol reference */
58typedef struct ED_SymRef ED_SymRef;
59struct ED_SymRef {
60 long Count; /* Number of references */
61 struct SymEntry* Ref; /* Actual reference */
62};
63
64/* Section reference */
65typedef struct ED_SecRef ED_SecRef;
66struct ED_SecRef {
67 long Count; /* Number of references */
68 unsigned Ref; /* Actual reference */
69};
70
71/* Structure for parsing expression trees */
72typedef struct ExprDesc ExprDesc;
73struct ExprDesc {
74 unsigned short Flags; /* See ED_xxx */
75 unsigned char AddrSize; /* Address size of the expression */
76 long Val; /* The offset value */
77 long Right; /* Right value for StudyBinaryExpr */
78
79 /* Symbol reference management */
80 unsigned SymCount; /* Number of symbols referenced */
81 unsigned SymLimit; /* Memory allocated */
82 ED_SymRef* SymRef; /* Symbol references */
83
84 /* Section reference management */
85 unsigned SecCount; /* Number of sections referenced */
86 unsigned SecLimit; /* Memory allocated */
87 ED_SecRef* SecRef; /* Section references */
88};
89
90
91
92/*****************************************************************************/
93/* struct ExprDesc */
94/*****************************************************************************/
95
96
97
98ExprDesc* ED_Init (ExprDesc* ED);
99/* Initialize an ExprDesc structure for use with StudyExpr */
100
101void ED_Done (ExprDesc* ED);
102/* Delete allocated memory for an ExprDesc. */
103
104int ED_IsConst (const ExprDesc* ED);
105/* Return true if the expression is constant */
106
107
108
109/*****************************************************************************/
110/* Code */
111/*****************************************************************************/
112
113
114
115void StudyExpr (ExprNode* Expr, ExprDesc* D);
116/* Study an expression tree and place the contents into D */
117
118
119
120/* End of studyexpr.h */
121
122#endif
123