1 /*****************************************************************************/
5 /* Type string handling for the cc65 C compiler */
9 /* (C) 1998-2002 Ullrich von Bassewitz */
11 /* D-70597 Stuttgart */
12 /* EMail: uz@musoftware.de */
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 /*****************************************************************************/
52 /*****************************************************************************/
54 /*****************************************************************************/
59 /* Basic data types */
66 T_TYPE_SHORT = 0x0002,
69 T_TYPE_LONGLONG = 0x0005,
71 T_TYPE_FLOAT = 0x0007,
72 T_TYPE_DOUBLE = 0x0008,
74 T_TYPE_STRUCT = 0x000A,
75 T_TYPE_UNION = 0x000B,
76 T_TYPE_ARRAY = 0x000C,
82 T_CLASS_NONE = 0x0000,
84 T_CLASS_FLOAT = 0x0040,
86 T_CLASS_STRUCT = 0x0080,
87 T_CLASS_FUNC = 0x00A0,
88 T_MASK_CLASS = 0x00E0,
92 T_SIGN_UNSIGNED = 0x0100,
93 T_SIGN_SIGNED = 0x0200,
96 /* Type size modifiers */
98 T_SIZE_SHORT = 0x0400,
100 T_SIZE_LONGLONG = 0x0C00,
101 T_MASK_SIZE = 0x0C00,
103 /* Type qualifiers */
104 T_QUAL_NONE = 0x0000,
105 T_QUAL_CONST = 0x1000,
106 T_QUAL_VOLATILE = 0x2000,
107 T_MASK_QUAL = 0x3000,
110 T_CHAR = T_TYPE_CHAR | T_CLASS_INT | T_SIGN_UNSIGNED | T_SIZE_NONE,
111 T_SCHAR = T_TYPE_CHAR | T_CLASS_INT | T_SIGN_SIGNED | T_SIZE_NONE,
112 T_UCHAR = T_TYPE_CHAR | T_CLASS_INT | T_SIGN_UNSIGNED | T_SIZE_NONE,
113 T_SHORT = T_TYPE_SHORT | T_CLASS_INT | T_SIGN_SIGNED | T_SIZE_SHORT,
114 T_USHORT = T_TYPE_SHORT | T_CLASS_INT | T_SIGN_UNSIGNED | T_SIZE_SHORT,
115 T_INT = T_TYPE_INT | T_CLASS_INT | T_SIGN_SIGNED | T_SIZE_NONE,
116 T_UINT = T_TYPE_INT | T_CLASS_INT | T_SIGN_UNSIGNED | T_SIZE_NONE,
117 T_LONG = T_TYPE_LONG | T_CLASS_INT | T_SIGN_SIGNED | T_SIZE_LONG,
118 T_ULONG = T_TYPE_LONG | T_CLASS_INT | T_SIGN_UNSIGNED | T_SIZE_LONG,
119 T_LONGLONG = T_TYPE_LONGLONG | T_CLASS_INT | T_SIGN_SIGNED | T_SIZE_LONGLONG,
120 T_ULONGLONG = T_TYPE_LONGLONG | T_CLASS_INT | T_SIGN_UNSIGNED | T_SIZE_LONGLONG,
121 T_ENUM = T_TYPE_ENUM | T_CLASS_INT | T_SIGN_SIGNED | T_SIZE_NONE,
122 T_FLOAT = T_TYPE_FLOAT | T_CLASS_FLOAT | T_SIGN_NONE | T_SIZE_NONE,
123 T_DOUBLE = T_TYPE_DOUBLE | T_CLASS_FLOAT | T_SIGN_NONE | T_SIZE_NONE,
124 T_VOID = T_TYPE_VOID | T_CLASS_NONE | T_SIGN_NONE | T_SIZE_NONE,
125 T_STRUCT = T_TYPE_STRUCT | T_CLASS_STRUCT | T_SIGN_NONE | T_SIZE_NONE,
126 T_UNION = T_TYPE_UNION | T_CLASS_STRUCT | T_SIGN_NONE | T_SIZE_NONE,
127 T_ARRAY = T_TYPE_ARRAY | T_CLASS_PTR | T_SIGN_NONE | T_SIZE_NONE,
128 T_PTR = T_TYPE_PTR | T_CLASS_PTR | T_SIGN_NONE | T_SIZE_NONE,
129 T_FUNC = T_TYPE_FUNC | T_CLASS_FUNC | T_SIGN_NONE | T_SIZE_NONE,
135 /* Forward for a symbol entry */
139 typedef unsigned short type;
141 /* Maximum length of a type string */
142 #define MAXTYPELEN 30
144 /* Type elements needed for Encode/Decode */
145 #define DECODE_SIZE 5
148 #define SIZEOF_CHAR 1
149 #define SIZEOF_SHORT 2
151 #define SIZEOF_LONG 4
152 #define SIZEOF_LONGLONG 8
153 #define SIZEOF_FLOAT 4
154 #define SIZEOF_DOUBLE 4
157 /* Predefined type strings */
158 extern type type_uchar [];
159 extern type type_int [];
160 extern type type_uint [];
161 extern type type_long [];
162 extern type type_ulong [];
163 extern type type_void [];
164 extern type type_size_t [];
168 /*****************************************************************************/
170 /*****************************************************************************/
174 unsigned TypeLen (const type* Type);
175 /* Return the length of the type string */
177 type* TypeCpy (type* Dest, const type* Src);
178 /* Copy a type string */
180 type* TypeCat (type* Dest, const type* Src);
183 type* TypeDup (const type* Type);
184 /* Create a copy of the given type on the heap */
186 type* TypeAlloc (unsigned Len);
187 /* Allocate memory for a type string of length Len. Len *must* include the
191 void TypeFree (type* Type);
192 /* Free a type string */
194 int SignExtendChar (int C);
195 /* Do correct sign extension of a character */
197 type GetDefaultChar (void);
198 /* Return the default char type (signed/unsigned) depending on the settings */
200 type* GetCharArrayType (unsigned Len);
201 /* Return the type for a char array of the given length */
203 type* GetImplicitFuncType (void);
204 /* Return a type string for an inplicitly declared function */
206 type* PointerTo (const type* T);
207 /* Return a type string that is "pointer to T". The type string is allocated
208 * on the heap and may be freed after use.
211 void PrintType (FILE* F, const type* Type);
212 /* Output translation of type array. */
214 void PrintRawType (FILE* F, const type* Type);
215 /* Print a type string in raw format (for debugging) */
217 void PrintFuncSig (FILE* F, const char* Name, type* Type);
218 /* Print a function signature. */
220 void Encode (type* Type, unsigned long Val);
221 /* Encode an unsigned long into a type array */
223 void EncodePtr (type* Type, void* P);
224 /* Encode a pointer into a type array */
226 unsigned long Decode (const type* Type);
227 /* Decode an unsigned long from a type array */
229 void* DecodePtr (const type* Type);
230 /* Decode a pointer from a type array */
232 int HasEncode (const type* Type);
233 /* Return true if the given type has encoded data */
235 void CopyEncode (const type* Source, type* Target);
236 /* Copy encoded data from Source to Target */
238 #if defined(HAVE_INLINE)
239 INLINE type UnqualifiedType (type T)
240 /* Return the unqalified type */
242 return (T & ~T_MASK_QUAL);
245 # define UnqualifiedType(T) ((T) & ~T_MASK_QUAL)
248 unsigned SizeOf (const type* Type);
249 /* Compute size of object represented by type array. */
251 unsigned PSizeOf (const type* Type);
252 /* Compute size of pointer object. */
254 unsigned CheckedSizeOf (const type* T);
255 /* Return the size of a data type. If the size is zero, emit an error and
256 * return some valid size instead (so the rest of the compiler doesn't have
257 * to work with invalid sizes).
259 unsigned CheckedPSizeOf (const type* T);
260 /* Return the size of a data type that is pointed to by a pointer. If the
261 * size is zero, emit an error and return some valid size instead (so the
262 * rest of the compiler doesn't have to work with invalid sizes).
265 unsigned TypeOf (const type* Type);
266 /* Get the code generator base type of the object */
268 type* Indirect (type* Type);
269 /* Do one indirection for the given type, that is, return the type where the
270 * given type points to.
273 type* ArrayToPtr (const type* Type);
274 /* Convert an array to a pointer to it's first element */
276 #if defined(HAVE_INLINE)
277 INLINE int IsTypeChar (const type* T)
278 /* Return true if this is a character type */
280 return (T[0] & T_MASK_TYPE) == T_TYPE_CHAR;
283 # define IsTypeChar(T) (((T)[0] & T_MASK_TYPE) == T_TYPE_CHAR)
286 #if defined(HAVE_INLINE)
287 INLINE int IsTypeInt (const type* T)
288 /* Return true if this is an int type (signed or unsigned) */
290 return (T[0] & T_MASK_TYPE) == T_TYPE_INT;
293 # define IsTypeInt(T) (((T)[0] & T_MASK_TYPE) == T_TYPE_INT)
296 #if defined(HAVE_INLINE)
297 INLINE int IsTypeLong (const type* T)
298 /* Return true if this is a long type (signed or unsigned) */
300 return (T[0] & T_MASK_TYPE) == T_TYPE_LONG;
303 # define IsTypeLong(T) (((T)[0] & T_MASK_TYPE) == T_TYPE_LONG)
306 #if defined(HAVE_INLINE)
307 INLINE int IsTypeFloat (const type* T)
308 /* Return true if this is a float type */
310 return (T[0] & T_MASK_TYPE) == T_TYPE_FLOAT;
313 # define IsTypeFloat(T) (((T)[0] & T_MASK_TYPE) == T_TYPE_FLOAT)
316 #if defined(HAVE_INLINE)
317 INLINE int IsTypeDouble (const type* T)
318 /* Return true if this is a double type */
320 return (T[0] & T_MASK_TYPE) == T_TYPE_DOUBLE;
323 # define IsTypeDouble(T) (((T)[0] & T_MASK_TYPE) == T_TYPE_DOUBLE)
326 #if defined(HAVE_INLINE)
327 INLINE int IsTypePtr (const type* T)
328 /* Return true if this is a pointer type */
330 return ((T[0] & T_MASK_TYPE) == T_TYPE_PTR);
333 # define IsTypePtr(T) (((T)[0] & T_MASK_TYPE) == T_TYPE_PTR)
336 #if defined(HAVE_INLINE)
337 INLINE int IsTypeStruct (const type* T)
338 /* Return true if this is a struct type */
340 return ((T[0] & T_MASK_TYPE) == T_TYPE_STRUCT);
343 # define IsTypeStruct(T) (((T)[0] & T_MASK_TYPE) == T_TYPE_STRUCT)
346 #if defined(HAVE_INLINE)
347 INLINE int IsTypeUnion (const type* T)
348 /* Return true if this is a union type */
350 return ((T[0] & T_MASK_TYPE) == T_TYPE_UNION);
353 # define IsTypeUnion(T) (((T)[0] & T_MASK_TYPE) == T_TYPE_UNION)
356 #if defined(HAVE_INLINE)
357 INLINE int IsTypeArray (const type* T)
358 /* Return true if this is an array type */
360 return ((T[0] & T_MASK_TYPE) == T_TYPE_ARRAY);
363 # define IsTypeArray(T) (((T)[0] & T_MASK_TYPE) == T_TYPE_ARRAY)
366 #if defined(HAVE_INLINE)
367 INLINE int IsTypeVoid (const type* T)
368 /* Return true if this is a void type */
370 return (T[0] & T_MASK_TYPE) == T_TYPE_VOID;
373 # define IsTypeVoid(T) (((T)[0] & T_MASK_TYPE) == T_TYPE_VOID)
376 #if defined(HAVE_INLINE)
377 INLINE int IsTypeFunc (const type* T)
378 /* Return true if this is a function class */
380 return ((T[0] & T_MASK_TYPE) == T_TYPE_FUNC);
383 # define IsTypeFunc(T) (((T)[0] & T_MASK_TYPE) == T_TYPE_FUNC)
386 #if defined(HAVE_INLINE)
387 INLINE int IsTypeFuncPtr (const type* T)
388 /* Return true if this is a function pointer */
390 return ((T[0] & T_MASK_TYPE) == T_TYPE_PTR && (T[1] & T_MASK_TYPE) == T_TYPE_FUNC);
393 # define IsTypeFuncPtr(T) \
394 ((((T)[0] & T_MASK_TYPE) == T_TYPE_PTR) && (((T)[1] & T_MASK_TYPE) == T_TYPE_FUNC))
397 int IsClassInt (const type* Type) attribute ((const));
398 /* Return true if this is an integer type */
400 int IsClassFloat (const type* Type) attribute ((const));
401 /* Return true if this is a float type */
403 int IsClassPtr (const type* Type) attribute ((const));
404 /* Return true if this is a pointer type */
406 int IsClassStruct (const type* Type) attribute ((const));
407 /* Return true if this is a struct type */
409 int IsSignUnsigned (const type* Type) attribute ((const));
410 /* Return true if this is an unsigned type */
412 int IsQualConst (const type* T) attribute ((const));
413 /* Return true if the given type has a const memory image */
415 int IsQualVolatile (const type* T) attribute ((const));
416 /* Return true if the given type has a volatile type qualifier */
418 int IsFastCallFunc (const type* T) attribute ((const));
419 /* Return true if this is a function type or pointer to function with
420 * __fastcall__ calling conventions
423 int IsVariadicFunc (const type* T) attribute ((const));
424 /* Return true if this is a function type or pointer to function type with
425 * variable parameter list
428 #if defined(HAVE_INLINE)
429 INLINE type GetType (const type* T)
430 /* Get the raw type */
432 return (T[0] & T_MASK_TYPE);
435 # define GetType(T) ((T)[0] & T_MASK_TYPE)
438 #if defined(HAVE_INLINE)
439 INLINE type GetClass (const type* T)
440 /* Get the class of a type string */
442 return (T[0] & T_MASK_CLASS);
445 # define GetClass(T) ((T)[0] & T_MASK_CLASS)
448 #if defined(HAVE_INLINE)
449 INLINE type GetSignedness (const type* T)
450 /* Get the sign of a type */
452 return (T[0] & T_MASK_SIGN);
455 # define GetSignedness(T) ((T)[0] & T_MASK_SIGN)
458 #if defined(HAVE_INLINE)
459 INLINE type GetSizeModifier (const type* T)
460 /* Get the size modifier of a type */
462 return (T[0] & T_MASK_SIZE);
465 # define GetSizeModifier(T) ((T)[0] & T_MASK_SIZE)
468 type GetQualifier (const type* T) attribute ((const));
469 /* Get the qualifier from the given type string */
471 FuncDesc* GetFuncDesc (const type* T) attribute ((const));
472 /* Get the FuncDesc pointer from a function or pointer-to-function type */
474 type* GetFuncReturn (type* T) attribute ((const));
475 /* Return a pointer to the return type of a function or pointer-to-function type */
479 /* End of datatype.h */