1 /*****************************************************************************/
5 /* Symbol table entries for the cc65 C compiler */
9 /* (C) 2000-2013, Ullrich von Bassewitz */
10 /* Roemerstrasse 52 */
11 /* D-70794 Filderstadt */
12 /* EMail: uz@cc65.org */
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. */
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: */
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 */
32 /*****************************************************************************/
53 /*****************************************************************************/
55 /*****************************************************************************/
64 /*****************************************************************************/
66 /*****************************************************************************/
70 /* Storage classes and flags */
71 #define SC_AUTO 0x0001U /* Auto variable */
72 #define SC_REGISTER 0x0002U /* Register variable */
73 #define SC_STATIC 0x0004U /* Static */
74 #define SC_EXTERN 0x0008U /* Extern linkage */
76 #define SC_ENUM 0x0030U /* An enum */
77 #define SC_CONST 0x0020U /* A numeric constant with a type */
78 #define SC_LABEL 0x0040U /* A goto label */
79 #define SC_PARAM 0x0080U /* A function parameter */
80 #define SC_FUNC 0x0100U /* A function */
82 #define SC_DEFTYPE 0x0200U /* Parameter has default type (=int, old style) */
83 #define SC_STORAGE 0x0400U /* Symbol with associated storage */
84 #define SC_DEFAULT 0x0800U /* Flag: default storage class was used */
86 #define SC_DEF 0x1000U /* Symbol is defined */
87 #define SC_REF 0x2000U /* Symbol is referenced */
89 #define SC_TYPE 0x4000U /* This is a type, struct, typedef, etc. */
90 #define SC_STRUCT 0x4001U /* Struct */
91 #define SC_UNION 0x4002U /* Union */
92 #define SC_STRUCTFIELD 0x4003U /* Struct or union field */
93 #define SC_BITFIELD 0x4004U /* A bit-field inside a struct or union */
94 #define SC_TYPEDEF 0x4005U /* A typedef */
95 #define SC_TYPEMASK 0x400FU /* Mask for above types */
97 #define SC_ZEROPAGE 0x8000U /* Symbol marked as zeropage */
99 #define SC_HAVEATTR 0x10000U /* Symbol has attributes */
101 #define SC_GOTO 0x20000U
102 #define SC_SPADJUSTMENT 0x40000U
107 /* Label definition or reference */
108 typedef struct DefOrRef DefOrRef;
115 unsigned LateSP_Label;
118 /* Symbol table entry */
119 typedef struct SymEntry SymEntry;
121 SymEntry* NextHash; /* Next entry in hash list */
122 SymEntry* PrevSym; /* Previous symbol in dl list */
123 SymEntry* NextSym; /* Next symbol double linked list */
124 SymEntry* Link; /* General purpose single linked list */
125 struct SymTable* Owner; /* Symbol table the symbol is in */
126 unsigned Flags; /* Symbol flags */
127 Type* Type; /* Symbol type */
128 Collection* Attr; /* Attribute list if any */
129 char* AsmName; /* Assembler name if any */
131 /* Data that differs for the different symbol types */
134 /* Offset for locals or struct members */
137 /* Label name for static symbols */
140 Collection *DefsOrRefs;
143 /* Value of SP adjustment needed after forward 'goto' */
145 unsigned short SPAdjustment;
148 /* Register bank offset and offset of the saved copy on stack for
149 ** register variables.
156 /* Value for constants (including enums) */
159 /* Data for structs/unions */
161 struct SymTable* SymTab; /* Member symbol table */
162 unsigned Size; /* Size of the union/struct */
165 /* Data for bit fields */
167 unsigned Offs; /* Byte offset into struct */
168 unsigned BitOffs; /* Bit offset into storage unit */
169 unsigned BitWidth; /* Width in bits */
172 /* Data for functions */
174 struct FuncDesc* Func; /* Function descriptor */
175 struct Segments* Seg; /* Segments for this function */
176 struct LiteralPool* LitPool; /* Literal pool for this function */
179 /* Segment name for tentantive global definitions */
182 char Name[1]; /* Name, dynamically allocated */
187 /*****************************************************************************/
189 /*****************************************************************************/
193 SymEntry* NewSymEntry (const char* Name, unsigned Flags);
194 /* Create a new symbol table with the given name */
196 void FreeSymEntry (SymEntry* E);
197 /* Free a symbol entry */
199 void DumpSymEntry (FILE* F, const SymEntry* E);
200 /* Dump the given symbol table entry to the file in readable form */
202 #if defined(HAVE_INLINE)
203 INLINE int SymIsBitField (const SymEntry* Sym)
204 /* Return true if the given entry is a bit-field entry */
206 return ((Sym->Flags & SC_BITFIELD) == SC_BITFIELD);
209 # define SymIsBitField(Sym) (((Sym)->Flags & SC_BITFIELD) == SC_BITFIELD)
212 #if defined(HAVE_INLINE)
213 INLINE int SymIsTypeDef (const SymEntry* Sym)
214 /* Return true if the given entry is a typedef entry */
216 return ((Sym->Flags & SC_TYPEDEF) == SC_TYPEDEF);
219 # define SymIsTypeDef(Sym) (((Sym)->Flags & SC_TYPEDEF) == SC_TYPEDEF)
222 #if defined(HAVE_INLINE)
223 INLINE int SymIsDef (const SymEntry* Sym)
224 /* Return true if the given entry is defined */
226 return ((Sym->Flags & SC_DEF) == SC_DEF);
229 # define SymIsDef(Sym) (((Sym)->Flags & SC_DEF) == SC_DEF)
232 #if defined(HAVE_INLINE)
233 INLINE int SymIsRef (const SymEntry* Sym)
234 /* Return true if the given entry is referenced */
236 return ((Sym->Flags & SC_REF) == SC_REF);
239 # define SymIsRef(Sym) (((Sym)->Flags & SC_REF) == SC_REF)
242 #if defined(HAVE_INLINE)
243 INLINE int SymIsRegVar (const SymEntry* Sym)
244 /* Return true if the given entry is a register variable */
245 /* ### HACK! Fix the ugly type flags! */
247 return ((Sym->Flags & (SC_REGISTER|SC_TYPE)) == SC_REGISTER);
250 # define SymIsRegVar(Sym) (((Sym)->Flags & (SC_REGISTER|SC_TYPE)) == SC_REGISTER)
253 int SymIsOutputFunc (const SymEntry* Sym);
254 /* Return true if this is a function that must be output */
256 #if defined(HAVE_INLINE)
257 INLINE const char* SymGetAsmName (const SymEntry* Sym)
258 /* Return the assembler label name for the symbol (beware: may be NULL!) */
263 # define SymGetAsmName(Sym) ((Sym)->AsmName)
266 const DeclAttr* SymGetAttr (const SymEntry* Sym, DeclAttrType AttrType);
267 /* Return an attribute for this symbol or NULL if the attribute does not exist */
269 #if defined(HAVE_INLINE)
270 INLINE int SymHasAttr (const SymEntry* Sym, DeclAttrType A)
271 /* Return true if the symbol has the given attribute */
273 return (SymGetAttr (Sym, A) != 0);
276 # define SymHasAttr(Sym, A) (SymGetAttr (Sym, A) != 0)
279 void SymUseAttr (SymEntry* Sym, struct Declaration* D);
280 /* Use the attributes from the declaration for this symbol */
282 void SymSetAsmName (SymEntry* Sym);
283 /* Set the assembler name for an external symbol from the name of the symbol */
285 void CvtRegVarToAuto (SymEntry* Sym);
286 /* Convert a register variable to an auto variable */
288 void ChangeSymType (SymEntry* Entry, Type* T);
289 /* Change the type of the given symbol */
291 void ChangeAsmName (SymEntry* Entry, const char* NewAsmName);
292 /* Change the assembler name of the symbol */
294 int HasAnonName (const SymEntry* Entry);
295 /* Return true if the symbol entry has an anonymous name */
299 /* End of symentry.h */