Next: Guile Pretty Printing API, Previous: Arithmetic In Guile, Up: Guile API
gdb represents types from the inferior in objects of type
<gdb:type>.
The following type-related procedures are provided by the
(gdb) module.
Return
#tif object is an object of type<gdb:type>. Otherwise return#f.
This function looks up a type by its name, which must be a string.
If block is given, it is an object of type
<gdb:block>, and name is looked up in that scope. Otherwise, it is searched for globally.Ordinarily, this function will return an instance of
<gdb:type>. If the named type cannot be found, it will throw an exception.
Return the type code of type. The type code will be one of the
TYPE_CODE_constants defined below.
Return the tag name of type. The tag name is the name after
struct,union, orenumin C and C++; not all languages have this concept. If this type has no tag name, then#fis returned.
Return the name of type. If this type has no name, then
#fis returned.
Return the print name of type. This returns something even for anonymous types. For example, for an anonymous C struct
"struct {...}"is returned.
Return the size of this type, in target
charunits. Usually, a target'schartype will be an 8-bit byte. However, on some unusual platforms, this type may have a different size.
Return a new
<gdb:type>that represents the real type of type, after removing all layers of typedefs.
Return a new
<gdb:type>object which represents an array of this type. If one argument is given, it is the inclusive upper bound of the array; in this case the lower bound is zero. If two arguments are given, the first argument is the lower bound of the array, and the second argument is the upper bound of the array. An array's length must not be negative, but the bounds can be.
Return a new
<gdb:type>object which represents a vector of this type. If one argument is given, it is the inclusive upper bound of the vector; in this case the lower bound is zero. If two arguments are given, the first argument is the lower bound of the vector, and the second argument is the upper bound of the vector. A vector's length must not be negative, but the bounds can be.The difference between an
arrayand avectoris that arrays behave like in C: when used in expressions they decay to a pointer to the first element whereas vectors are treated as first class values.
Return a new
<gdb:type>object which represents a pointer to type.
Return a list of two elements: the low bound and high bound of type. If type does not have a range, an exception is thrown.
Return a new
<gdb:type>object which represents a reference to type.
Return a new
<gdb:type>object which represents the target type of type.For a pointer type, the target type is the type of the pointed-to object. For an array type (meaning C-like arrays), the target type is the type of the elements of the array. For a function or method type, the target type is the type of the return value. For a complex type, the target type is the type of the elements. For a typedef, the target type is the aliased type.
If the type does not have a target, this method will throw an exception.
Return a new
<gdb:type>object which represents aconst-qualified variant of type.
Return a new
<gdb:type>object which represents avolatile-qualified variant of type.
Return a new
<gdb:type>object which represents an unqualified variant of type. That is, the result is neitherconstnorvolatile.
Return the fields of type as a list. For structure and union types,
fieldshas the usual meaning. Range types have two fields, the minimum and maximum values. Enum types have one field per enum constant. Function and method types have one field per parameter. The base types of C++ classes are also represented as fields. If the type has no fields, or does not fit into one of these categories, an empty list will be returned. See Fields of a type in Guile.
Return the fields of type as a <gdb:iterator> object. See Iterators In Guile.
Return field named field-name in type. The result is an object of type
<gdb:field>. See Fields of a type in Guile. If the type does not have fields, or field-name is not a field of type, an exception is thrown.For example, if
some-typeis a<gdb:type>instance holding a structure type, you can access itsfoofield with:(define bar (type-field some-type "foo"))
barwill be a<gdb:field>object.
Return
#tif<gdb:type>type has field named name. Otherwise return#f.
Each type has a code, which indicates what category this type falls
into. The available type categories are represented by constants
defined in the (gdb) module:
TYPE_CODE_PTRTYPE_CODE_ARRAYTYPE_CODE_STRUCTTYPE_CODE_UNIONTYPE_CODE_ENUMTYPE_CODE_FLAGSTYPE_CODE_FUNCTYPE_CODE_INTTYPE_CODE_FLTTYPE_CODE_VOIDvoid.
TYPE_CODE_SETTYPE_CODE_RANGETYPE_CODE_STRINGTYPE_CODE_BITSTRINGTYPE_CODE_ERRORTYPE_CODE_METHODTYPE_CODE_METHODPTRTYPE_CODE_MEMBERPTRTYPE_CODE_REFTYPE_CODE_CHARTYPE_CODE_BOOLTYPE_CODE_COMPLEXTYPE_CODE_TYPEDEFTYPE_CODE_NAMESPACETYPE_CODE_DECFLOATTYPE_CODE_INTERNAL_FUNCTIONFurther support for types is provided in the (gdb types)
Guile module (see Guile Types Module).
Each field is represented as an object of type <gdb:field>.
The following field-related procedures are provided by the
(gdb) module:
Return
#tif object is an object of type<gdb:field>. Otherwise return#f.
Return the type of the field. This is usually an instance of
<gdb:type>, but it can be#fin some situations.
Return the bit position of
<gdb:field>field. This attribute is not available forstaticfields (as in C++ or Java).
If the field is packed, or is a bitfield, return the size of
<gdb:field>field in bits. Otherwise, zero is returned; in which case the field's size is given by its type.