1 /* Internal type definitions for GDB.
2 Copyright (C) 1992 Free Software Foundation, Inc.
3 Contributed by Cygnus Support, using pieces from other GDB modules.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
21 #if !defined (GDBTYPES_H)
24 /* When gdb creates fundamental types, it uses one of the following
25 type identifiers. The identifiers are used to index a vector of
26 pointers to any types that are created. */
31 #define FT_SIGNED_CHAR 3
32 #define FT_UNSIGNED_CHAR 4
34 #define FT_SIGNED_SHORT 6
35 #define FT_UNSIGNED_SHORT 7
37 #define FT_SIGNED_INTEGER 9
38 #define FT_UNSIGNED_INTEGER 10
40 #define FT_SIGNED_LONG 12
41 #define FT_UNSIGNED_LONG 13
42 #define FT_LONG_LONG 14
43 #define FT_SIGNED_LONG_LONG 15
44 #define FT_UNSIGNED_LONG_LONG 16
46 #define FT_DBL_PREC_FLOAT 18
47 #define FT_EXT_PREC_FLOAT 19
49 #define FT_DBL_PREC_COMPLEX 21
50 #define FT_EXT_PREC_COMPLEX 22
52 #define FT_FIXED_DECIMAL 24
53 #define FT_FLOAT_DECIMAL 25
55 #define FT_UNSIGNED_BYTE 27
57 #define FT_NUM_MEMBERS 28 /* Highest FT_* above, plus one. */
59 /* Some macros for char-based bitfields. */
61 #define B_SET(a,x) ((a)[(x)>>3] |= (1 << ((x)&7)))
62 #define B_CLR(a,x) ((a)[(x)>>3] &= ~(1 << ((x)&7)))
63 #define B_TST(a,x) ((a)[(x)>>3] & (1 << ((x)&7)))
64 #define B_TYPE unsigned char
65 #define B_BYTES(x) ( 1 + ((x)>>3) )
66 #define B_CLRALL(a,x) memset ((a), 0, B_BYTES(x))
68 /* Different kinds of data types are distinguished by the `code' field. */
72 TYPE_CODE_UNDEF
, /* Not used; catches errors */
73 TYPE_CODE_PTR
, /* Pointer type */
74 TYPE_CODE_ARRAY
, /* Array type with lower & upper bounds. */
75 TYPE_CODE_STRUCT
, /* C struct or Pascal record */
76 TYPE_CODE_UNION
, /* C union or Pascal variant part */
77 TYPE_CODE_ENUM
, /* Enumeration type */
78 TYPE_CODE_FUNC
, /* Function type */
79 TYPE_CODE_INT
, /* Integer type */
80 TYPE_CODE_FLT
, /* Floating type */
81 TYPE_CODE_VOID
, /* Void type (values zero length) */
82 TYPE_CODE_SET
, /* Pascal sets */
83 TYPE_CODE_RANGE
, /* Range (integers within spec'd bounds) */
84 TYPE_CODE_PASCAL_ARRAY
, /* Array with explicit type of index */
85 TYPE_CODE_ERROR
, /* Unknown type */
88 TYPE_CODE_MEMBER
, /* Member type */
89 TYPE_CODE_METHOD
, /* Method type */
90 TYPE_CODE_REF
, /* C++ Reference types */
93 TYPE_CODE_CHAR
, /* *real* character type */
94 TYPE_CODE_BOOL
/* BOOLEAN type */
97 /* For now allow source to use TYPE_CODE_CLASS for C++ classes, as an
98 alias for TYPE_CODE_STRUCT. Eventually these should probably be
99 officially distinct types within gdb. */
101 #define TYPE_CODE_CLASS TYPE_CODE_STRUCT
103 /* Some bits for the type's flags word. */
105 /* Explicitly unsigned integer type */
107 #define TYPE_FLAG_UNSIGNED (1 << 0)
109 /* Explicitly signed integer type */
111 #define TYPE_FLAG_SIGNED (1 << 1)
113 /* This appears in a type's flags word if it is a stub type (eg. if
114 someone referenced a type that wasn't defined in a source file
115 via (struct sir_not_appearing_in_this_film *)). */
117 #define TYPE_FLAG_STUB (1 << 2)
123 /* Code for kind of type */
127 /* Name of this type, or NULL if none.
128 This is used for printing only, except by poorly designed C++ code.
129 Type names specified as input are defined by symbols. */
133 /* Length in bytes of storage for a value of this type */
137 /* Every type is now associated with a particular objfile, and the
138 type is allocated on the type_obstack for that objfile. One problem
139 however, is that there are times when gdb allocates new types while
140 it is not in the process of reading symbols from a particular objfile.
141 Fortunately, these happen when the type being created is a derived
142 type of an existing type, such as in lookup_pointer_type(). So
143 we can just allocate the new type using the same objfile as the
144 existing type, but to do this we need a backpointer to the objfile
145 from the existing type. Yes this is somewhat ugly, but without
146 major overhaul of the internal type system, it can't be avoided
149 struct objfile
*objfile
;
151 /* For a pointer type, describes the type of object pointed to.
152 For an array type, describes the type of the elements.
153 For a function or method type, describes the type of the return value.
154 For a range type, describes the type of the full range.
157 struct type
*target_type
;
159 /* Type that is a pointer to this type.
160 NULL if no such pointer-to type is known yet.
161 The debugger may add the address of such a type
162 if it has to construct one later. */
164 struct type
*pointer_type
;
166 /* C++: also need a reference type. */
168 struct type
*reference_type
;
170 /* Type that is a function returning this type.
171 NULL if no such function type is known here.
172 The debugger may add the address of such a type
173 if it has to construct one later. */
175 struct type
*function_type
;
177 /* Flags about this type. */
181 /* Number of fields described for this type */
185 /* For structure and union types, a description of each field.
186 For set and pascal array types, there is one "field",
187 whose type is the domain type of the set or array.
188 For range types, there are two "fields",
189 the minimum and maximum values (both inclusive).
190 For enum types, each possible value is described by one "field".
191 For C++ classes, there is one field for each base class (if it is
192 a derived class) plus one field for each class data member. Member
193 functions are recorded elsewhere.
195 Using a pointer to a separate array of fields
196 allows all types to have the same size, which is useful
197 because we can allocate the space for a type before
198 we know what to put in it. */
203 /* Position of this field, counting in bits from start of
204 containing structure. For a function type, this is the
205 position in the argument list of this argument.
206 For a range bound or enum value, this is the value itself.
207 (FIXME: What about ranges larger than host int size?)
208 For BITS_BIG_ENDIAN=1 targets, it is the bit offset to the MSB.
209 For BITS_BIG_ENDIAN=0 targets, it is the bit offset to the LSB. */
213 /* Size of this field, in bits, or zero if not packed.
214 For an unpacked field, the field's type's length
215 says how many bytes the field occupies. */
219 /* In a struct or enum type, type of this field.
220 In a function type, type of this argument.
221 In an array type, the domain-type of the array. */
225 /* Name of field, value or argument.
226 NULL for range bounds and array domains. */
232 /* For types with virtual functions, VPTR_BASETYPE is the base class which
233 defined the virtual function table pointer. VPTR_FIELDNO is
234 the field number of that pointer in the structure.
236 For types that are pointer to member types, VPTR_BASETYPE
237 is the type that this pointer is a member of.
241 struct type
*vptr_basetype
;
245 /* Slot to point to additional language-specific fields of this type. */
250 /* ARG_TYPES is for TYPE_CODE_METHOD and TYPE_CODE_FUNC. */
252 struct type
**arg_types
;
254 /* CPLUS_STUFF is for TYPE_CODE_STRUCT. It is initialized to point to
255 cplus_struct_default, a default static instance of a struct
256 cplus_struct_type. */
258 struct cplus_struct_type
*cplus_stuff
;
263 #define NULL_TYPE ((struct type *) 0)
265 /* C++ language-specific information for TYPE_CODE_STRUCT and TYPE_CODE_UNION
268 struct cplus_struct_type
270 /* Number of base classes this type derives from. */
274 /* Number of methods with unique names. All overloaded methods with
275 the same name count only once. */
279 /* Number of methods described for this type plus all the
280 methods that it derives from. */
282 int nfn_fields_total
;
284 /* For derived classes, the number of base classes is given by n_baseclasses
285 and virtual_field_bits is a bit vector containing one bit per base class.
286 If the base class is virtual, the corresponding bit will be set.
291 class C : public B, public virtual A {};
293 B is a baseclass of C; A is a virtual baseclass for C.
294 This is a C++ 2.0 language feature. */
296 B_TYPE
*virtual_field_bits
;
298 /* For classes with private fields, the number of fields is given by
299 nfields and private_field_bits is a bit vector containing one bit
301 If the field is private, the corresponding bit will be set. */
303 B_TYPE
*private_field_bits
;
305 /* For classes with protected fields, the number of fields is given by
306 nfields and protected_field_bits is a bit vector containing one bit
308 If the field is private, the corresponding bit will be set. */
310 B_TYPE
*protected_field_bits
;
312 /* For classes, structures, and unions, a description of each field,
313 which consists of an overloaded name, followed by the types of
314 arguments that the method expects, and then the name after it
315 has been renamed to make it distinct.
317 fn_fieldlists points to an array of nfn_fields of these. */
322 /* The overloaded name. */
326 /* The number of methods with this name. */
330 /* The list of methods. */
335 /* The name after it has been processed */
339 /* The return value of the method */
343 /* The argument list */
347 /* For virtual functions.
348 First baseclass that defines this virtual function. */
350 struct type
*fcontext
;
354 unsigned int is_const
: 1;
355 unsigned int is_volatile
: 1;
356 unsigned int is_private
: 1;
357 unsigned int is_protected
: 1;
358 unsigned int is_stub
: 1;
359 unsigned int dummy
: 3;
361 /* Index into that baseclass's virtual function table,
362 minus 2; else if static: VOFFSET_STATIC; else: 0. */
364 unsigned int voffset
: 24;
366 # define VOFFSET_STATIC 1
374 /* The default value of TYPE_CPLUS_SPECIFIC(T) points to the
375 this shared static structure. */
377 extern struct cplus_struct_type cplus_struct_default
;
380 allocate_cplus_struct_type
PARAMS ((struct type
*));
382 #define INIT_CPLUS_SPECIFIC(type) \
383 (TYPE_CPLUS_SPECIFIC(type)=(struct cplus_struct_type*)&cplus_struct_default)
384 #define ALLOCATE_CPLUS_STRUCT_TYPE(type) allocate_cplus_struct_type (type)
385 #define HAVE_CPLUS_STRUCT(type) \
386 (TYPE_CPLUS_SPECIFIC(type) != &cplus_struct_default)
388 #define TYPE_NAME(thistype) (thistype)->name
389 #define TYPE_TARGET_TYPE(thistype) (thistype)->target_type
390 #define TYPE_POINTER_TYPE(thistype) (thistype)->pointer_type
391 #define TYPE_REFERENCE_TYPE(thistype) (thistype)->reference_type
392 #define TYPE_FUNCTION_TYPE(thistype) (thistype)->function_type
393 #define TYPE_LENGTH(thistype) (thistype)->length
394 #define TYPE_OBJFILE(thistype) (thistype)->objfile
395 #define TYPE_FLAGS(thistype) (thistype)->flags
396 #define TYPE_UNSIGNED(thistype) ((thistype)->flags & TYPE_FLAG_UNSIGNED)
397 #define TYPE_CODE(thistype) (thistype)->code
398 #define TYPE_NFIELDS(thistype) (thistype)->nfields
399 #define TYPE_FIELDS(thistype) (thistype)->fields
403 #define TYPE_VPTR_BASETYPE(thistype) (thistype)->vptr_basetype
404 #define TYPE_DOMAIN_TYPE(thistype) (thistype)->vptr_basetype
405 #define TYPE_VPTR_FIELDNO(thistype) (thistype)->vptr_fieldno
406 #define TYPE_FN_FIELDS(thistype) TYPE_CPLUS_SPECIFIC(thistype)->fn_fields
407 #define TYPE_NFN_FIELDS(thistype) TYPE_CPLUS_SPECIFIC(thistype)->nfn_fields
408 #define TYPE_NFN_FIELDS_TOTAL(thistype) TYPE_CPLUS_SPECIFIC(thistype)->nfn_fields_total
409 #define TYPE_TYPE_SPECIFIC(thistype) (thistype)->type_specific
410 #define TYPE_ARG_TYPES(thistype) (thistype)->type_specific.arg_types
411 #define TYPE_CPLUS_SPECIFIC(thistype) (thistype)->type_specific.cplus_stuff
412 #define TYPE_BASECLASS(thistype,index) (thistype)->fields[index].type
413 #define TYPE_N_BASECLASSES(thistype) TYPE_CPLUS_SPECIFIC(thistype)->n_baseclasses
414 #define TYPE_BASECLASS_NAME(thistype,index) (thistype)->fields[index].name
415 #define TYPE_BASECLASS_BITPOS(thistype,index) (thistype)->fields[index].bitpos
416 #define BASETYPE_VIA_PUBLIC(thistype, index) (!TYPE_FIELD_PRIVATE(thistype, index))
417 #define BASETYPE_VIA_VIRTUAL(thistype, index) \
418 B_TST(TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits, (index))
420 #define TYPE_FIELD(thistype, n) (thistype)->fields[n]
421 #define TYPE_FIELD_TYPE(thistype, n) (thistype)->fields[n].type
422 #define TYPE_FIELD_NAME(thistype, n) (thistype)->fields[n].name
423 #define TYPE_FIELD_VALUE(thistype, n) (* (int*) &(thistype)->fields[n].type)
424 #define TYPE_FIELD_BITPOS(thistype, n) (thistype)->fields[n].bitpos
425 #define TYPE_FIELD_BITSIZE(thistype, n) (thistype)->fields[n].bitsize
426 #define TYPE_FIELD_PACKED(thistype, n) (thistype)->fields[n].bitsize
428 #define TYPE_FIELD_PRIVATE_BITS(thistype) \
429 TYPE_CPLUS_SPECIFIC(thistype)->private_field_bits
430 #define TYPE_FIELD_PROTECTED_BITS(thistype) \
431 TYPE_CPLUS_SPECIFIC(thistype)->protected_field_bits
432 #define TYPE_FIELD_VIRTUAL_BITS(thistype) \
433 TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits
434 #define SET_TYPE_FIELD_PRIVATE(thistype, n) \
435 B_SET (TYPE_CPLUS_SPECIFIC(thistype)->private_field_bits, (n))
436 #define SET_TYPE_FIELD_PROTECTED(thistype, n) \
437 B_SET (TYPE_CPLUS_SPECIFIC(thistype)->protected_field_bits, (n))
438 #define SET_TYPE_FIELD_VIRTUAL(thistype, n) \
439 B_SET (TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits, (n))
440 #define TYPE_FIELD_PRIVATE(thistype, n) \
441 (TYPE_CPLUS_SPECIFIC(thistype)->private_field_bits == NULL ? 0 \
442 : B_TST(TYPE_CPLUS_SPECIFIC(thistype)->private_field_bits, (n)))
443 #define TYPE_FIELD_PROTECTED(thistype, n) \
444 (TYPE_CPLUS_SPECIFIC(thistype)->protected_field_bits == NULL ? 0 \
445 : B_TST(TYPE_CPLUS_SPECIFIC(thistype)->protected_field_bits, (n)))
446 #define TYPE_FIELD_VIRTUAL(thistype, n) \
447 B_TST(TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits, (n))
449 #define TYPE_FIELD_STATIC(thistype, n) ((thistype)->fields[n].bitpos == -1)
450 #define TYPE_FIELD_STATIC_PHYSNAME(thistype, n) ((char *)(thistype)->fields[n].bitsize)
452 #define TYPE_FN_FIELDLISTS(thistype) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists
453 #define TYPE_FN_FIELDLIST(thistype, n) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists[n]
454 #define TYPE_FN_FIELDLIST1(thistype, n) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists[n].fn_fields
455 #define TYPE_FN_FIELDLIST_NAME(thistype, n) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists[n].name
456 #define TYPE_FN_FIELDLIST_LENGTH(thistype, n) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists[n].length
458 #define TYPE_FN_FIELD(thisfn, n) (thisfn)[n]
459 #define TYPE_FN_FIELD_PHYSNAME(thisfn, n) (thisfn)[n].physname
460 #define TYPE_FN_FIELD_TYPE(thisfn, n) (thisfn)[n].type
461 #define TYPE_FN_FIELD_ARGS(thisfn, n) TYPE_ARG_TYPES ((thisfn)[n].type)
462 #define TYPE_FN_FIELD_CONST(thisfn, n) ((thisfn)[n].is_const)
463 #define TYPE_FN_FIELD_VOLATILE(thisfn, n) ((thisfn)[n].is_volatile)
464 #define TYPE_FN_FIELD_PRIVATE(thisfn, n) ((thisfn)[n].is_private)
465 #define TYPE_FN_FIELD_PROTECTED(thisfn, n) ((thisfn)[n].is_protected)
466 #define TYPE_FN_FIELD_STUB(thisfn, n) ((thisfn)[n].is_stub)
467 #define TYPE_FN_FIELD_FCONTEXT(thisfn, n) ((thisfn)[n].fcontext)
468 #define TYPE_FN_FIELD_VOFFSET(thisfn, n) ((thisfn)[n].voffset-2)
469 #define TYPE_FN_FIELD_VIRTUAL_P(thisfn, n) ((thisfn)[n].voffset > 1)
470 #define TYPE_FN_FIELD_STATIC_P(thisfn, n) ((thisfn)[n].voffset == VOFFSET_STATIC)
472 extern struct type
*builtin_type_void
;
473 extern struct type
*builtin_type_char
;
474 extern struct type
*builtin_type_short
;
475 extern struct type
*builtin_type_int
;
476 extern struct type
*builtin_type_long
;
477 extern struct type
*builtin_type_signed_char
;
478 extern struct type
*builtin_type_unsigned_char
;
479 extern struct type
*builtin_type_unsigned_short
;
480 extern struct type
*builtin_type_unsigned_int
;
481 extern struct type
*builtin_type_unsigned_long
;
482 extern struct type
*builtin_type_float
;
483 extern struct type
*builtin_type_double
;
484 extern struct type
*builtin_type_long_double
;
485 extern struct type
*builtin_type_complex
;
486 extern struct type
*builtin_type_double_complex
;
488 /* This type represents a type that was unrecognized in symbol
491 extern struct type
*builtin_type_error
;
493 extern struct type
*builtin_type_long_long
;
494 extern struct type
*builtin_type_unsigned_long_long
;
498 extern struct type
*builtin_type_m2_char
;
499 extern struct type
*builtin_type_m2_int
;
500 extern struct type
*builtin_type_m2_card
;
501 extern struct type
*builtin_type_m2_real
;
502 extern struct type
*builtin_type_m2_bool
;
504 /* start-sanitize-chill */
507 extern struct type
*builtin_type_chill_bool
;
508 extern struct type
*builtin_type_chill_char
;
509 extern struct type
*builtin_type_chill_long
;
510 extern struct type
*builtin_type_chill_ulong
;
511 extern struct type
*builtin_type_chill_real
;
512 /* end-sanitize-chill */
514 /* LONG_LONG is defined if the host has "long long". */
518 #define BUILTIN_TYPE_LONGEST builtin_type_long_long
519 #define BUILTIN_TYPE_UNSIGNED_LONGEST builtin_type_unsigned_long_long
521 #else /* not LONG_LONG. */
523 #define BUILTIN_TYPE_LONGEST builtin_type_long
524 #define BUILTIN_TYPE_UNSIGNED_LONGEST builtin_type_unsigned_long
526 #endif /* not LONG_LONG. */
528 /* Maximum and minimum values of built-in types */
530 #define MAX_OF_TYPE(t) \
531 TYPE_UNSIGNED(t) ? UMAX_OF_SIZE(TYPE_LENGTH(t)) \
532 : MAX_OF_SIZE(TYPE_LENGTH(t))
534 #define MIN_OF_TYPE(t) \
535 TYPE_UNSIGNED(t) ? UMIN_OF_SIZE(TYPE_LENGTH(t)) \
536 : MIN_OF_SIZE(TYPE_LENGTH(t))
538 /* Allocate space for storing data associated with a particular type.
539 We ensure that the space is allocated using the same mechanism that
540 was used to allocate the space for the type structure itself. I.E.
541 if the type is on an objfile's type_obstack, then the space for data
542 associated with that type will also be allocated on the type_obstack.
543 If the type is not associated with any particular objfile (such as
544 builtin types), then the data space will be allocated with xmalloc,
545 the same as for the type structure. */
547 #define TYPE_ALLOC(t,size) \
548 (TYPE_OBJFILE (t) != NULL \
549 ? obstack_alloc (&TYPE_OBJFILE (t) -> type_obstack, size) \
553 alloc_type
PARAMS ((struct objfile
*));
556 init_type
PARAMS ((enum type_code
, int, int, char *, struct objfile
*));
559 lookup_reference_type
PARAMS ((struct type
*));
562 make_reference_type
PARAMS ((struct type
*, struct type
**));
565 lookup_member_type
PARAMS ((struct type
*, struct type
*));
568 smash_to_method_type
PARAMS ((struct type
*, struct type
*, struct type
*,
572 smash_to_member_type
PARAMS ((struct type
*, struct type
*, struct type
*));
575 allocate_stub_method
PARAMS ((struct type
*));
578 type_name_no_tag
PARAMS ((const struct type
*));
581 lookup_struct_elt_type
PARAMS ((struct type
*, char *, int));
584 make_pointer_type
PARAMS ((struct type
*, struct type
**));
587 lookup_pointer_type
PARAMS ((struct type
*));
590 make_function_type
PARAMS ((struct type
*, struct type
**));
593 lookup_function_type
PARAMS ((struct type
*));
596 create_range_type
PARAMS ((struct type
*, struct type
*, int, int));
599 create_array_type
PARAMS ((struct type
*, struct type
*, struct type
*));
602 lookup_unsigned_typename
PARAMS ((char *));
605 lookup_signed_typename
PARAMS ((char *));
608 check_stub_type
PARAMS ((struct type
*));
611 check_stub_method
PARAMS ((struct type
*, int, int));
614 lookup_primitive_typename
PARAMS ((char *));
617 gdb_mangle_name
PARAMS ((struct type
*, int, int));
620 builtin_type
PARAMS ((char **));
623 error_type
PARAMS ((char **));
626 lookup_typename
PARAMS ((char *, struct block
*, int));
629 lookup_template_type
PARAMS ((char *, struct type
*, struct block
*));
632 lookup_fundamental_type
PARAMS ((struct objfile
*, int));
635 fill_in_vptr_fieldno
PARAMS ((struct type
*));
638 extern void recursive_dump_type
PARAMS ((struct type
*, int));
644 print_scalar_formatted
PARAMS ((char *, struct type
*, int, int, FILE *));
647 extern void maintenance_print_type
PARAMS ((char *, int));
650 #endif /* GDBTYPES_H */