/* Definitions for values of C expressions, for GDB.
- Copyright 1986, 1987, 1989, 1992-1996, 2000 Free Software Foundation, Inc.
+ Copyright 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994,
+ 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003
+ Free Software Foundation, Inc.
This file is part of GDB.
#if !defined (VALUE_H)
#define VALUE_H 1
+struct regcache;
+struct block;
+
+#include "doublest.h"
+
/*
* The structure which defines the type of a value. It should never
* be possible for a program lval value to survive over a call to the inferior
at the same place in memory. This will be described in the
lval enum above as "lval_reg_frame_relative". */
CORE_ADDR frame_addr;
+
/* Type of the value. */
struct type *type;
- /* Type of the enclosing object if this is an embedded subobject.
- The member embedded_offset gives the real position of the subobject
- if type is not the same as enclosing_type.
- If the type field is a pointer type, then enclosing_type is
- a pointer type pointing to the real (enclosing) type of the target
- object. */
+ /* If a value represents a C++ object, then the `type' field gives
+ the object's compile-time type. If the object actually belongs
+ to some class derived from `type', perhaps with other base
+ classes and additional members, then `type' is just a subobject
+ of the real thing, and the full object is probably larger than
+ `type' would suggest.
+
+ If `type' is a dynamic class (i.e. one with a vtable), then GDB
+ can actually determine the object's run-time type by looking at
+ the run-time type information in the vtable. When this
+ information is available, we may elect to read in the entire
+ object, for several reasons:
+
+ - When printing the value, the user would probably rather see
+ the full object, not just the limited portion apparent from
+ the compile-time type.
+
+ - If `type' has virtual base classes, then even printing
+ `type' alone may require reaching outside the `type'
+ portion of the object to wherever the virtual base class
+ has been stored.
+
+ When we store the entire object, `enclosing_type' is the
+ run-time type --- the complete object --- and `embedded_offset'
+ is the offset of `type' within that larger type, in bytes. The
+ VALUE_CONTENTS macro takes `embedded_offset' into account, so
+ most GDB code continues to see the `type' portion of the value,
+ just as the inferior would.
+
+ If `type' is a pointer to an object, then `enclosing_type' is a
+ pointer to the object's run-time type, and `pointed_to_offset'
+ is the offset in bytes from the full object to the pointed-to
+ object --- that is, the value `embedded_offset' would have if
+ we followed the pointer and fetched the complete object. (I
+ don't really see the point. Why not just determine the
+ run-time type when you indirect, and avoid the special case?
+ The contents don't matter until you indirect anyway.)
+
+ If we're not doing anything fancy, `enclosing_type' is equal to
+ `type', and `embedded_offset' is zero, so everything works
+ normally. */
struct type *enclosing_type;
+ int embedded_offset;
+ int pointed_to_offset;
+
/* Values are stored in a chain, so that they can be deleted
easily over calls to the inferior. Values assigned to internal
variables or put into the value history are taken off this
list. */
struct value *next;
- /* ??? When is this used? */
- union
- {
- CORE_ADDR memaddr;
- char *myaddr;
- }
- substring_addr;
-
/* Register number if the value is from a register. Is not kept
if you take a field of a structure that is stored in a
register. Shouldn't it be? */
/* If zero, contents of this value are in the contents field.
If nonzero, contents are in inferior memory at address
in the location.address field plus the offset field
- (and the lval field should be lval_memory). */
+ (and the lval field should be lval_memory).
+
+ WARNING: This field is used by the code which handles
+ watchpoints (see breakpoint.c) to decide whether a particular
+ value can be watched by hardware watchpoints. If the lazy flag
+ is set for some member of a value chain, it is assumed that
+ this member of the chain doesn't need to be watched as part of
+ watching the value itself. This is how GDB avoids watching the
+ entire struct or array when the user wants to watch a single
+ struct member or array element. If you ever change the way
+ lazy flag is set and reset, be sure to consider this use as
+ well! */
char lazy;
/* If nonzero, this is the value of a variable which does not
actually exist in the program. */
char optimized_out;
- /* If this value represents an object that is embedded inside a
- larger object (e.g., a base subobject in C++), this gives the
- offset (in bytes) from the start of the contents buffer where
- the embedded object begins. This is required because some C++
- runtime implementations lay out objects (especially virtual bases
- with possibly negative offsets to ancestors).
- Note: This may be positive or negative! Also note that this offset
- is not used when retrieving contents from target memory; the entire
- enclosing object has to be retrieved always, and the offset for
- that is given by the member offset above. */
- int embedded_offset;
- /* If this value represents a pointer to an object that is embedded
- in another object, this gives the embedded_offset of the object
- that is pointed to. */
- int pointed_to_offset;
/* The BFD section associated with this value. */
asection *bfd_section;
/* Actual contents of the value. For use of this value; setting
union
{
long contents[1];
- double force_double_align;
- LONGEST force_longlong_align;
- char *literal_data;
+ DOUBLEST force_doublest_align;
+ LONGEST force_longest_align;
+ CORE_ADDR force_core_addr_align;
+ void *force_pointer_align;
}
aligner;
/* Do not add any new members here -- contents above will trash them */
};
-typedef struct value *value_ptr;
-
#define VALUE_TYPE(val) (val)->type
#define VALUE_ENCLOSING_TYPE(val) (val)->enclosing_type
#define VALUE_LAZY(val) (val)->lazy
VALUE_CONTENTS_ALL_RAW(val))
-extern int value_fetch_lazy (value_ptr val);
+extern int value_fetch_lazy (struct value *val);
#define VALUE_LVAL(val) (val)->lval
#define VALUE_ADDRESS(val) (val)->location.address
#define COERCE_NUMBER(arg) \
do { COERCE_ARRAY(arg); COERCE_ENUM(arg); } while (0)
-#define COERCE_VARYING_ARRAY(arg, real_arg_type) \
-{ if (chill_varying_type (real_arg_type)) \
- arg = varying_to_slice (arg), real_arg_type = VALUE_TYPE (arg); }
+/* NOTE: cagney/2002-12-17: This macro was handling a chill language
+ problem but that language has gone away. */
+#define COERCE_VARYING_ARRAY(arg, real_arg_type)
/* If ARG is an enum, convert it to an integer. */
{
struct internalvar *next;
char *name;
- value_ptr value;
+ struct value *value;
};
/* Pointer to member function. Depends on compiler implementation. */
extern void print_address_demangle (CORE_ADDR, struct ui_file *, int);
-extern LONGEST value_as_long (value_ptr val);
+extern LONGEST value_as_long (struct value *val);
-extern DOUBLEST value_as_double (value_ptr val);
+extern DOUBLEST value_as_double (struct value *val);
-extern CORE_ADDR value_as_pointer (value_ptr val);
+extern CORE_ADDR value_as_address (struct value *val);
-extern LONGEST unpack_long (struct type *type, char *valaddr);
+extern LONGEST unpack_long (struct type *type, const char *valaddr);
-extern DOUBLEST unpack_double (struct type *type, char *valaddr, int *invp);
+extern DOUBLEST unpack_double (struct type *type, const char *valaddr,
+ int *invp);
-extern CORE_ADDR unpack_pointer (struct type *type, char *valaddr);
+extern CORE_ADDR unpack_pointer (struct type *type, const char *valaddr);
-extern LONGEST unpack_field_as_long (struct type *type, char *valaddr,
+extern LONGEST unpack_field_as_long (struct type *type, const char *valaddr,
int fieldno);
-extern value_ptr value_from_longest (struct type *type, LONGEST num);
+extern struct value *value_from_longest (struct type *type, LONGEST num);
-extern value_ptr value_from_pointer (struct type *type, CORE_ADDR addr);
+extern struct value *value_from_pointer (struct type *type, CORE_ADDR addr);
-extern value_ptr value_from_double (struct type *type, DOUBLEST num);
+extern struct value *value_from_double (struct type *type, DOUBLEST num);
-extern value_ptr value_from_string (char *string);
+extern struct value *value_from_string (char *string);
-extern value_ptr value_at (struct type *type, CORE_ADDR addr,
- asection * sect);
+extern struct value *value_at (struct type *type, CORE_ADDR addr,
+ asection * sect);
-extern value_ptr value_at_lazy (struct type *type, CORE_ADDR addr,
- asection * sect);
+extern struct value *value_at_lazy (struct type *type, CORE_ADDR addr,
+ asection * sect);
-extern value_ptr value_from_register (struct type *type, int regnum,
- struct frame_info *frame);
+extern struct value *value_from_register (struct type *type, int regnum,
+ struct frame_info *frame);
-extern value_ptr value_of_variable (struct symbol *var, struct block *b);
+extern struct value *value_of_variable (struct symbol *var, struct block *b);
-extern value_ptr value_of_register (int regnum);
+extern struct value *value_of_register (int regnum,
+ struct frame_info *frame);
extern int symbol_read_needs_frame (struct symbol *);
-extern value_ptr read_var_value (struct symbol *var,
- struct frame_info *frame);
+extern struct value *read_var_value (struct symbol *var,
+ struct frame_info *frame);
+
+extern struct value *locate_var_value (struct symbol *var,
+ struct frame_info *frame);
-extern value_ptr locate_var_value (struct symbol *var,
- struct frame_info *frame);
+extern struct value *allocate_value (struct type *type);
-extern value_ptr allocate_value (struct type *type);
+extern struct value *allocate_repeat_value (struct type *type, int count);
-extern value_ptr allocate_repeat_value (struct type *type, int count);
+extern struct value *value_change_enclosing_type (struct value *val,
+ struct type *new_type);
-extern value_ptr value_mark (void);
+extern struct value *value_mark (void);
-extern void value_free_to_mark (value_ptr mark);
+extern void value_free_to_mark (struct value *mark);
-extern value_ptr value_string (char *ptr, int len);
-extern value_ptr value_bitstring (char *ptr, int len);
+extern struct value *value_string (char *ptr, int len);
+extern struct value *value_bitstring (char *ptr, int len);
-extern value_ptr value_array (int lowbound, int highbound,
- value_ptr * elemvec);
+extern struct value *value_array (int lowbound, int highbound,
+ struct value ** elemvec);
-extern value_ptr value_concat (value_ptr arg1, value_ptr arg2);
+extern struct value *value_concat (struct value *arg1, struct value *arg2);
-extern value_ptr value_binop (value_ptr arg1, value_ptr arg2,
- enum exp_opcode op);
+extern struct value *value_binop (struct value *arg1, struct value *arg2,
+ enum exp_opcode op);
-extern value_ptr value_add (value_ptr arg1, value_ptr arg2);
+extern struct value *value_add (struct value *arg1, struct value *arg2);
-extern value_ptr value_sub (value_ptr arg1, value_ptr arg2);
+extern struct value *value_sub (struct value *arg1, struct value *arg2);
-extern value_ptr value_coerce_array (value_ptr arg1);
+extern struct value *value_coerce_array (struct value *arg1);
-extern value_ptr value_coerce_function (value_ptr arg1);
+extern struct value *value_coerce_function (struct value *arg1);
-extern value_ptr value_ind (value_ptr arg1);
+extern struct value *value_ind (struct value *arg1);
-extern value_ptr value_addr (value_ptr arg1);
+extern struct value *value_addr (struct value *arg1);
-extern value_ptr value_assign (value_ptr toval, value_ptr fromval);
+extern struct value *value_assign (struct value *toval, struct value *fromval);
-extern value_ptr value_neg (value_ptr arg1);
+extern struct value *value_neg (struct value *arg1);
-extern value_ptr value_complement (value_ptr arg1);
+extern struct value *value_complement (struct value *arg1);
-extern value_ptr value_struct_elt (value_ptr * argp, value_ptr * args,
- char *name,
- int *static_memfuncp, char *err);
+extern struct value *value_struct_elt (struct value **argp,
+ struct value **args,
+ char *name, int *static_memfuncp,
+ char *err);
-extern value_ptr value_struct_elt_for_reference (struct type *domain,
- int offset,
- struct type *curtype,
- char *name,
- struct type *intype);
+extern struct value *value_struct_elt_for_reference (struct type *domain,
+ int offset,
+ struct type *curtype,
+ char *name,
+ struct type *intype);
-extern value_ptr value_static_field (struct type *type, int fieldno);
+extern struct value *value_static_field (struct type *type, int fieldno);
-extern struct fn_field *value_find_oload_method_list (value_ptr *, char *,
- int, int *, int *,
+extern struct fn_field *value_find_oload_method_list (struct value **, char *,
+ int, int *,
struct type **, int *);
extern int find_overload_match (struct type **arg_types, int nargs,
char *name, int method, int lax,
- value_ptr obj, struct symbol *fsym,
- value_ptr * valp, struct symbol **symp,
+ struct value **objp, struct symbol *fsym,
+ struct value **valp, struct symbol **symp,
int *staticp);
-extern value_ptr value_field (value_ptr arg1, int fieldno);
+extern struct value *value_field (struct value *arg1, int fieldno);
-extern value_ptr value_primitive_field (value_ptr arg1, int offset,
- int fieldno, struct type *arg_type);
+extern struct value *value_primitive_field (struct value *arg1, int offset,
+ int fieldno,
+ struct type *arg_type);
-extern struct type *value_rtti_type (value_ptr, int *, int *, int *);
-extern struct type *value_rtti_target_type (value_ptr, int *, int *, int *);
+extern struct type *value_rtti_target_type (struct value *, int *, int *,
+ int *);
-extern value_ptr value_full_object (value_ptr, struct type *, int, int, int);
+extern struct value *value_full_object (struct value *, struct type *, int,
+ int, int);
-extern value_ptr value_cast (struct type *type, value_ptr arg2);
+extern struct value *value_cast (struct type *type, struct value *arg2);
-extern value_ptr value_zero (struct type *type, enum lval_type lv);
+extern struct value *value_zero (struct type *type, enum lval_type lv);
-extern value_ptr value_repeat (value_ptr arg1, int count);
+extern struct value *value_repeat (struct value *arg1, int count);
-extern value_ptr value_subscript (value_ptr array, value_ptr idx);
+extern struct value *value_subscript (struct value *array, struct value *idx);
-extern value_ptr value_from_vtable_info (value_ptr arg, struct type *type);
+extern struct value *value_being_returned (struct type *valtype,
+ struct regcache *retbuf,
+ int struct_return);
-extern value_ptr value_being_returned (struct type *valtype,
- char *retbuf, int struct_return);
-
-extern value_ptr value_in (value_ptr element, value_ptr set);
+extern struct value *value_in (struct value *element, struct value *set);
extern int value_bit_index (struct type *type, char *addr, int index);
-extern int using_struct_return (value_ptr function, CORE_ADDR funcaddr,
+extern int using_struct_return (struct value *function, CORE_ADDR funcaddr,
struct type *value_type, int gcc_p);
-extern void set_return_value (value_ptr val);
+extern void set_return_value (struct value *val);
-extern value_ptr evaluate_expression (struct expression *exp);
+extern struct value *evaluate_expression (struct expression *exp);
-extern value_ptr evaluate_type (struct expression *exp);
+extern struct value *evaluate_type (struct expression *exp);
-extern value_ptr evaluate_subexp_with_coercion (struct expression *,
- int *, enum noside);
+extern struct value *evaluate_subexp_with_coercion (struct expression *,
+ int *, enum noside);
-extern value_ptr parse_and_eval (char *exp);
+extern struct value *parse_and_eval (char *exp);
-extern value_ptr parse_to_comma_and_eval (char **expp);
+extern struct value *parse_to_comma_and_eval (char **expp);
extern struct type *parse_and_eval_type (char *p, int length);
extern CORE_ADDR parse_and_eval_address_1 (char **expptr);
-extern value_ptr access_value_history (int num);
+extern LONGEST parse_and_eval_long (char *exp);
+
+extern struct value *access_value_history (int num);
-extern value_ptr value_of_internalvar (struct internalvar *var);
+extern struct value *value_of_internalvar (struct internalvar *var);
-extern void set_internalvar (struct internalvar *var, value_ptr val);
+extern void set_internalvar (struct internalvar *var, struct value *val);
extern void set_internalvar_component (struct internalvar *var,
int offset,
int bitpos, int bitsize,
- value_ptr newvalue);
+ struct value *newvalue);
extern struct internalvar *lookup_internalvar (char *name);
-extern int value_equal (value_ptr arg1, value_ptr arg2);
+extern int value_equal (struct value *arg1, struct value *arg2);
-extern int value_less (value_ptr arg1, value_ptr arg2);
+extern int value_less (struct value *arg1, struct value *arg2);
-extern int value_logical_not (value_ptr arg1);
+extern int value_logical_not (struct value *arg1);
/* C++ */
-extern value_ptr value_of_this (int complain);
+extern struct value *value_of_this (int complain);
-extern value_ptr value_x_binop (value_ptr arg1, value_ptr arg2,
- enum exp_opcode op,
- enum exp_opcode otherop, enum noside noside);
+extern struct value *value_x_binop (struct value *arg1, struct value *arg2,
+ enum exp_opcode op,
+ enum exp_opcode otherop,
+ enum noside noside);
-extern value_ptr value_x_unop (value_ptr arg1, enum exp_opcode op,
- enum noside noside);
+extern struct value *value_x_unop (struct value *arg1, enum exp_opcode op,
+ enum noside noside);
-extern value_ptr value_fn_field (value_ptr * arg1p, struct fn_field *f,
- int j, struct type *type, int offset);
+extern struct value *value_fn_field (struct value ** arg1p, struct fn_field *f,
+ int j, struct type *type, int offset);
-extern value_ptr value_virtual_fn_field (value_ptr * arg1p,
- struct fn_field *f, int j,
- struct type *type, int offset);
+extern int binop_user_defined_p (enum exp_opcode op, struct value *arg1,
+ struct value *arg2);
-extern int binop_user_defined_p (enum exp_opcode op,
- value_ptr arg1, value_ptr arg2);
-
-extern int unop_user_defined_p (enum exp_opcode op, value_ptr arg1);
+extern int unop_user_defined_p (enum exp_opcode op, struct value *arg1);
extern int destructor_name_p (const char *name, const struct type *type);
-#define value_free(val) free ((PTR)val)
+#define value_free(val) xfree (val)
extern void free_all_values (void);
-extern void release_value (value_ptr val);
-
-extern int record_latest_value (value_ptr val);
-
-extern void registers_changed (void);
-
-extern void read_register_bytes (int regbyte, char *myaddr, int len);
-
-extern void write_register_bytes (int regbyte, char *myaddr, int len);
-
-extern void read_register_gen (int regno, char *myaddr);
-
-extern void write_register_gen (int regno, char *myaddr);
-
-extern CORE_ADDR read_register (int regno);
+extern void release_value (struct value *val);
-extern CORE_ADDR read_register_pid (int regno, int pid);
+extern int record_latest_value (struct value *val);
-extern void write_register (int regno, LONGEST val);
-
-extern void write_register_pid (int regno, CORE_ADDR val, int pid);
-
-extern void supply_register (int regno, char *val);
-
-extern void get_saved_register (char *raw_buffer, int *optimized,
- CORE_ADDR * addrp,
- struct frame_info *frame,
- int regnum, enum lval_type *lval);
-
-extern void
-modify_field (char *addr, LONGEST fieldval, int bitpos, int bitsize);
+extern void modify_field (char *addr, LONGEST fieldval, int bitpos,
+ int bitsize);
extern void type_print (struct type * type, char *varstring,
struct ui_file * stream, int show);
-extern char *baseclass_addr (struct type *type, int index,
- char *valaddr, value_ptr * valuep, int *errp);
+extern char *baseclass_addr (struct type *type, int index, char *valaddr,
+ struct value **valuep, int *errp);
extern void print_longest (struct ui_file * stream, int format,
int use_local, LONGEST val);
extern void print_floating (char *valaddr, struct type * type,
struct ui_file * stream);
-extern int value_print (value_ptr val, struct ui_file *stream, int format,
+extern int value_print (struct value *val, struct ui_file *stream, int format,
enum val_prettyprint pretty);
-extern void value_print_array_elements (value_ptr val,
- struct ui_file *stream,
- int format,
+extern void value_print_array_elements (struct value *val,
+ struct ui_file *stream, int format,
enum val_prettyprint pretty);
-extern value_ptr value_release_to_mark (value_ptr mark);
+extern struct value *value_release_to_mark (struct value *mark);
extern int val_print (struct type * type, char *valaddr,
int embedded_offset, CORE_ADDR address,
struct frame_info * frame,
struct ui_file *stream);
-extern int check_field (value_ptr, const char *);
+extern int check_field (struct value *, const char *);
-extern void c_typedef_print (struct type * type, struct symbol * news,
+extern void typedef_print (struct type * type, struct symbol * news,
struct ui_file * stream);
extern char *internalvar_name (struct internalvar *var);
/* From values.c */
-extern value_ptr value_copy (value_ptr);
-
-extern int baseclass_offset (struct type *, int, char *, CORE_ADDR);
+extern struct value *value_copy (struct value *);
/* From valops.c */
-extern value_ptr varying_to_slice (value_ptr);
-
-extern value_ptr value_slice (value_ptr, int, int);
+extern struct value *varying_to_slice (struct value *);
-extern value_ptr call_function_by_hand (value_ptr, int, value_ptr *);
+extern struct value *value_slice (struct value *, int, int);
-extern int default_coerce_float_to_double (struct type *, struct type *);
+extern struct value *call_function_by_hand (struct value *, int,
+ struct value **);
-extern int standard_coerce_float_to_double (struct type *, struct type *);
-
-extern value_ptr value_literal_complex (value_ptr, value_ptr, struct type *);
+extern struct value *value_literal_complex (struct value *, struct value *,
+ struct type *);
extern void find_rt_vbase_offset (struct type *, struct type *, char *, int,
int *, int *);
-extern value_ptr find_function_in_inferior (char *);
+extern struct value *find_function_in_inferior (const char *);
-extern value_ptr value_allocate_space_in_inferior (int);
+extern struct value *value_allocate_space_in_inferior (int);
-extern CORE_ADDR default_push_arguments (int nargs, value_ptr * args,
- CORE_ADDR sp,
- int struct_return,
+extern CORE_ADDR default_push_arguments (int nargs, struct value ** args,
+ CORE_ADDR sp, int struct_return,
CORE_ADDR struct_addr);
+extern struct value *value_of_local (const char *name, int complain);
+
#endif /* !defined (VALUE_H) */