gdb: Add $_cimag and $_creal internal functions
authorAndrew Burgess <andrew.burgess@embecosm.com>
Thu, 14 Mar 2019 13:58:58 +0000 (13:58 +0000)
committerAndrew Burgess <andrew.burgess@embecosm.com>
Mon, 1 Apr 2019 20:41:49 +0000 (21:41 +0100)
commit8bdc16587e26100282094c8eaa8e83180ba57afd
tree5e18b77acd219a53d4ac482fd56e060d05927964
parentc29705b71a8ec966478c0dc4712194a95291c6de
gdb: Add $_cimag and $_creal internal functions

Add two new internal functions $_cimag and $_creal that extract the
imaginary and real parts of a complex value.

These internal functions can take a complex value of any type 'float
complex', 'double complex', or 'long double complex' and return a
suitable floating point value 'float', 'double', or 'long double'.
So we can now do this:

    (gdb) p z1
    $1 = 1.5 + 4.5 * I
    (gdb) p $_cimag (z1)
    $4 = 4.5
    (gdb) p $_creal (z1)
    $4 = 1.5

The components of a complex value are not strictly named types in
DWARF, as the complex type is itself the base type.  However, once we
are able to extract the components it makes sense to be able to ask
what the type of these components is and get a sensible answer back,
rather than the error we would currently get.  Currently GDB says:

    (gdb) ptype z1
    type = complex double
    (gdb) p $_cimag (z1)
    $4 = 4.5
    (gdb) ptype $
    type = <invalid type code 9>

With the changes in dwarf2read.c, GDB now says:

    (gdb) ptype z1
    type = complex double
    (gdb) p $_cimag (z1)
    $4 = 4.5
    (gdb) ptype $
    type = double

Which seems to make more sense.

gdb/ChangeLog:

* NEWS: Mention new internal functions.
* dwarf2read.c (dwarf2_init_complex_target_type): New function.
(read_base_type): Use dwarf2_init_complex_target_type.
* value.c (creal_internal_fn): New function.
(cimag_internal_fn): New function.
(_initialize_values): Register new internal functions.

gdb/doc/ChangeLog:

* gdb.texinfo (Convenience Funs): Document '$_creal' and
'$_cimag'.

gdb/testsuite/ChangeLog:

* gdb.base/complex-parts.c: New file.
* gdb.base/complex-parts.exp: New file.
gdb/ChangeLog
gdb/NEWS
gdb/doc/ChangeLog
gdb/doc/gdb.texinfo
gdb/dwarf2read.c
gdb/testsuite/ChangeLog
gdb/testsuite/gdb.base/complex-parts.c [new file with mode: 0644]
gdb/testsuite/gdb.base/complex-parts.exp [new file with mode: 0644]
gdb/testsuite/gdb.base/default.exp
gdb/value.c