gdb.types - Debugging with GDB
Description: Debugging with GDB

Next: gdb.prompt, Previous: gdb.printing, Up: Python modules

##### 23.2.4.2 gdb.types

This module provides a collection of utilities for working with `gdb.Type` objects.

`get_basic_type (`type`)`
  Return type with const and volatile qualifiers stripped, and with typedefs and C`++` references converted to the underlying type.

  C`++` example:

                typedef const int const_int;
                const_int foo (3);
                const_int& foo_ref (foo);
                int main () { return 0; }

  Then in gdb:

                (gdb) start
                (gdb) python import gdb.types
                (gdb) python foo_ref = gdb.parse_and_eval("foo_ref")
                (gdb) python print gdb.types.get_basic_type(foo_ref.type)
                int

`has_field (`type`,` field`)`
  Return `True` if type, assumed to be a type with fields (e.g., a structure or union), has field field.
`make_enum_dict (`enum_type`)`
  Return a Python `dictionary` type produced from enum_type.
`deep_items (`type`)`
  Returns a Python iterator similar to the standard `gdb.Type.iteritems` method, except that the iterator returned by `deep_items` will recursively traverse anonymous struct or union fields. For example:

                struct A
                {
                    int a;
                    union {
                        int b0;
                        int b1;
                    };
                };

  Then in gdb:

                (gdb) python import gdb.types
                (gdb) python struct_a = gdb.lookup_type("struct A")
                (gdb) python print struct_a.keys ()
                {['a', '']}
                (gdb) python print [k for k,v in gdb.types.deep_items(struct_a)]
                {['a', 'b0', 'b1']}

`get_type_recognizers ()`
  Return a list of the enabled type recognizers for the current context. This is called by gdb during the type-printing process (see Type Printing API).
`apply_type_recognizers (recognizers, type_obj)`
  Apply the type recognizers, recognizers, to the type object type_obj. If any recognizer returns a string, return that string. Otherwise, return `None`. This is called by gdb during the type-printing process (see Type Printing API).
`register_type_printer (locus, printer)`
  This is a convenience function to register a type printer. printer is the type printer to register. It must implement the type printer protocol. locus is either a `gdb.Objfile`, in which case the printer is registered with that objfile; a `gdb.Progspace`, in which case the printer is registered with that progspace; or `None`, in which case the printer is registered globally.
`TypePrinter`
  This is a base class that implements the type printer protocol. Type printers are encouraged, but not required, to derive from this class. It defines a constructor:
  — Method on TypePrinter: __init__ (self, name)

  > Initialize the type printer with the given name. The new printer starts in the enabled state.