Fix struct, union, and enum nesting in C++
[external/binutils.git] / gdb / gdbtypes.h
1
2 /* Internal type definitions for GDB.
3
4    Copyright (C) 1992-2015 Free Software Foundation, Inc.
5
6    Contributed by Cygnus Support, using pieces from other GDB modules.
7
8    This file is part of GDB.
9
10    This program is free software; you can redistribute it and/or modify
11    it under the terms of the GNU General Public License as published by
12    the Free Software Foundation; either version 3 of the License, or
13    (at your option) any later version.
14
15    This program is distributed in the hope that it will be useful,
16    but WITHOUT ANY WARRANTY; without even the implied warranty of
17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18    GNU General Public License for more details.
19
20    You should have received a copy of the GNU General Public License
21    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
22
23 #if !defined (GDBTYPES_H)
24 #define GDBTYPES_H 1
25
26 /* * \page gdbtypes GDB Types
27
28    GDB represents all the different kinds of types in programming
29    languages using a common representation defined in gdbtypes.h.
30
31    The main data structure is main_type; it consists of a code (such
32    as #TYPE_CODE_ENUM for enumeration types), a number of
33    generally-useful fields such as the printable name, and finally a
34    field main_type::type_specific that is a union of info specific to
35    particular languages or other special cases (such as calling
36    convention).
37
38    The available type codes are defined in enum #type_code.  The enum
39    includes codes both for types that are common across a variety
40    of languages, and for types that are language-specific.
41
42    Most accesses to type fields go through macros such as
43    #TYPE_CODE(thistype) and #TYPE_FN_FIELD_CONST(thisfn, n).  These are
44    written such that they can be used as both rvalues and lvalues.
45  */
46
47 #include "hashtab.h"
48
49 /* Forward declarations for prototypes.  */
50 struct field;
51 struct block;
52 struct value_print_options;
53 struct language_defn;
54
55 /* These declarations are DWARF-specific as some of the gdbtypes.h data types
56    are already DWARF-specific.  */
57
58 /* * Offset relative to the start of its containing CU (compilation
59    unit).  */
60 typedef struct
61 {
62   unsigned int cu_off;
63 } cu_offset;
64
65 /* * Offset relative to the start of its .debug_info or .debug_types
66    section.  */
67
68 typedef struct
69 {
70   unsigned int sect_off;
71 } sect_offset;
72
73 /* Some macros for char-based bitfields.  */
74
75 #define B_SET(a,x)      ((a)[(x)>>3] |= (1 << ((x)&7)))
76 #define B_CLR(a,x)      ((a)[(x)>>3] &= ~(1 << ((x)&7)))
77 #define B_TST(a,x)      ((a)[(x)>>3] & (1 << ((x)&7)))
78 #define B_TYPE          unsigned char
79 #define B_BYTES(x)      ( 1 + ((x)>>3) )
80 #define B_CLRALL(a,x)   memset ((a), 0, B_BYTES(x))
81
82 /* * Different kinds of data types are distinguished by the `code'
83    field.  */
84
85 enum type_code
86   {
87     TYPE_CODE_BITSTRING = -1,   /**< Deprecated  */
88     TYPE_CODE_UNDEF = 0,        /**< Not used; catches errors */
89     TYPE_CODE_PTR,              /**< Pointer type */
90
91     /* * Array type with lower & upper bounds.
92
93        Regardless of the language, GDB represents multidimensional
94        array types the way C does: as arrays of arrays.  So an
95        instance of a GDB array type T can always be seen as a series
96        of instances of TYPE_TARGET_TYPE (T) laid out sequentially in
97        memory.
98
99        Row-major languages like C lay out multi-dimensional arrays so
100        that incrementing the rightmost index in a subscripting
101        expression results in the smallest change in the address of the
102        element referred to.  Column-major languages like Fortran lay
103        them out so that incrementing the leftmost index results in the
104        smallest change.
105
106        This means that, in column-major languages, working our way
107        from type to target type corresponds to working through indices
108        from right to left, not left to right.  */
109     TYPE_CODE_ARRAY,
110
111     TYPE_CODE_STRUCT,           /**< C struct or Pascal record */
112     TYPE_CODE_UNION,            /**< C union or Pascal variant part */
113     TYPE_CODE_ENUM,             /**< Enumeration type */
114     TYPE_CODE_FLAGS,            /**< Bit flags type */
115     TYPE_CODE_FUNC,             /**< Function type */
116     TYPE_CODE_INT,              /**< Integer type */
117
118     /* * Floating type.  This is *NOT* a complex type.  Beware, there
119        are parts of GDB which bogusly assume that TYPE_CODE_FLT can
120        mean complex.  */
121     TYPE_CODE_FLT,
122
123     /* * Void type.  The length field specifies the length (probably
124        always one) which is used in pointer arithmetic involving
125        pointers to this type, but actually dereferencing such a
126        pointer is invalid; a void type has no length and no actual
127        representation in memory or registers.  A pointer to a void
128        type is a generic pointer.  */
129     TYPE_CODE_VOID,
130
131     TYPE_CODE_SET,              /**< Pascal sets */
132     TYPE_CODE_RANGE,            /**< Range (integers within spec'd bounds).  */
133
134     /* * A string type which is like an array of character but prints
135        differently.  It does not contain a length field as Pascal
136        strings (for many Pascals, anyway) do; if we want to deal with
137        such strings, we should use a new type code.  */
138     TYPE_CODE_STRING,
139
140     /* * Unknown type.  The length field is valid if we were able to
141        deduce that much about the type, or 0 if we don't even know
142        that.  */
143     TYPE_CODE_ERROR,
144
145     /* C++ */
146     TYPE_CODE_METHOD,           /**< Method type */
147
148     /* * Pointer-to-member-function type.  This describes how to access a
149        particular member function of a class (possibly a virtual
150        member function).  The representation may vary between different
151        C++ ABIs.  */
152     TYPE_CODE_METHODPTR,
153
154     /* * Pointer-to-member type.  This is the offset within a class to
155        some particular data member.  The only currently supported
156        representation uses an unbiased offset, with -1 representing
157        NULL; this is used by the Itanium C++ ABI (used by GCC on all
158        platforms).  */
159     TYPE_CODE_MEMBERPTR,
160
161     TYPE_CODE_REF,              /**< C++ Reference types */
162
163     TYPE_CODE_CHAR,             /**< *real* character type */
164
165     /* * Boolean type.  0 is false, 1 is true, and other values are
166        non-boolean (e.g. FORTRAN "logical" used as unsigned int).  */
167     TYPE_CODE_BOOL,
168
169     /* Fortran */
170     TYPE_CODE_COMPLEX,          /**< Complex float */
171
172     TYPE_CODE_TYPEDEF,
173
174     TYPE_CODE_NAMESPACE,        /**< C++ namespace.  */
175
176     TYPE_CODE_DECFLOAT,         /**< Decimal floating point.  */
177
178     TYPE_CODE_MODULE,           /**< Fortran module.  */
179
180     /* * Internal function type.  */
181     TYPE_CODE_INTERNAL_FUNCTION,
182
183     /* * Methods implemented in extension languages.  */
184     TYPE_CODE_XMETHOD
185   };
186
187 /* * Some constants representing each bit field in the main_type.  See
188    the bit-field-specific macros, below, for documentation of each
189    constant in this enum.  These enum values are only used with
190    init_type.  Note that the values are chosen not to conflict with
191    type_instance_flag_value; this lets init_type error-check its
192    input.  */
193
194 enum type_flag_value
195 {
196   TYPE_FLAG_UNSIGNED = (1 << 9),
197   TYPE_FLAG_NOSIGN = (1 << 10),
198   TYPE_FLAG_STUB = (1 << 11),
199   TYPE_FLAG_TARGET_STUB = (1 << 12),
200   TYPE_FLAG_STATIC = (1 << 13),
201   TYPE_FLAG_PROTOTYPED = (1 << 14),
202   TYPE_FLAG_INCOMPLETE = (1 << 15),
203   TYPE_FLAG_VARARGS = (1 << 16),
204   TYPE_FLAG_VECTOR = (1 << 17),
205   TYPE_FLAG_FIXED_INSTANCE = (1 << 18),
206   TYPE_FLAG_STUB_SUPPORTED = (1 << 19),
207   TYPE_FLAG_GNU_IFUNC = (1 << 20),
208
209   /* * Used for error-checking.  */
210   TYPE_FLAG_MIN = TYPE_FLAG_UNSIGNED
211 };
212
213 /* * Some bits for the type's instance_flags word.  See the macros
214    below for documentation on each bit.  Note that if you add a value
215    here, you must update the enum type_flag_value as well.  */
216
217 enum type_instance_flag_value
218 {
219   TYPE_INSTANCE_FLAG_CONST = (1 << 0),
220   TYPE_INSTANCE_FLAG_VOLATILE = (1 << 1),
221   TYPE_INSTANCE_FLAG_CODE_SPACE = (1 << 2),
222   TYPE_INSTANCE_FLAG_DATA_SPACE = (1 << 3),
223   TYPE_INSTANCE_FLAG_ADDRESS_CLASS_1 = (1 << 4),
224   TYPE_INSTANCE_FLAG_ADDRESS_CLASS_2 = (1 << 5),
225   TYPE_INSTANCE_FLAG_NOTTEXT = (1 << 6),
226   TYPE_INSTANCE_FLAG_RESTRICT = (1 << 7),
227   TYPE_INSTANCE_FLAG_ATOMIC = (1 << 8)
228 };
229
230 /* * Unsigned integer type.  If this is not set for a TYPE_CODE_INT,
231    the type is signed (unless TYPE_FLAG_NOSIGN (below) is set).  */
232
233 #define TYPE_UNSIGNED(t)        (TYPE_MAIN_TYPE (t)->flag_unsigned)
234
235 /* * No sign for this type.  In C++, "char", "signed char", and
236    "unsigned char" are distinct types; so we need an extra flag to
237    indicate the absence of a sign!  */
238
239 #define TYPE_NOSIGN(t)          (TYPE_MAIN_TYPE (t)->flag_nosign)
240
241 /* * This appears in a type's flags word if it is a stub type (e.g.,
242    if someone referenced a type that wasn't defined in a source file
243    via (struct sir_not_appearing_in_this_film *)).  */
244
245 #define TYPE_STUB(t)            (TYPE_MAIN_TYPE (t)->flag_stub)
246
247 /* * The target type of this type is a stub type, and this type needs
248    to be updated if it gets un-stubbed in check_typedef.  Used for
249    arrays and ranges, in which TYPE_LENGTH of the array/range gets set
250    based on the TYPE_LENGTH of the target type.  Also, set for
251    TYPE_CODE_TYPEDEF.  */
252
253 #define TYPE_TARGET_STUB(t)     (TYPE_MAIN_TYPE (t)->flag_target_stub)
254
255 /* * Static type.  If this is set, the corresponding type had 
256    a static modifier.
257    Note: This may be unnecessary, since static data members
258    are indicated by other means (bitpos == -1).  */
259
260 #define TYPE_STATIC(t)          (TYPE_MAIN_TYPE (t)->flag_static)
261
262 /* * This is a function type which appears to have a prototype.  We
263    need this for function calls in order to tell us if it's necessary
264    to coerce the args, or to just do the standard conversions.  This
265    is used with a short field.  */
266
267 #define TYPE_PROTOTYPED(t)      (TYPE_MAIN_TYPE (t)->flag_prototyped)
268
269 /* * This flag is used to indicate that processing for this type
270    is incomplete.
271
272    (Mostly intended for HP platforms, where class methods, for
273    instance, can be encountered before their classes in the debug
274    info; the incomplete type has to be marked so that the class and
275    the method can be assigned correct types.)  */
276
277 #define TYPE_INCOMPLETE(t)      (TYPE_MAIN_TYPE (t)->flag_incomplete)
278
279 /* * FIXME drow/2002-06-03:  Only used for methods, but applies as well
280    to functions.  */
281
282 #define TYPE_VARARGS(t)         (TYPE_MAIN_TYPE (t)->flag_varargs)
283
284 /* * Identify a vector type.  Gcc is handling this by adding an extra
285    attribute to the array type.  We slurp that in as a new flag of a
286    type.  This is used only in dwarf2read.c.  */
287 #define TYPE_VECTOR(t)          (TYPE_MAIN_TYPE (t)->flag_vector)
288
289 /* * The debugging formats (especially STABS) do not contain enough
290    information to represent all Ada types---especially those whose
291    size depends on dynamic quantities.  Therefore, the GNAT Ada
292    compiler includes extra information in the form of additional type
293    definitions connected by naming conventions.  This flag indicates
294    that the type is an ordinary (unencoded) GDB type that has been
295    created from the necessary run-time information, and does not need
296    further interpretation.  Optionally marks ordinary, fixed-size GDB
297    type.  */
298
299 #define TYPE_FIXED_INSTANCE(t) (TYPE_MAIN_TYPE (t)->flag_fixed_instance)
300
301 /* * This debug target supports TYPE_STUB(t).  In the unsupported case
302    we have to rely on NFIELDS to be zero etc., see TYPE_IS_OPAQUE().
303    TYPE_STUB(t) with !TYPE_STUB_SUPPORTED(t) may exist if we only
304    guessed the TYPE_STUB(t) value (see dwarfread.c).  */
305
306 #define TYPE_STUB_SUPPORTED(t)   (TYPE_MAIN_TYPE (t)->flag_stub_supported)
307
308 /* * Not textual.  By default, GDB treats all single byte integers as
309    characters (or elements of strings) unless this flag is set.  */
310
311 #define TYPE_NOTTEXT(t) (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_NOTTEXT)
312
313 /* * Used only for TYPE_CODE_FUNC where it specifies the real function
314    address is returned by this function call.  TYPE_TARGET_TYPE
315    determines the final returned function type to be presented to
316    user.  */
317
318 #define TYPE_GNU_IFUNC(t)       (TYPE_MAIN_TYPE (t)->flag_gnu_ifunc)
319
320 /* * Type owner.  If TYPE_OBJFILE_OWNED is true, the type is owned by
321    the objfile retrieved as TYPE_OBJFILE.  Otherweise, the type is
322    owned by an architecture; TYPE_OBJFILE is NULL in this case.  */
323
324 #define TYPE_OBJFILE_OWNED(t) (TYPE_MAIN_TYPE (t)->flag_objfile_owned)
325 #define TYPE_OWNER(t) TYPE_MAIN_TYPE(t)->owner
326 #define TYPE_OBJFILE(t) (TYPE_OBJFILE_OWNED(t)? TYPE_OWNER(t).objfile : NULL)
327
328 /* * True if this type was declared using the "class" keyword.  This is
329    only valid for C++ structure and enum types.  If false, a structure
330    was declared as a "struct"; if true it was declared "class".  For
331    enum types, this is true when "enum class" or "enum struct" was
332    used to declare the type..  */
333
334 #define TYPE_DECLARED_CLASS(t) (TYPE_MAIN_TYPE (t)->flag_declared_class)
335
336 /* * True if this type is a "flag" enum.  A flag enum is one where all
337    the values are pairwise disjoint when "and"ed together.  This
338    affects how enum values are printed.  */
339
340 #define TYPE_FLAG_ENUM(t) (TYPE_MAIN_TYPE (t)->flag_flag_enum)
341
342 /* * Constant type.  If this is set, the corresponding type has a
343    const modifier.  */
344
345 #define TYPE_CONST(t) (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_CONST)
346
347 /* * Volatile type.  If this is set, the corresponding type has a
348    volatile modifier.  */
349
350 #define TYPE_VOLATILE(t) \
351   (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_VOLATILE)
352
353 /* * Restrict type.  If this is set, the corresponding type has a
354    restrict modifier.  */
355
356 #define TYPE_RESTRICT(t) \
357   (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_RESTRICT)
358
359 /* * Atomic type.  If this is set, the corresponding type has an
360    _Atomic modifier.  */
361
362 #define TYPE_ATOMIC(t) \
363   (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_ATOMIC)
364
365 /* * Instruction-space delimited type.  This is for Harvard architectures
366    which have separate instruction and data address spaces (and perhaps
367    others).
368
369    GDB usually defines a flat address space that is a superset of the
370    architecture's two (or more) address spaces, but this is an extension
371    of the architecture's model.
372
373    If TYPE_FLAG_INST is set, an object of the corresponding type
374    resides in instruction memory, even if its address (in the extended
375    flat address space) does not reflect this.
376
377    Similarly, if TYPE_FLAG_DATA is set, then an object of the 
378    corresponding type resides in the data memory space, even if
379    this is not indicated by its (flat address space) address.
380
381    If neither flag is set, the default space for functions / methods
382    is instruction space, and for data objects is data memory.  */
383
384 #define TYPE_CODE_SPACE(t) \
385   (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_CODE_SPACE)
386
387 #define TYPE_DATA_SPACE(t) \
388   (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_DATA_SPACE)
389
390 /* * Address class flags.  Some environments provide for pointers
391    whose size is different from that of a normal pointer or address
392    types where the bits are interpreted differently than normal
393    addresses.  The TYPE_FLAG_ADDRESS_CLASS_n flags may be used in
394    target specific ways to represent these different types of address
395    classes.  */
396
397 #define TYPE_ADDRESS_CLASS_1(t) (TYPE_INSTANCE_FLAGS(t) \
398                                  & TYPE_INSTANCE_FLAG_ADDRESS_CLASS_1)
399 #define TYPE_ADDRESS_CLASS_2(t) (TYPE_INSTANCE_FLAGS(t) \
400                                  & TYPE_INSTANCE_FLAG_ADDRESS_CLASS_2)
401 #define TYPE_INSTANCE_FLAG_ADDRESS_CLASS_ALL \
402   (TYPE_INSTANCE_FLAG_ADDRESS_CLASS_1 | TYPE_INSTANCE_FLAG_ADDRESS_CLASS_2)
403 #define TYPE_ADDRESS_CLASS_ALL(t) (TYPE_INSTANCE_FLAGS(t) \
404                                    & TYPE_INSTANCE_FLAG_ADDRESS_CLASS_ALL)
405
406 enum dynamic_prop_kind
407 {
408   PROP_UNDEFINED, /* Not defined.  */
409   PROP_CONST,     /* Constant.  */
410   PROP_ADDR_OFFSET, /* Address offset.  */
411   PROP_LOCEXPR,   /* Location expression.  */
412   PROP_LOCLIST    /* Location list.  */
413 };
414
415 union dynamic_prop_data
416 {
417   /* Storage for constant property.  */
418
419   LONGEST const_val;
420
421   /* Storage for dynamic property.  */
422
423   void *baton;
424 };
425
426 /* * Used to store a dynamic property.  */
427
428 struct dynamic_prop
429 {
430   /* Determine which field of the union dynamic_prop.data is used.  */
431   enum dynamic_prop_kind kind;
432
433   /* Storage for dynamic or static value.  */
434   union dynamic_prop_data data;
435 };
436
437
438 /* * Determine which field of the union main_type.fields[x].loc is
439    used.  */
440
441 enum field_loc_kind
442   {
443     FIELD_LOC_KIND_BITPOS,      /**< bitpos */
444     FIELD_LOC_KIND_ENUMVAL,     /**< enumval */
445     FIELD_LOC_KIND_PHYSADDR,    /**< physaddr */
446     FIELD_LOC_KIND_PHYSNAME,    /**< physname */
447     FIELD_LOC_KIND_DWARF_BLOCK  /**< dwarf_block */
448   };
449
450 /* * A discriminant to determine which field in the
451    main_type.type_specific union is being used, if any.
452
453    For types such as TYPE_CODE_FLT, the use of this
454    discriminant is really redundant, as we know from the type code
455    which field is going to be used.  As such, it would be possible to
456    reduce the size of this enum in order to save a bit or two for
457    other fields of struct main_type.  But, since we still have extra
458    room , and for the sake of clarity and consistency, we treat all fields
459    of the union the same way.  */
460
461 enum type_specific_kind
462 {
463   TYPE_SPECIFIC_NONE,
464   TYPE_SPECIFIC_CPLUS_STUFF,
465   TYPE_SPECIFIC_GNAT_STUFF,
466   TYPE_SPECIFIC_FLOATFORMAT,
467   /* Note: This is used by TYPE_CODE_FUNC and TYPE_CODE_METHOD.  */
468   TYPE_SPECIFIC_FUNC,
469   TYPE_SPECIFIC_SELF_TYPE
470 };
471
472 union type_owner
473 {
474   struct objfile *objfile;
475   struct gdbarch *gdbarch;
476 };
477
478 union field_location
479 {
480   /* * Position of this field, counting in bits from start of
481      containing structure.  For gdbarch_bits_big_endian=1
482      targets, it is the bit offset to the MSB.  For
483      gdbarch_bits_big_endian=0 targets, it is the bit offset to
484      the LSB.  */
485
486   int bitpos;
487
488   /* * Enum value.  */
489   LONGEST enumval;
490
491   /* * For a static field, if TYPE_FIELD_STATIC_HAS_ADDR then
492      physaddr is the location (in the target) of the static
493      field.  Otherwise, physname is the mangled label of the
494      static field.  */
495
496   CORE_ADDR physaddr;
497   const char *physname;
498
499   /* * The field location can be computed by evaluating the
500      following DWARF block.  Its DATA is allocated on
501      objfile_obstack - no CU load is needed to access it.  */
502
503   struct dwarf2_locexpr_baton *dwarf_block;
504 };
505
506 struct field
507 {
508   union field_location loc;
509
510   /* * For a function or member type, this is 1 if the argument is
511      marked artificial.  Artificial arguments should not be shown
512      to the user.  For TYPE_CODE_RANGE it is set if the specific
513      bound is not defined.  */
514
515   unsigned int artificial : 1;
516
517   /* * Discriminant for union field_location.  */
518
519   ENUM_BITFIELD(field_loc_kind) loc_kind : 3;
520
521   /* * Size of this field, in bits, or zero if not packed.
522      If non-zero in an array type, indicates the element size in
523      bits (used only in Ada at the moment).
524      For an unpacked field, the field's type's length
525      says how many bytes the field occupies.  */
526
527   unsigned int bitsize : 28;
528
529   /* * In a struct or union type, type of this field.
530      - In a function or member type, type of this argument.
531      - In an array type, the domain-type of the array.  */
532
533   struct type *type;
534
535   /* * Name of field, value or argument.
536      NULL for range bounds, array domains, and member function
537      arguments.  */
538
539   const char *name;
540 };
541
542 struct range_bounds
543 {
544   /* * Low bound of range.  */
545
546   struct dynamic_prop low;
547
548   /* * High bound of range.  */
549
550   struct dynamic_prop high;
551
552   /* True if HIGH range bound contains the number of elements in the
553      subrange. This affects how the final hight bound is computed.  */
554
555   int flag_upper_bound_is_count : 1;
556
557   /* True if LOW or/and HIGH are resolved into a static bound from
558      a dynamic one.  */
559
560   int flag_bound_evaluated : 1;
561 };
562
563 union type_specific
564 {
565   /* * CPLUS_STUFF is for TYPE_CODE_STRUCT.  It is initialized to
566      point to cplus_struct_default, a default static instance of a
567      struct cplus_struct_type.  */
568
569   struct cplus_struct_type *cplus_stuff;
570
571   /* * GNAT_STUFF is for types for which the GNAT Ada compiler
572      provides additional information.  */
573
574   struct gnat_aux_type *gnat_stuff;
575
576   /* * FLOATFORMAT is for TYPE_CODE_FLT.  It is a pointer to two
577      floatformat objects that describe the floating-point value
578      that resides within the type.  The first is for big endian
579      targets and the second is for little endian targets.  */
580
581   const struct floatformat **floatformat;
582
583   /* * For TYPE_CODE_FUNC and TYPE_CODE_METHOD types.  */
584
585   struct func_type *func_stuff;
586
587   /* * For types that are pointer to member types (TYPE_CODE_METHODPTR,
588      TYPE_CODE_MEMBERPTR), SELF_TYPE is the type that this pointer
589      is a member of.  */
590
591   struct type *self_type;
592 };
593
594 /* * Main structure representing a type in GDB.
595
596    This structure is space-critical.  Its layout has been tweaked to
597    reduce the space used.  */
598
599 struct main_type
600 {
601   /* * Code for kind of type.  */
602
603   ENUM_BITFIELD(type_code) code : 8;
604
605   /* * Flags about this type.  These fields appear at this location
606      because they packs nicely here.  See the TYPE_* macros for
607      documentation about these fields.  */
608
609   unsigned int flag_unsigned : 1;
610   unsigned int flag_nosign : 1;
611   unsigned int flag_stub : 1;
612   unsigned int flag_target_stub : 1;
613   unsigned int flag_static : 1;
614   unsigned int flag_prototyped : 1;
615   unsigned int flag_incomplete : 1;
616   unsigned int flag_varargs : 1;
617   unsigned int flag_vector : 1;
618   unsigned int flag_stub_supported : 1;
619   unsigned int flag_gnu_ifunc : 1;
620   unsigned int flag_fixed_instance : 1;
621   unsigned int flag_objfile_owned : 1;
622
623   /* * True if this type was declared with "class" rather than
624      "struct".  */
625
626   unsigned int flag_declared_class : 1;
627
628   /* * True if this is an enum type with disjoint values.  This
629      affects how the enum is printed.  */
630
631   unsigned int flag_flag_enum : 1;
632
633   /* * A discriminant telling us which field of the type_specific
634      union is being used for this type, if any.  */
635
636   ENUM_BITFIELD(type_specific_kind) type_specific_field : 3;
637
638   /* * Number of fields described for this type.  This field appears
639      at this location because it packs nicely here.  */
640
641   short nfields;
642
643   /* * Name of this type, or NULL if none.
644
645      This is used for printing only, except by poorly designed C++
646      code.  For looking up a name, look for a symbol in the
647      VAR_DOMAIN.  This is generally allocated in the objfile's
648      obstack.  However coffread.c uses malloc.  */
649
650   const char *name;
651
652   /* * Tag name for this type, or NULL if none.  This means that the
653      name of the type consists of a keyword followed by the tag name.
654      Which keyword is determined by the type code ("struct" for
655      TYPE_CODE_STRUCT, etc.).  As far as I know C/C++ are the only
656      languages with this feature.
657
658      This is used for printing only, except by poorly designed C++ code.
659      For looking up a name, look for a symbol in the STRUCT_DOMAIN.
660      One more legitimate use is that if TYPE_FLAG_STUB is set, this is
661      the name to use to look for definitions in other files.  */
662
663   const char *tag_name;
664
665   /* * Every type is now associated with a particular objfile, and the
666      type is allocated on the objfile_obstack for that objfile.  One
667      problem however, is that there are times when gdb allocates new
668      types while it is not in the process of reading symbols from a
669      particular objfile.  Fortunately, these happen when the type
670      being created is a derived type of an existing type, such as in
671      lookup_pointer_type().  So we can just allocate the new type
672      using the same objfile as the existing type, but to do this we
673      need a backpointer to the objfile from the existing type.  Yes
674      this is somewhat ugly, but without major overhaul of the internal
675      type system, it can't be avoided for now.  */
676
677   union type_owner owner;
678
679   /* * For a pointer type, describes the type of object pointed to.
680      - For an array type, describes the type of the elements.
681      - For a function or method type, describes the type of the return value.
682      - For a range type, describes the type of the full range.
683      - For a complex type, describes the type of each coordinate.
684      - For a special record or union type encoding a dynamic-sized type
685      in GNAT, a memoized pointer to a corresponding static version of
686      the type.
687      - Unused otherwise.  */
688
689   struct type *target_type;
690
691   /* * For structure and union types, a description of each field.
692      For set and pascal array types, there is one "field",
693      whose type is the domain type of the set or array.
694      For range types, there are two "fields",
695      the minimum and maximum values (both inclusive).
696      For enum types, each possible value is described by one "field".
697      For a function or method type, a "field" for each parameter.
698      For C++ classes, there is one field for each base class (if it is
699      a derived class) plus one field for each class data member.  Member
700      functions are recorded elsewhere.
701
702      Using a pointer to a separate array of fields
703      allows all types to have the same size, which is useful
704      because we can allocate the space for a type before
705      we know what to put in it.  */
706
707   union 
708   {
709     struct field *fields;
710
711     /* * Union member used for range types.  */
712
713     struct range_bounds *bounds;
714
715   } flds_bnds;
716
717   /* * Slot to point to additional language-specific fields of this
718      type.  */
719
720   union type_specific type_specific;
721
722   /* * Contains a location description value for the current type. Evaluating
723      this field yields to the location of the data for an object.  */
724
725   struct dynamic_prop *data_location;
726 };
727
728 /* * A ``struct type'' describes a particular instance of a type, with
729    some particular qualification.  */
730
731 struct type
732 {
733   /* * Type that is a pointer to this type.
734      NULL if no such pointer-to type is known yet.
735      The debugger may add the address of such a type
736      if it has to construct one later.  */
737
738   struct type *pointer_type;
739
740   /* * C++: also need a reference type.  */
741
742   struct type *reference_type;
743
744   /* * Variant chain.  This points to a type that differs from this
745      one only in qualifiers and length.  Currently, the possible
746      qualifiers are const, volatile, code-space, data-space, and
747      address class.  The length may differ only when one of the
748      address class flags are set.  The variants are linked in a
749      circular ring and share MAIN_TYPE.  */
750
751   struct type *chain;
752
753   /* * Flags specific to this instance of the type, indicating where
754      on the ring we are.
755
756      For TYPE_CODE_TYPEDEF the flags of the typedef type should be
757      binary or-ed with the target type, with a special case for
758      address class and space class.  For example if this typedef does
759      not specify any new qualifiers, TYPE_INSTANCE_FLAGS is 0 and the
760      instance flags are completely inherited from the target type.  No
761      qualifiers can be cleared by the typedef.  See also
762      check_typedef.  */
763   int instance_flags;
764
765   /* * Length of storage for a value of this type.  This is what
766      sizeof(type) would return; use it for address arithmetic, memory
767      reads and writes, etc.  This size includes padding.  For example,
768      an i386 extended-precision floating point value really only
769      occupies ten bytes, but most ABI's declare its size to be 12
770      bytes, to preserve alignment.  A `struct type' representing such
771      a floating-point type would have a `length' value of 12, even
772      though the last two bytes are unused.
773
774      There's a bit of a host/target mess here, if you're concerned
775      about machines whose bytes aren't eight bits long, or who don't
776      have byte-addressed memory.  Various places pass this to memcpy
777      and such, meaning it must be in units of host bytes.  Various
778      other places expect they can calculate addresses by adding it
779      and such, meaning it must be in units of target bytes.  For
780      some DSP targets, in which HOST_CHAR_BIT will (presumably) be 8
781      and TARGET_CHAR_BIT will be (say) 32, this is a problem.
782
783      One fix would be to make this field in bits (requiring that it
784      always be a multiple of HOST_CHAR_BIT and TARGET_CHAR_BIT) ---
785      the other choice would be to make it consistently in units of
786      HOST_CHAR_BIT.  However, this would still fail to address
787      machines based on a ternary or decimal representation.  */
788   
789   unsigned length;
790
791   /* * Core type, shared by a group of qualified types.  */
792
793   struct main_type *main_type;
794 };
795
796 #define NULL_TYPE ((struct type *) 0)
797
798 struct fn_fieldlist
799 {
800
801   /* * The overloaded name.
802      This is generally allocated in the objfile's obstack.
803      However stabsread.c sometimes uses malloc.  */
804
805   const char *name;
806
807   /* * The number of methods with this name.  */
808
809   int length;
810
811   /* * The list of methods.  */
812
813   struct fn_field *fn_fields;
814 };
815
816
817
818 struct fn_field
819 {
820   /* * If is_stub is clear, this is the mangled name which we can look
821      up to find the address of the method (FIXME: it would be cleaner
822      to have a pointer to the struct symbol here instead).
823
824      If is_stub is set, this is the portion of the mangled name which
825      specifies the arguments.  For example, "ii", if there are two int
826      arguments, or "" if there are no arguments.  See gdb_mangle_name
827      for the conversion from this format to the one used if is_stub is
828      clear.  */
829
830   const char *physname;
831
832   /* * The function type for the method.
833                
834      (This comment used to say "The return value of the method", but
835      that's wrong.  The function type is expected here, i.e. something
836      with TYPE_CODE_METHOD, and *not* the return-value type).  */
837
838   struct type *type;
839
840   /* * For virtual functions.  First baseclass that defines this
841      virtual function.  */
842
843   struct type *fcontext;
844
845   /* Attributes.  */
846
847   unsigned int is_const:1;
848   unsigned int is_volatile:1;
849   unsigned int is_private:1;
850   unsigned int is_protected:1;
851   unsigned int is_public:1;
852   unsigned int is_abstract:1;
853   unsigned int is_static:1;
854   unsigned int is_final:1;
855   unsigned int is_synchronized:1;
856   unsigned int is_native:1;
857   unsigned int is_artificial:1;
858
859   /* * A stub method only has some fields valid (but they are enough
860      to reconstruct the rest of the fields).  */
861
862   unsigned int is_stub:1;
863
864   /* * True if this function is a constructor, false otherwise.  */
865
866   unsigned int is_constructor : 1;
867
868   /* * Unused.  */
869
870   unsigned int dummy:3;
871
872   /* * Index into that baseclass's virtual function table, minus 2;
873      else if static: VOFFSET_STATIC; else: 0.  */
874
875   unsigned int voffset:16;
876
877 #define VOFFSET_STATIC 1
878
879 };
880
881 struct typedef_field
882 {
883   /* * Unqualified name to be prefixed by owning class qualified
884      name.  */
885
886   const char *name;
887
888   /* * Type this typedef named NAME represents.  */
889
890   struct type *type;
891 };
892
893 /* * C++ language-specific information for TYPE_CODE_STRUCT and
894    TYPE_CODE_UNION nodes.  */
895
896 struct cplus_struct_type
897   {
898     /* * Number of base classes this type derives from.  The
899        baseclasses are stored in the first N_BASECLASSES fields
900        (i.e. the `fields' field of the struct type).  I think only the
901        `type' field of such a field has any meaning.  */
902
903     short n_baseclasses;
904
905     /* * Field number of the virtual function table pointer in VPTR_BASETYPE.
906        All access to this field must be through TYPE_VPTR_FIELDNO as one
907        thing it does is check whether the field has been initialized.
908        Initially TYPE_RAW_CPLUS_SPECIFIC has the value of cplus_struct_default,
909        which for portability reasons doesn't initialize this field.
910        TYPE_VPTR_FIELDNO returns -1 for this case.
911
912        If -1, we were unable to find the virtual function table pointer in
913        initial symbol reading, and get_vptr_fieldno should be called to find
914        it if possible.  get_vptr_fieldno will update this field if possible.
915        Otherwise the value is left at -1.
916
917        Unused if this type does not have virtual functions.  */
918
919     short vptr_fieldno;
920
921     /* * Number of methods with unique names.  All overloaded methods
922        with the same name count only once.  */
923
924     short nfn_fields;
925
926     /* * Number of template arguments.  */
927
928     unsigned short n_template_arguments;
929
930     /* * One if this struct is a dynamic class, as defined by the
931        Itanium C++ ABI: if it requires a virtual table pointer,
932        because it or any of its base classes have one or more virtual
933        member functions or virtual base classes.  Minus one if not
934        dynamic.  Zero if not yet computed.  */
935
936     int is_dynamic : 2;
937
938     /* * Non-zero if this type came from a Java CU.  */
939
940     unsigned int is_java : 1;
941
942     /* * The base class which defined the virtual function table pointer.  */
943
944     struct type *vptr_basetype;
945
946     /* * For derived classes, the number of base classes is given by
947        n_baseclasses and virtual_field_bits is a bit vector containing
948        one bit per base class.  If the base class is virtual, the
949        corresponding bit will be set.
950        I.E, given:
951
952        class A{};
953        class B{};
954        class C : public B, public virtual A {};
955
956        B is a baseclass of C; A is a virtual baseclass for C.
957        This is a C++ 2.0 language feature.  */
958
959     B_TYPE *virtual_field_bits;
960
961     /* * For classes with private fields, the number of fields is
962        given by nfields and private_field_bits is a bit vector
963        containing one bit per field.
964
965        If the field is private, the corresponding bit will be set.  */
966
967     B_TYPE *private_field_bits;
968
969     /* * For classes with protected fields, the number of fields is
970        given by nfields and protected_field_bits is a bit vector
971        containing one bit per field.
972
973        If the field is private, the corresponding bit will be set.  */
974
975     B_TYPE *protected_field_bits;
976
977     /* * For classes with fields to be ignored, either this is
978        optimized out or this field has length 0.  */
979
980     B_TYPE *ignore_field_bits;
981
982     /* * For classes, structures, and unions, a description of each
983        field, which consists of an overloaded name, followed by the
984        types of arguments that the method expects, and then the name
985        after it has been renamed to make it distinct.
986
987        fn_fieldlists points to an array of nfn_fields of these.  */
988
989     struct fn_fieldlist *fn_fieldlists;
990
991     /* * typedefs defined inside this class.  typedef_field points to
992        an array of typedef_field_count elements.  */
993
994     struct typedef_field *typedef_field;
995
996     unsigned typedef_field_count;
997
998     /* * The template arguments.  This is an array with
999        N_TEMPLATE_ARGUMENTS elements.  This is NULL for non-template
1000        classes.  */
1001
1002     struct symbol **template_arguments;
1003   };
1004
1005 /* * Struct used to store conversion rankings.  */
1006
1007 struct rank
1008   {
1009     short rank;
1010
1011     /* * When two conversions are of the same type and therefore have
1012        the same rank, subrank is used to differentiate the two.
1013
1014        Eg: Two derived-class-pointer to base-class-pointer conversions
1015        would both have base pointer conversion rank, but the
1016        conversion with the shorter distance to the ancestor is
1017        preferable.  'subrank' would be used to reflect that.  */
1018
1019     short subrank;
1020   };
1021
1022 /* * Struct used for ranking a function for overload resolution.  */
1023
1024 struct badness_vector
1025   {
1026     int length;
1027     struct rank *rank;
1028   };
1029
1030 /* * GNAT Ada-specific information for various Ada types.  */
1031
1032 struct gnat_aux_type
1033   {
1034     /* * Parallel type used to encode information about dynamic types
1035        used in Ada (such as variant records, variable-size array,
1036        etc).  */
1037     struct type* descriptive_type;
1038   };
1039
1040 /* * For TYPE_CODE_FUNC and TYPE_CODE_METHOD types.  */
1041
1042 struct func_type
1043   {
1044     /* * The calling convention for targets supporting multiple ABIs.
1045        Right now this is only fetched from the Dwarf-2
1046        DW_AT_calling_convention attribute.  The value is one of the
1047        DW_CC enum dwarf_calling_convention constants.  */
1048
1049     unsigned calling_convention : 8;
1050
1051     /* * Whether this function normally returns to its caller.  It is
1052        set from the DW_AT_noreturn attribute if set on the
1053        DW_TAG_subprogram.  */
1054
1055     unsigned int is_noreturn : 1;
1056
1057     /* * Only those DW_TAG_GNU_call_site's in this function that have
1058        DW_AT_GNU_tail_call set are linked in this list.  Function
1059        without its tail call list complete
1060        (DW_AT_GNU_all_tail_call_sites or its superset
1061        DW_AT_GNU_all_call_sites) has TAIL_CALL_LIST NULL, even if some
1062        DW_TAG_GNU_call_site's exist in such function. */
1063
1064     struct call_site *tail_call_list;
1065
1066     /* * For method types (TYPE_CODE_METHOD), the aggregate type that
1067        contains the method.  */
1068
1069     struct type *self_type;
1070   };
1071
1072 /* struct call_site_parameter can be referenced in callees by several ways.  */
1073
1074 enum call_site_parameter_kind
1075 {
1076   /* * Use field call_site_parameter.u.dwarf_reg.  */
1077   CALL_SITE_PARAMETER_DWARF_REG,
1078
1079   /* * Use field call_site_parameter.u.fb_offset.  */
1080   CALL_SITE_PARAMETER_FB_OFFSET,
1081
1082   /* * Use field call_site_parameter.u.param_offset.  */
1083   CALL_SITE_PARAMETER_PARAM_OFFSET
1084 };
1085
1086 struct call_site_target
1087 {
1088   union field_location loc;
1089
1090   /* * Discriminant for union field_location.  */
1091
1092   ENUM_BITFIELD(field_loc_kind) loc_kind : 3;
1093 };
1094
1095 union call_site_parameter_u
1096 {
1097   /* * DW_TAG_formal_parameter's DW_AT_location's DW_OP_regX
1098      as DWARF register number, for register passed
1099      parameters.  */
1100
1101   int dwarf_reg;
1102
1103   /* * Offset from the callee's frame base, for stack passed
1104      parameters.  This equals offset from the caller's stack
1105      pointer.  */
1106
1107   CORE_ADDR fb_offset;
1108
1109   /* * Offset relative to the start of this PER_CU to
1110      DW_TAG_formal_parameter which is referenced by both
1111      caller and the callee.  */
1112
1113   cu_offset param_offset;
1114 };
1115
1116 struct call_site_parameter
1117 {
1118   ENUM_BITFIELD (call_site_parameter_kind) kind : 2;
1119
1120   union call_site_parameter_u u;
1121
1122   /* * DW_TAG_formal_parameter's DW_AT_GNU_call_site_value.  It
1123      is never NULL.  */
1124
1125   const gdb_byte *value;
1126   size_t value_size;
1127
1128   /* * DW_TAG_formal_parameter's DW_AT_GNU_call_site_data_value.
1129      It may be NULL if not provided by DWARF.  */
1130
1131   const gdb_byte *data_value;
1132   size_t data_value_size;
1133 };
1134
1135 /* * A place where a function gets called from, represented by
1136    DW_TAG_GNU_call_site.  It can be looked up from
1137    symtab->call_site_htab.  */
1138
1139 struct call_site
1140   {
1141     /* * Address of the first instruction after this call.  It must be
1142        the first field as we overload core_addr_hash and core_addr_eq
1143        for it.  */
1144
1145     CORE_ADDR pc;
1146
1147     /* * List successor with head in FUNC_TYPE.TAIL_CALL_LIST.  */
1148
1149     struct call_site *tail_call_next;
1150
1151     /* * Describe DW_AT_GNU_call_site_target.  Missing attribute uses
1152        FIELD_LOC_KIND_DWARF_BLOCK with FIELD_DWARF_BLOCK == NULL.  */
1153
1154     struct call_site_target target;
1155
1156     /* * Size of the PARAMETER array.  */
1157
1158     unsigned parameter_count;
1159
1160     /* * CU of the function where the call is located.  It gets used
1161        for DWARF blocks execution in the parameter array below.  */
1162
1163     struct dwarf2_per_cu_data *per_cu;
1164
1165     /* * Describe DW_TAG_GNU_call_site's DW_TAG_formal_parameter.  */
1166
1167     struct call_site_parameter parameter[1];
1168   };
1169
1170 /* * The default value of TYPE_CPLUS_SPECIFIC(T) points to this shared
1171    static structure.  */
1172
1173 extern const struct cplus_struct_type cplus_struct_default;
1174
1175 extern void allocate_cplus_struct_type (struct type *);
1176
1177 #define INIT_CPLUS_SPECIFIC(type) \
1178   (TYPE_SPECIFIC_FIELD (type) = TYPE_SPECIFIC_CPLUS_STUFF, \
1179    TYPE_RAW_CPLUS_SPECIFIC (type) = (struct cplus_struct_type*) \
1180    &cplus_struct_default)
1181
1182 #define ALLOCATE_CPLUS_STRUCT_TYPE(type) allocate_cplus_struct_type (type)
1183
1184 #define HAVE_CPLUS_STRUCT(type) \
1185   (TYPE_SPECIFIC_FIELD (type) == TYPE_SPECIFIC_CPLUS_STUFF \
1186    && TYPE_RAW_CPLUS_SPECIFIC (type) !=  &cplus_struct_default)
1187
1188 extern const struct gnat_aux_type gnat_aux_default;
1189
1190 extern void allocate_gnat_aux_type (struct type *);
1191
1192 #define INIT_GNAT_SPECIFIC(type) \
1193   (TYPE_SPECIFIC_FIELD (type) = TYPE_SPECIFIC_GNAT_STUFF, \
1194    TYPE_GNAT_SPECIFIC (type) = (struct gnat_aux_type *) &gnat_aux_default)
1195 #define ALLOCATE_GNAT_AUX_TYPE(type) allocate_gnat_aux_type (type)
1196 /* * A macro that returns non-zero if the type-specific data should be
1197    read as "gnat-stuff".  */
1198 #define HAVE_GNAT_AUX_INFO(type) \
1199   (TYPE_SPECIFIC_FIELD (type) == TYPE_SPECIFIC_GNAT_STUFF)
1200
1201 #define INIT_FUNC_SPECIFIC(type)                                               \
1202   (TYPE_SPECIFIC_FIELD (type) = TYPE_SPECIFIC_FUNC,                            \
1203    TYPE_MAIN_TYPE (type)->type_specific.func_stuff                             \
1204      = TYPE_ZALLOC (type,                                                      \
1205                     sizeof (*TYPE_MAIN_TYPE (type)->type_specific.func_stuff)))
1206
1207 #define TYPE_INSTANCE_FLAGS(thistype) (thistype)->instance_flags
1208 #define TYPE_MAIN_TYPE(thistype) (thistype)->main_type
1209 #define TYPE_NAME(thistype) TYPE_MAIN_TYPE(thistype)->name
1210 #define TYPE_TAG_NAME(type) TYPE_MAIN_TYPE(type)->tag_name
1211 #define TYPE_TARGET_TYPE(thistype) TYPE_MAIN_TYPE(thistype)->target_type
1212 #define TYPE_POINTER_TYPE(thistype) (thistype)->pointer_type
1213 #define TYPE_REFERENCE_TYPE(thistype) (thistype)->reference_type
1214 #define TYPE_CHAIN(thistype) (thistype)->chain
1215 /* * Note that if thistype is a TYPEDEF type, you have to call check_typedef.
1216    But check_typedef does set the TYPE_LENGTH of the TYPEDEF type,
1217    so you only have to call check_typedef once.  Since allocate_value
1218    calls check_typedef, TYPE_LENGTH (VALUE_TYPE (X)) is safe.  */
1219 #define TYPE_LENGTH(thistype) (thistype)->length
1220 /* * Note that TYPE_CODE can be TYPE_CODE_TYPEDEF, so if you want the real
1221    type, you need to do TYPE_CODE (check_type (this_type)).  */
1222 #define TYPE_CODE(thistype) TYPE_MAIN_TYPE(thistype)->code
1223 #define TYPE_NFIELDS(thistype) TYPE_MAIN_TYPE(thistype)->nfields
1224 #define TYPE_FIELDS(thistype) TYPE_MAIN_TYPE(thistype)->flds_bnds.fields
1225
1226 #define TYPE_INDEX_TYPE(type) TYPE_FIELD_TYPE (type, 0)
1227 #define TYPE_RANGE_DATA(thistype) TYPE_MAIN_TYPE(thistype)->flds_bnds.bounds
1228 #define TYPE_LOW_BOUND(range_type) \
1229   TYPE_RANGE_DATA(range_type)->low.data.const_val
1230 #define TYPE_HIGH_BOUND(range_type) \
1231   TYPE_RANGE_DATA(range_type)->high.data.const_val
1232 #define TYPE_LOW_BOUND_UNDEFINED(range_type) \
1233   (TYPE_RANGE_DATA(range_type)->low.kind == PROP_UNDEFINED)
1234 #define TYPE_HIGH_BOUND_UNDEFINED(range_type) \
1235   (TYPE_RANGE_DATA(range_type)->high.kind == PROP_UNDEFINED)
1236 #define TYPE_HIGH_BOUND_KIND(range_type) \
1237   TYPE_RANGE_DATA(range_type)->high.kind
1238 #define TYPE_LOW_BOUND_KIND(range_type) \
1239   TYPE_RANGE_DATA(range_type)->low.kind
1240
1241 /* Attribute accessors for the type data location.  */
1242 #define TYPE_DATA_LOCATION(thistype) \
1243   TYPE_MAIN_TYPE(thistype)->data_location
1244 #define TYPE_DATA_LOCATION_BATON(thistype) \
1245   TYPE_DATA_LOCATION (thistype)->data.baton
1246 #define TYPE_DATA_LOCATION_ADDR(thistype) \
1247   TYPE_DATA_LOCATION (thistype)->data.const_val
1248 #define TYPE_DATA_LOCATION_KIND(thistype) \
1249   TYPE_DATA_LOCATION (thistype)->kind
1250
1251 /* Moto-specific stuff for FORTRAN arrays.  */
1252
1253 #define TYPE_ARRAY_UPPER_BOUND_IS_UNDEFINED(arraytype) \
1254    TYPE_HIGH_BOUND_UNDEFINED(TYPE_INDEX_TYPE(arraytype))
1255 #define TYPE_ARRAY_LOWER_BOUND_IS_UNDEFINED(arraytype) \
1256    TYPE_LOW_BOUND_UNDEFINED(TYPE_INDEX_TYPE(arraytype))
1257
1258 #define TYPE_ARRAY_UPPER_BOUND_VALUE(arraytype) \
1259    (TYPE_HIGH_BOUND(TYPE_INDEX_TYPE((arraytype))))
1260
1261 #define TYPE_ARRAY_LOWER_BOUND_VALUE(arraytype) \
1262    (TYPE_LOW_BOUND(TYPE_INDEX_TYPE((arraytype))))
1263
1264 /* C++ */
1265
1266 #define TYPE_SELF_TYPE(thistype) internal_type_self_type (thistype)
1267 /* Do not call this, use TYPE_SELF_TYPE.  */
1268 extern struct type *internal_type_self_type (struct type *);
1269 extern void set_type_self_type (struct type *, struct type *);
1270
1271 extern int internal_type_vptr_fieldno (struct type *);
1272 extern void set_type_vptr_fieldno (struct type *, int);
1273 extern struct type *internal_type_vptr_basetype (struct type *);
1274 extern void set_type_vptr_basetype (struct type *, struct type *);
1275 #define TYPE_VPTR_FIELDNO(thistype) internal_type_vptr_fieldno (thistype)
1276 #define TYPE_VPTR_BASETYPE(thistype) internal_type_vptr_basetype (thistype)
1277
1278 #define TYPE_NFN_FIELDS(thistype) TYPE_CPLUS_SPECIFIC(thistype)->nfn_fields
1279 #define TYPE_SPECIFIC_FIELD(thistype) \
1280   TYPE_MAIN_TYPE(thistype)->type_specific_field
1281 /* We need this tap-dance with the TYPE_RAW_SPECIFIC because of the case
1282    where we're trying to print an Ada array using the C language.
1283    In that case, there is no "cplus_stuff", but the C language assumes
1284    that there is.  What we do, in that case, is pretend that there is
1285    an implicit one which is the default cplus stuff.  */
1286 #define TYPE_CPLUS_SPECIFIC(thistype) \
1287    (!HAVE_CPLUS_STRUCT(thistype) \
1288     ? (struct cplus_struct_type*)&cplus_struct_default \
1289     : TYPE_RAW_CPLUS_SPECIFIC(thistype))
1290 #define TYPE_RAW_CPLUS_SPECIFIC(thistype) TYPE_MAIN_TYPE(thistype)->type_specific.cplus_stuff
1291 #define TYPE_FLOATFORMAT(thistype) TYPE_MAIN_TYPE(thistype)->type_specific.floatformat
1292 #define TYPE_GNAT_SPECIFIC(thistype) TYPE_MAIN_TYPE(thistype)->type_specific.gnat_stuff
1293 #define TYPE_DESCRIPTIVE_TYPE(thistype) TYPE_GNAT_SPECIFIC(thistype)->descriptive_type
1294 #define TYPE_CALLING_CONVENTION(thistype) TYPE_MAIN_TYPE(thistype)->type_specific.func_stuff->calling_convention
1295 #define TYPE_NO_RETURN(thistype) TYPE_MAIN_TYPE(thistype)->type_specific.func_stuff->is_noreturn
1296 #define TYPE_TAIL_CALL_LIST(thistype) TYPE_MAIN_TYPE(thistype)->type_specific.func_stuff->tail_call_list
1297 #define TYPE_BASECLASS(thistype,index) TYPE_FIELD_TYPE(thistype, index)
1298 #define TYPE_N_BASECLASSES(thistype) TYPE_CPLUS_SPECIFIC(thistype)->n_baseclasses
1299 #define TYPE_BASECLASS_NAME(thistype,index) TYPE_FIELD_NAME(thistype, index)
1300 #define TYPE_BASECLASS_BITPOS(thistype,index) TYPE_FIELD_BITPOS(thistype,index)
1301 #define BASETYPE_VIA_PUBLIC(thistype, index) \
1302   ((!TYPE_FIELD_PRIVATE(thistype, index)) && (!TYPE_FIELD_PROTECTED(thistype, index)))
1303 #define TYPE_CPLUS_DYNAMIC(thistype) TYPE_CPLUS_SPECIFIC (thistype)->is_dynamic
1304 #define TYPE_CPLUS_REALLY_JAVA(thistype) TYPE_CPLUS_SPECIFIC (thistype)->is_java
1305
1306 #define BASETYPE_VIA_VIRTUAL(thistype, index) \
1307   (TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits == NULL ? 0 \
1308     : B_TST(TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits, (index)))
1309
1310 #define FIELD_TYPE(thisfld) ((thisfld).type)
1311 #define FIELD_NAME(thisfld) ((thisfld).name)
1312 #define FIELD_LOC_KIND(thisfld) ((thisfld).loc_kind)
1313 #define FIELD_BITPOS_LVAL(thisfld) ((thisfld).loc.bitpos)
1314 #define FIELD_BITPOS(thisfld) (FIELD_BITPOS_LVAL (thisfld) + 0)
1315 #define FIELD_ENUMVAL_LVAL(thisfld) ((thisfld).loc.enumval)
1316 #define FIELD_ENUMVAL(thisfld) (FIELD_ENUMVAL_LVAL (thisfld) + 0)
1317 #define FIELD_STATIC_PHYSNAME(thisfld) ((thisfld).loc.physname)
1318 #define FIELD_STATIC_PHYSADDR(thisfld) ((thisfld).loc.physaddr)
1319 #define FIELD_DWARF_BLOCK(thisfld) ((thisfld).loc.dwarf_block)
1320 #define SET_FIELD_BITPOS(thisfld, bitpos)                       \
1321   (FIELD_LOC_KIND (thisfld) = FIELD_LOC_KIND_BITPOS,            \
1322    FIELD_BITPOS_LVAL (thisfld) = (bitpos))
1323 #define SET_FIELD_ENUMVAL(thisfld, enumval)                     \
1324   (FIELD_LOC_KIND (thisfld) = FIELD_LOC_KIND_ENUMVAL,           \
1325    FIELD_ENUMVAL_LVAL (thisfld) = (enumval))
1326 #define SET_FIELD_PHYSNAME(thisfld, name)                       \
1327   (FIELD_LOC_KIND (thisfld) = FIELD_LOC_KIND_PHYSNAME,          \
1328    FIELD_STATIC_PHYSNAME (thisfld) = (name))
1329 #define SET_FIELD_PHYSADDR(thisfld, addr)                       \
1330   (FIELD_LOC_KIND (thisfld) = FIELD_LOC_KIND_PHYSADDR,          \
1331    FIELD_STATIC_PHYSADDR (thisfld) = (addr))
1332 #define SET_FIELD_DWARF_BLOCK(thisfld, addr)                    \
1333   (FIELD_LOC_KIND (thisfld) = FIELD_LOC_KIND_DWARF_BLOCK,       \
1334    FIELD_DWARF_BLOCK (thisfld) = (addr))
1335 #define FIELD_ARTIFICIAL(thisfld) ((thisfld).artificial)
1336 #define FIELD_BITSIZE(thisfld) ((thisfld).bitsize)
1337
1338 #define TYPE_FIELD(thistype, n) TYPE_MAIN_TYPE(thistype)->flds_bnds.fields[n]
1339 #define TYPE_FIELD_TYPE(thistype, n) FIELD_TYPE(TYPE_FIELD(thistype, n))
1340 #define TYPE_FIELD_NAME(thistype, n) FIELD_NAME(TYPE_FIELD(thistype, n))
1341 #define TYPE_FIELD_LOC_KIND(thistype, n) FIELD_LOC_KIND (TYPE_FIELD (thistype, n))
1342 #define TYPE_FIELD_BITPOS(thistype, n) FIELD_BITPOS (TYPE_FIELD (thistype, n))
1343 #define TYPE_FIELD_ENUMVAL(thistype, n) FIELD_ENUMVAL (TYPE_FIELD (thistype, n))
1344 #define TYPE_FIELD_STATIC_PHYSNAME(thistype, n) FIELD_STATIC_PHYSNAME (TYPE_FIELD (thistype, n))
1345 #define TYPE_FIELD_STATIC_PHYSADDR(thistype, n) FIELD_STATIC_PHYSADDR (TYPE_FIELD (thistype, n))
1346 #define TYPE_FIELD_DWARF_BLOCK(thistype, n) FIELD_DWARF_BLOCK (TYPE_FIELD (thistype, n))
1347 #define TYPE_FIELD_ARTIFICIAL(thistype, n) FIELD_ARTIFICIAL(TYPE_FIELD(thistype,n))
1348 #define TYPE_FIELD_BITSIZE(thistype, n) FIELD_BITSIZE(TYPE_FIELD(thistype,n))
1349 #define TYPE_FIELD_PACKED(thistype, n) (FIELD_BITSIZE(TYPE_FIELD(thistype,n))!=0)
1350
1351 #define TYPE_FIELD_PRIVATE_BITS(thistype) \
1352   TYPE_CPLUS_SPECIFIC(thistype)->private_field_bits
1353 #define TYPE_FIELD_PROTECTED_BITS(thistype) \
1354   TYPE_CPLUS_SPECIFIC(thistype)->protected_field_bits
1355 #define TYPE_FIELD_IGNORE_BITS(thistype) \
1356   TYPE_CPLUS_SPECIFIC(thistype)->ignore_field_bits
1357 #define TYPE_FIELD_VIRTUAL_BITS(thistype) \
1358   TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits
1359 #define SET_TYPE_FIELD_PRIVATE(thistype, n) \
1360   B_SET (TYPE_CPLUS_SPECIFIC(thistype)->private_field_bits, (n))
1361 #define SET_TYPE_FIELD_PROTECTED(thistype, n) \
1362   B_SET (TYPE_CPLUS_SPECIFIC(thistype)->protected_field_bits, (n))
1363 #define SET_TYPE_FIELD_IGNORE(thistype, n) \
1364   B_SET (TYPE_CPLUS_SPECIFIC(thistype)->ignore_field_bits, (n))
1365 #define SET_TYPE_FIELD_VIRTUAL(thistype, n) \
1366   B_SET (TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits, (n))
1367 #define TYPE_FIELD_PRIVATE(thistype, n) \
1368   (TYPE_CPLUS_SPECIFIC(thistype)->private_field_bits == NULL ? 0 \
1369     : B_TST(TYPE_CPLUS_SPECIFIC(thistype)->private_field_bits, (n)))
1370 #define TYPE_FIELD_PROTECTED(thistype, n) \
1371   (TYPE_CPLUS_SPECIFIC(thistype)->protected_field_bits == NULL ? 0 \
1372     : B_TST(TYPE_CPLUS_SPECIFIC(thistype)->protected_field_bits, (n)))
1373 #define TYPE_FIELD_IGNORE(thistype, n) \
1374   (TYPE_CPLUS_SPECIFIC(thistype)->ignore_field_bits == NULL ? 0 \
1375     : B_TST(TYPE_CPLUS_SPECIFIC(thistype)->ignore_field_bits, (n)))
1376 #define TYPE_FIELD_VIRTUAL(thistype, n) \
1377   (TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits == NULL ? 0 \
1378     : B_TST(TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits, (n)))
1379
1380 #define TYPE_FN_FIELDLISTS(thistype) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists
1381 #define TYPE_FN_FIELDLIST(thistype, n) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists[n]
1382 #define TYPE_FN_FIELDLIST1(thistype, n) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists[n].fn_fields
1383 #define TYPE_FN_FIELDLIST_NAME(thistype, n) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists[n].name
1384 #define TYPE_FN_FIELDLIST_LENGTH(thistype, n) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists[n].length
1385
1386 #define TYPE_N_TEMPLATE_ARGUMENTS(thistype) \
1387   TYPE_CPLUS_SPECIFIC (thistype)->n_template_arguments
1388 #define TYPE_TEMPLATE_ARGUMENTS(thistype) \
1389   TYPE_CPLUS_SPECIFIC (thistype)->template_arguments
1390 #define TYPE_TEMPLATE_ARGUMENT(thistype, n) \
1391   TYPE_CPLUS_SPECIFIC (thistype)->template_arguments[n]
1392
1393 #define TYPE_FN_FIELD(thisfn, n) (thisfn)[n]
1394 #define TYPE_FN_FIELD_PHYSNAME(thisfn, n) (thisfn)[n].physname
1395 #define TYPE_FN_FIELD_TYPE(thisfn, n) (thisfn)[n].type
1396 #define TYPE_FN_FIELD_ARGS(thisfn, n) TYPE_FIELDS ((thisfn)[n].type)
1397 #define TYPE_FN_FIELD_CONST(thisfn, n) ((thisfn)[n].is_const)
1398 #define TYPE_FN_FIELD_VOLATILE(thisfn, n) ((thisfn)[n].is_volatile)
1399 #define TYPE_FN_FIELD_PRIVATE(thisfn, n) ((thisfn)[n].is_private)
1400 #define TYPE_FN_FIELD_PROTECTED(thisfn, n) ((thisfn)[n].is_protected)
1401 #define TYPE_FN_FIELD_PUBLIC(thisfn, n) ((thisfn)[n].is_public)
1402 #define TYPE_FN_FIELD_STATIC(thisfn, n) ((thisfn)[n].is_static)
1403 #define TYPE_FN_FIELD_FINAL(thisfn, n) ((thisfn)[n].is_final)
1404 #define TYPE_FN_FIELD_SYNCHRONIZED(thisfn, n) ((thisfn)[n].is_synchronized)
1405 #define TYPE_FN_FIELD_NATIVE(thisfn, n) ((thisfn)[n].is_native)
1406 #define TYPE_FN_FIELD_ARTIFICIAL(thisfn, n) ((thisfn)[n].is_artificial)
1407 #define TYPE_FN_FIELD_ABSTRACT(thisfn, n) ((thisfn)[n].is_abstract)
1408 #define TYPE_FN_FIELD_STUB(thisfn, n) ((thisfn)[n].is_stub)
1409 #define TYPE_FN_FIELD_CONSTRUCTOR(thisfn, n) ((thisfn)[n].is_constructor)
1410 #define TYPE_FN_FIELD_FCONTEXT(thisfn, n) ((thisfn)[n].fcontext)
1411 #define TYPE_FN_FIELD_VOFFSET(thisfn, n) ((thisfn)[n].voffset-2)
1412 #define TYPE_FN_FIELD_VIRTUAL_P(thisfn, n) ((thisfn)[n].voffset > 1)
1413 #define TYPE_FN_FIELD_STATIC_P(thisfn, n) ((thisfn)[n].voffset == VOFFSET_STATIC)
1414
1415 #define TYPE_TYPEDEF_FIELD_ARRAY(thistype) \
1416   TYPE_CPLUS_SPECIFIC (thistype)->typedef_field
1417 #define TYPE_TYPEDEF_FIELD(thistype, n) \
1418   TYPE_CPLUS_SPECIFIC (thistype)->typedef_field[n]
1419 #define TYPE_TYPEDEF_FIELD_NAME(thistype, n) \
1420   TYPE_TYPEDEF_FIELD (thistype, n).name
1421 #define TYPE_TYPEDEF_FIELD_TYPE(thistype, n) \
1422   TYPE_TYPEDEF_FIELD (thistype, n).type
1423 #define TYPE_TYPEDEF_FIELD_COUNT(thistype) \
1424   TYPE_CPLUS_SPECIFIC (thistype)->typedef_field_count
1425
1426 #define TYPE_IS_OPAQUE(thistype) \
1427   (((TYPE_CODE (thistype) == TYPE_CODE_STRUCT) \
1428     || (TYPE_CODE (thistype) == TYPE_CODE_UNION)) \
1429    && (TYPE_NFIELDS (thistype) == 0) \
1430    && (!HAVE_CPLUS_STRUCT (thistype) \
1431        || TYPE_NFN_FIELDS (thistype) == 0) \
1432    && (TYPE_STUB (thistype) || !TYPE_STUB_SUPPORTED (thistype)))
1433
1434 /* * A helper macro that returns the name of a type or "unnamed type"
1435    if the type has no name.  */
1436
1437 #define TYPE_SAFE_NAME(type) \
1438   (TYPE_NAME (type) ? TYPE_NAME (type) : _("<unnamed type>"))
1439
1440 /* * A helper macro that returns the name of an error type.  If the
1441    type has a name, it is used; otherwise, a default is used.  */
1442
1443 #define TYPE_ERROR_NAME(type) \
1444   (TYPE_NAME (type) ? TYPE_NAME (type) : _("<error type>"))
1445
1446 struct builtin_type
1447 {
1448   /* Integral types.  */
1449
1450   /* Implicit size/sign (based on the architecture's ABI).  */
1451   struct type *builtin_void;
1452   struct type *builtin_char;
1453   struct type *builtin_short;
1454   struct type *builtin_int;
1455   struct type *builtin_long;
1456   struct type *builtin_signed_char;
1457   struct type *builtin_unsigned_char;
1458   struct type *builtin_unsigned_short;
1459   struct type *builtin_unsigned_int;
1460   struct type *builtin_unsigned_long;
1461   struct type *builtin_float;
1462   struct type *builtin_double;
1463   struct type *builtin_long_double;
1464   struct type *builtin_complex;
1465   struct type *builtin_double_complex;
1466   struct type *builtin_string;
1467   struct type *builtin_bool;
1468   struct type *builtin_long_long;
1469   struct type *builtin_unsigned_long_long;
1470   struct type *builtin_decfloat;
1471   struct type *builtin_decdouble;
1472   struct type *builtin_declong;
1473
1474   /* "True" character types.
1475       We use these for the '/c' print format, because c_char is just a
1476       one-byte integral type, which languages less laid back than C
1477       will print as ... well, a one-byte integral type.  */
1478   struct type *builtin_true_char;
1479   struct type *builtin_true_unsigned_char;
1480
1481   /* Explicit sizes - see C9X <intypes.h> for naming scheme.  The "int0"
1482      is for when an architecture needs to describe a register that has
1483      no size.  */
1484   struct type *builtin_int0;
1485   struct type *builtin_int8;
1486   struct type *builtin_uint8;
1487   struct type *builtin_int16;
1488   struct type *builtin_uint16;
1489   struct type *builtin_int32;
1490   struct type *builtin_uint32;
1491   struct type *builtin_int64;
1492   struct type *builtin_uint64;
1493   struct type *builtin_int128;
1494   struct type *builtin_uint128;
1495
1496   /* Wide character types.  */
1497   struct type *builtin_char16;
1498   struct type *builtin_char32;
1499
1500   /* Pointer types.  */
1501
1502   /* * `pointer to data' type.  Some target platforms use an implicitly
1503      {sign,zero} -extended 32-bit ABI pointer on a 64-bit ISA.  */
1504   struct type *builtin_data_ptr;
1505
1506   /* * `pointer to function (returning void)' type.  Harvard
1507      architectures mean that ABI function and code pointers are not
1508      interconvertible.  Similarly, since ANSI, C standards have
1509      explicitly said that pointers to functions and pointers to data
1510      are not interconvertible --- that is, you can't cast a function
1511      pointer to void * and back, and expect to get the same value.
1512      However, all function pointer types are interconvertible, so void
1513      (*) () can server as a generic function pointer.  */
1514
1515   struct type *builtin_func_ptr;
1516
1517   /* * `function returning pointer to function (returning void)' type.
1518      The final void return type is not significant for it.  */
1519
1520   struct type *builtin_func_func;
1521
1522   /* Special-purpose types.  */
1523
1524   /* * This type is used to represent a GDB internal function.  */
1525
1526   struct type *internal_fn;
1527
1528   /* * This type is used to represent an xmethod.  */
1529   struct type *xmethod;
1530 };
1531
1532 /* * Return the type table for the specified architecture.  */
1533
1534 extern const struct builtin_type *builtin_type (struct gdbarch *gdbarch);
1535
1536 /* * Per-objfile types used by symbol readers.  */
1537
1538 struct objfile_type
1539 {
1540   /* Basic types based on the objfile architecture.  */
1541   struct type *builtin_void;
1542   struct type *builtin_char;
1543   struct type *builtin_short;
1544   struct type *builtin_int;
1545   struct type *builtin_long;
1546   struct type *builtin_long_long;
1547   struct type *builtin_signed_char;
1548   struct type *builtin_unsigned_char;
1549   struct type *builtin_unsigned_short;
1550   struct type *builtin_unsigned_int;
1551   struct type *builtin_unsigned_long;
1552   struct type *builtin_unsigned_long_long;
1553   struct type *builtin_float;
1554   struct type *builtin_double;
1555   struct type *builtin_long_double;
1556
1557   /* * This type is used to represent symbol addresses.  */
1558   struct type *builtin_core_addr;
1559
1560   /* * This type represents a type that was unrecognized in symbol
1561      read-in.  */
1562   struct type *builtin_error;
1563
1564   /* * Types used for symbols with no debug information.  */
1565   struct type *nodebug_text_symbol;
1566   struct type *nodebug_text_gnu_ifunc_symbol;
1567   struct type *nodebug_got_plt_symbol;
1568   struct type *nodebug_data_symbol;
1569   struct type *nodebug_unknown_symbol;
1570   struct type *nodebug_tls_symbol;
1571 };
1572
1573 /* * Return the type table for the specified objfile.  */
1574
1575 extern const struct objfile_type *objfile_type (struct objfile *objfile);
1576  
1577 /* Explicit floating-point formats.  See "floatformat.h".  */
1578 extern const struct floatformat *floatformats_ieee_half[BFD_ENDIAN_UNKNOWN];
1579 extern const struct floatformat *floatformats_ieee_single[BFD_ENDIAN_UNKNOWN];
1580 extern const struct floatformat *floatformats_ieee_double[BFD_ENDIAN_UNKNOWN];
1581 extern const struct floatformat *floatformats_ieee_double_littlebyte_bigword[BFD_ENDIAN_UNKNOWN];
1582 extern const struct floatformat *floatformats_i387_ext[BFD_ENDIAN_UNKNOWN];
1583 extern const struct floatformat *floatformats_m68881_ext[BFD_ENDIAN_UNKNOWN];
1584 extern const struct floatformat *floatformats_arm_ext[BFD_ENDIAN_UNKNOWN];
1585 extern const struct floatformat *floatformats_ia64_spill[BFD_ENDIAN_UNKNOWN];
1586 extern const struct floatformat *floatformats_ia64_quad[BFD_ENDIAN_UNKNOWN];
1587 extern const struct floatformat *floatformats_vax_f[BFD_ENDIAN_UNKNOWN];
1588 extern const struct floatformat *floatformats_vax_d[BFD_ENDIAN_UNKNOWN];
1589 extern const struct floatformat *floatformats_ibm_long_double[BFD_ENDIAN_UNKNOWN];
1590
1591
1592 /* * Allocate space for storing data associated with a particular
1593    type.  We ensure that the space is allocated using the same
1594    mechanism that was used to allocate the space for the type
1595    structure itself.  I.e.  if the type is on an objfile's
1596    objfile_obstack, then the space for data associated with that type
1597    will also be allocated on the objfile_obstack.  If the type is not
1598    associated with any particular objfile (such as builtin types),
1599    then the data space will be allocated with xmalloc, the same as for
1600    the type structure.  */
1601
1602 #define TYPE_ALLOC(t,size)  \
1603    (TYPE_OBJFILE_OWNED (t) \
1604     ? obstack_alloc (&TYPE_OBJFILE (t) -> objfile_obstack, size) \
1605     : xmalloc (size))
1606
1607 #define TYPE_ZALLOC(t,size)  \
1608    (TYPE_OBJFILE_OWNED (t) \
1609     ? memset (obstack_alloc (&TYPE_OBJFILE (t)->objfile_obstack, size),  \
1610               0, size)  \
1611     : xzalloc (size))
1612
1613 /* Use alloc_type to allocate a type owned by an objfile.  Use
1614    alloc_type_arch to allocate a type owned by an architecture.  Use
1615    alloc_type_copy to allocate a type with the same owner as a
1616    pre-existing template type, no matter whether objfile or
1617    gdbarch.  */
1618 extern struct type *alloc_type (struct objfile *);
1619 extern struct type *alloc_type_arch (struct gdbarch *);
1620 extern struct type *alloc_type_copy (const struct type *);
1621
1622 /* * Return the type's architecture.  For types owned by an
1623    architecture, that architecture is returned.  For types owned by an
1624    objfile, that objfile's architecture is returned.  */
1625
1626 extern struct gdbarch *get_type_arch (const struct type *);
1627
1628 /* * This returns the target type (or NULL) of TYPE, also skipping
1629    past typedefs.  */
1630
1631 extern struct type *get_target_type (struct type *type);
1632
1633 /* * Helper function to construct objfile-owned types.  */
1634
1635 extern struct type *init_type (enum type_code, int, int, const char *,
1636                                struct objfile *);
1637
1638 /* Helper functions to construct architecture-owned types.  */
1639 extern struct type *arch_type (struct gdbarch *, enum type_code, int, char *);
1640 extern struct type *arch_integer_type (struct gdbarch *, int, int, char *);
1641 extern struct type *arch_character_type (struct gdbarch *, int, int, char *);
1642 extern struct type *arch_boolean_type (struct gdbarch *, int, int, char *);
1643 extern struct type *arch_float_type (struct gdbarch *, int, char *,
1644                                      const struct floatformat **);
1645 extern struct type *arch_complex_type (struct gdbarch *, char *,
1646                                        struct type *);
1647
1648 /* Helper functions to construct a struct or record type.  An
1649    initially empty type is created using arch_composite_type().
1650    Fields are then added using append_composite_type_field*().  A union
1651    type has its size set to the largest field.  A struct type has each
1652    field packed against the previous.  */
1653
1654 extern struct type *arch_composite_type (struct gdbarch *gdbarch,
1655                                          char *name, enum type_code code);
1656 extern void append_composite_type_field (struct type *t, char *name,
1657                                          struct type *field);
1658 extern void append_composite_type_field_aligned (struct type *t,
1659                                                  char *name,
1660                                                  struct type *field,
1661                                                  int alignment);
1662 struct field *append_composite_type_field_raw (struct type *t, char *name,
1663                                                struct type *field);
1664
1665 /* Helper functions to construct a bit flags type.  An initially empty
1666    type is created using arch_flag_type().  Flags are then added using
1667    append_flag_type_flag().  */
1668 extern struct type *arch_flags_type (struct gdbarch *gdbarch,
1669                                      char *name, int length);
1670 extern void append_flags_type_flag (struct type *type, int bitpos, char *name);
1671
1672 extern void make_vector_type (struct type *array_type);
1673 extern struct type *init_vector_type (struct type *elt_type, int n);
1674
1675 extern struct type *lookup_reference_type (struct type *);
1676
1677 extern struct type *make_reference_type (struct type *, struct type **);
1678
1679 extern struct type *make_cv_type (int, int, struct type *, struct type **);
1680
1681 extern struct type *make_restrict_type (struct type *);
1682
1683 extern struct type *make_unqualified_type (struct type *);
1684
1685 extern struct type *make_atomic_type (struct type *);
1686
1687 extern void replace_type (struct type *, struct type *);
1688
1689 extern int address_space_name_to_int (struct gdbarch *, char *);
1690
1691 extern const char *address_space_int_to_name (struct gdbarch *, int);
1692
1693 extern struct type *make_type_with_address_space (struct type *type, 
1694                                                   int space_identifier);
1695
1696 extern struct type *lookup_memberptr_type (struct type *, struct type *);
1697
1698 extern struct type *lookup_methodptr_type (struct type *);
1699
1700 extern void smash_to_method_type (struct type *type, struct type *self_type,
1701                                   struct type *to_type, struct field *args,
1702                                   int nargs, int varargs);
1703
1704 extern void smash_to_memberptr_type (struct type *, struct type *,
1705                                      struct type *);
1706
1707 extern void smash_to_methodptr_type (struct type *, struct type *);
1708
1709 extern struct type *allocate_stub_method (struct type *);
1710
1711 extern const char *type_name_no_tag (const struct type *);
1712
1713 extern const char *type_name_no_tag_or_error (struct type *type);
1714
1715 extern struct type *lookup_struct_elt_type (struct type *, const char *, int);
1716
1717 extern struct type *make_pointer_type (struct type *, struct type **);
1718
1719 extern struct type *lookup_pointer_type (struct type *);
1720
1721 extern struct type *make_function_type (struct type *, struct type **);
1722
1723 extern struct type *lookup_function_type (struct type *);
1724
1725 extern struct type *lookup_function_type_with_arguments (struct type *,
1726                                                          int,
1727                                                          struct type **);
1728
1729 extern struct type *create_static_range_type (struct type *, struct type *,
1730                                               LONGEST, LONGEST);
1731
1732
1733 extern struct type *create_array_type_with_stride
1734   (struct type *, struct type *, struct type *, unsigned int);
1735
1736 extern struct type *create_range_type (struct type *, struct type *,
1737                                        const struct dynamic_prop *,
1738                                        const struct dynamic_prop *);
1739
1740 extern struct type *create_array_type (struct type *, struct type *,
1741                                        struct type *);
1742
1743 extern struct type *lookup_array_range_type (struct type *, LONGEST, LONGEST);
1744
1745 extern struct type *create_string_type (struct type *, struct type *,
1746                                         struct type *);
1747 extern struct type *lookup_string_range_type (struct type *, LONGEST, LONGEST);
1748
1749 extern struct type *create_set_type (struct type *, struct type *);
1750
1751 extern struct type *lookup_unsigned_typename (const struct language_defn *,
1752                                               struct gdbarch *, const char *);
1753
1754 extern struct type *lookup_signed_typename (const struct language_defn *,
1755                                             struct gdbarch *, const char *);
1756
1757 extern void get_unsigned_type_max (struct type *, ULONGEST *);
1758
1759 extern void get_signed_type_minmax (struct type *, LONGEST *, LONGEST *);
1760
1761 /* * Resolve all dynamic values of a type e.g. array bounds to static values.
1762    ADDR specifies the location of the variable the type is bound to.
1763    If TYPE has no dynamic properties return TYPE; otherwise a new type with
1764    static properties is returned.  */
1765 extern struct type *resolve_dynamic_type (struct type *type, CORE_ADDR addr);
1766
1767 /* * Predicate if the type has dynamic values, which are not resolved yet.  */
1768 extern int is_dynamic_type (struct type *type);
1769
1770 extern struct type *check_typedef (struct type *);
1771
1772 #define CHECK_TYPEDEF(TYPE)                     \
1773   do {                                          \
1774     (TYPE) = check_typedef (TYPE);              \
1775   } while (0)
1776
1777 extern void check_stub_method_group (struct type *, int);
1778
1779 extern char *gdb_mangle_name (struct type *, int, int);
1780
1781 extern struct type *lookup_typename (const struct language_defn *,
1782                                      struct gdbarch *, const char *,
1783                                      const struct block *, int);
1784
1785 extern struct type *lookup_template_type (char *, struct type *,
1786                                           const struct block *);
1787
1788 extern int get_vptr_fieldno (struct type *, struct type **);
1789
1790 extern int get_discrete_bounds (struct type *, LONGEST *, LONGEST *);
1791
1792 extern int get_array_bounds (struct type *type, LONGEST *low_bound,
1793                              LONGEST *high_bound);
1794
1795 extern int class_types_same_p (const struct type *, const struct type *);
1796
1797 extern int is_ancestor (struct type *, struct type *);
1798
1799 extern int is_public_ancestor (struct type *, struct type *);
1800
1801 extern int is_unique_ancestor (struct type *, struct value *);
1802
1803 /* Overload resolution */
1804
1805 #define LENGTH_MATCH(bv) ((bv)->rank[0])
1806
1807 /* * Badness if parameter list length doesn't match arg list length.  */
1808 extern const struct rank LENGTH_MISMATCH_BADNESS;
1809
1810 /* * Dummy badness value for nonexistent parameter positions.  */
1811 extern const struct rank TOO_FEW_PARAMS_BADNESS;
1812 /* * Badness if no conversion among types.  */
1813 extern const struct rank INCOMPATIBLE_TYPE_BADNESS;
1814
1815 /* * Badness of an exact match.  */
1816 extern const struct rank EXACT_MATCH_BADNESS;
1817
1818 /* * Badness of integral promotion.  */
1819 extern const struct rank INTEGER_PROMOTION_BADNESS;
1820 /* * Badness of floating promotion.  */
1821 extern const struct rank FLOAT_PROMOTION_BADNESS;
1822 /* * Badness of converting a derived class pointer
1823    to a base class pointer.  */
1824 extern const struct rank BASE_PTR_CONVERSION_BADNESS;
1825 /* * Badness of integral conversion.  */
1826 extern const struct rank INTEGER_CONVERSION_BADNESS;
1827 /* * Badness of floating conversion.  */
1828 extern const struct rank FLOAT_CONVERSION_BADNESS;
1829 /* * Badness of integer<->floating conversions.  */
1830 extern const struct rank INT_FLOAT_CONVERSION_BADNESS;
1831 /* * Badness of conversion of pointer to void pointer.  */
1832 extern const struct rank VOID_PTR_CONVERSION_BADNESS;
1833 /* * Badness of conversion to boolean.  */
1834 extern const struct rank BOOL_CONVERSION_BADNESS;
1835 /* * Badness of converting derived to base class.  */
1836 extern const struct rank BASE_CONVERSION_BADNESS;
1837 /* * Badness of converting from non-reference to reference.  */
1838 extern const struct rank REFERENCE_CONVERSION_BADNESS;
1839 /* * Badness of converting integer 0 to NULL pointer.  */
1840 extern const struct rank NULL_POINTER_CONVERSION;
1841
1842 /* Non-standard conversions allowed by the debugger */
1843
1844 /* * Converting a pointer to an int is usually OK.  */
1845 extern const struct rank NS_POINTER_CONVERSION_BADNESS;
1846
1847 /* * Badness of converting a (non-zero) integer constant
1848    to a pointer.  */
1849 extern const struct rank NS_INTEGER_POINTER_CONVERSION_BADNESS;
1850
1851 extern struct rank sum_ranks (struct rank a, struct rank b);
1852 extern int compare_ranks (struct rank a, struct rank b);
1853
1854 extern int compare_badness (struct badness_vector *, struct badness_vector *);
1855
1856 extern struct badness_vector *rank_function (struct type **, int,
1857                                              struct value **, int);
1858
1859 extern struct rank rank_one_type (struct type *, struct type *,
1860                                   struct value *);
1861
1862 extern void recursive_dump_type (struct type *, int);
1863
1864 extern int field_is_static (struct field *);
1865
1866 /* printcmd.c */
1867
1868 extern void print_scalar_formatted (const void *, struct type *,
1869                                     const struct value_print_options *,
1870                                     int, struct ui_file *);
1871
1872 extern int can_dereference (struct type *);
1873
1874 extern int is_integral_type (struct type *);
1875
1876 extern int is_scalar_type_recursive (struct type *);
1877
1878 extern int class_or_union_p (const struct type *);
1879
1880 extern void maintenance_print_type (char *, int);
1881
1882 extern htab_t create_copied_types_hash (struct objfile *objfile);
1883
1884 extern struct type *copy_type_recursive (struct objfile *objfile,
1885                                          struct type *type,
1886                                          htab_t copied_types);
1887
1888 extern struct type *copy_type (const struct type *type);
1889
1890 extern int types_equal (struct type *, struct type *);
1891
1892 extern int types_deeply_equal (struct type *, struct type *);
1893
1894 #endif /* GDBTYPES_H */