[deliverable/binutils-gdb.git] / gdb / value.h

/* Definitions for values of C expressions, for GDB.
   Copyright 1986, 1987, 1989, 1992, 1993, 1994 Free Software Foundation, Inc.

This file is part of GDB.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */

#if !defined (VALUE_H)
#define VALUE_H 1

/*
 * 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
 * (ie to be put into the history list or an internal variable).
 */
enum lval_type {
  /* Not an lval.  */
  not_lval,
  /* In memory.  Could be a saved register.  */
  lval_memory,
  /* In a register.  */
  lval_register,
  /* In a gdb internal variable.  */
  lval_internalvar,
  /* Part of a gdb internal variable (structure field).  */
  lval_internalvar_component,
  /* In a register series in a frame not the current one, which may have been
     partially saved or saved in different places (otherwise would be
     lval_register or lval_memory).  */
  lval_reg_frame_relative
};

struct value
  {
    /* Type of value; either not an lval, or one of the various
       different possible kinds of lval.  */
    enum lval_type lval;
    /* Is it modifiable?  Only relevant if lval != not_lval.  */
    int modifiable;
    /* Location of value (if lval).  */
    union
      {
	/* Address in inferior or byte of registers structure.  */
	CORE_ADDR address;
	/* Pointer to internal variable.  */
	struct internalvar *internalvar;
	/* Number of register.  Only used with
	   lval_reg_frame_relative.  */
	int regnum;
      } location;
    /* Describes offset of a value within lval a structure in bytes.  */
    int offset;	
    /* Only used for bitfields; number of bits contained in them.  */
    int bitsize;
    /* Only used for bitfields; position of start of field.
       For BITS_BIG_ENDIAN=0 targets, it is the position of the LSB.
       For BITS_BIG_ENDIAN=1 targets, it is the position of the MSB. */
    int bitpos;
    /* Frame value is relative to.  In practice, this address is only
       used if the value is stored in several registers in other than
       the current frame, and these registers have not all been saved
       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;
    /* 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;
    /* If an lval is forced to repeat, a new value is created with
       these fields set.  The new value is not an lval.  */
    short repeated;
    short repetitions;
    /* 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?  */
    short regno;
    /* 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).  */
    char lazy;
    /* If nonzero, this is the value of a variable which does not
       actually exist in the program.  */
    char optimized_out;
    /* Actual contents of the value.  For use of this value; setting
       it uses the stuff above.  Not valid if lazy is nonzero.
       Target byte-order.  We force it to be aligned properly for any
       possible value.  */
    union {
      long contents[1];
      double force_double_align;
      LONGEST force_longlong_align;
    } aligner;

  };

typedef struct value *value_ptr;

#define VALUE_TYPE(val) (val)->type
#define VALUE_LAZY(val) (val)->lazy
/* VALUE_CONTENTS and VALUE_CONTENTS_RAW both return the address of
   the gdb buffer used to hold a copy of the contents of the lval.  
   VALUE_CONTENTS is used when the contents of the buffer are needed --
   it uses value_fetch_lazy() to load the buffer from the process being 
   debugged if it hasn't already been loaded.  VALUE_CONTENTS_RAW is 
   used when data is being stored into the buffer, or when it is 
   certain that the contents of the buffer are valid.  */
#define VALUE_CONTENTS_RAW(val) ((char *) (val)->aligner.contents)
#define VALUE_CONTENTS(val) ((void)(VALUE_LAZY(val) && value_fetch_lazy(val)),\
			     VALUE_CONTENTS_RAW(val))
extern int value_fetch_lazy PARAMS ((value_ptr val));

#define VALUE_LVAL(val) (val)->lval
#define VALUE_ADDRESS(val) (val)->location.address
#define VALUE_INTERNALVAR(val) (val)->location.internalvar
#define VALUE_FRAME_REGNUM(val) ((val)->location.regnum)
#define VALUE_FRAME(val) ((val)->frame_addr)
#define VALUE_OFFSET(val) (val)->offset
#define VALUE_BITSIZE(val) (val)->bitsize
#define VALUE_BITPOS(val) (val)->bitpos
#define VALUE_NEXT(val) (val)->next
#define VALUE_REPEATED(val) (val)->repeated
#define VALUE_REPETITIONS(val) (val)->repetitions
#define VALUE_REGNO(val) (val)->regno
#define VALUE_OPTIMIZED_OUT(val) ((val)->optimized_out)

/* This is probably not the right thing to do for in-gdb arrays.  FIXME */
/* Overload the contents field to store literal data for 
   arrays.  */

#define VALUE_LITERAL_DATA(val)  ((val)->aligner.contents[0])

/* Overload the frame address field to contain a pointer to 
   the base substring, for F77 string substring operators.
   We use this ONLY when doing operations of the form 
   
   FOO= 'hello' 
   FOO(2:4) = 'foo'

   In the above case VALUE_SUBSTRING_START would point to 
   FOO(2) in the original FOO string. 

   Depending on whether the base object is allocated in the 
   inferior or the superior process, VALUE_SUBSTRING_START 
   contains a ptr. to memory in the relevant area.  */ 

#define VALUE_SUBSTRING_START(val) VALUE_FRAME(val)

/* Convert a REF to the object referenced. */

#define COERCE_REF(arg)    \
{ if (TYPE_CODE (VALUE_TYPE (arg)) == TYPE_CODE_REF)			\
    arg = value_at_lazy (TYPE_TARGET_TYPE (VALUE_TYPE (arg)),		\
			 unpack_long (VALUE_TYPE (arg),			\
				      VALUE_CONTENTS (arg)));}

/* If ARG is an array, convert it to a pointer.
   If ARG is an enum, convert it to an integer.
   If ARG is a function, convert it to a function pointer.

   References are dereferenced.  */

#define COERCE_ARRAY(arg)    \
{ COERCE_REF(arg);							\
  if (VALUE_REPEATED (arg)						\
      || TYPE_CODE (VALUE_TYPE (arg)) == TYPE_CODE_ARRAY)		\
    arg = value_coerce_array (arg);					\
  if (TYPE_CODE (VALUE_TYPE (arg)) == TYPE_CODE_FUNC)                   \
    arg = value_coerce_function (arg);                                  \
  if (TYPE_CODE (VALUE_TYPE (arg)) == TYPE_CODE_ENUM)			\
    arg = value_cast (builtin_type_unsigned_int, arg);			\
}

/* If ARG is an enum, convert it to an integer.  */

#define COERCE_ENUM(arg)    \
{ COERCE_REF (arg); \
  if (TYPE_CODE (VALUE_TYPE (arg)) == TYPE_CODE_ENUM)			\
    arg = value_cast (builtin_type_unsigned_int, arg);			\
}

/* Internal variables (variables for convenience of use of debugger)
   are recorded as a chain of these structures.  */

struct internalvar
{
  struct internalvar *next;
  char *name;
  value_ptr value;
};

/* Pointer to member function.  Depends on compiler implementation. */

#define METHOD_PTR_IS_VIRTUAL(ADDR)  ((ADDR) & 0x80000000)
#define METHOD_PTR_FROM_VOFFSET(OFFSET) (0x80000000 + (OFFSET))
#define METHOD_PTR_TO_VOFFSET(ADDR) (~0x80000000 & (ADDR))

\f
#include "symtab.h"
#include "gdbtypes.h"
#include "expression.h"

#ifdef __STDC__
struct frame_info;
struct fn_field;
#endif

extern void
print_address_demangle PARAMS ((CORE_ADDR, GDB_FILE *, int));

extern LONGEST value_as_long PARAMS ((value_ptr val));

extern double value_as_double PARAMS ((value_ptr val));

extern CORE_ADDR value_as_pointer PARAMS ((value_ptr val));

extern LONGEST unpack_long PARAMS ((struct type *type, char *valaddr));

extern double unpack_double PARAMS ((struct type *type, char *valaddr,
				     int *invp));

extern CORE_ADDR unpack_pointer PARAMS ((struct type *type, char *valaddr));

extern LONGEST unpack_field_as_long PARAMS ((struct type *type, char *valaddr,
					     int fieldno));

extern value_ptr value_from_longest PARAMS ((struct type *type, LONGEST num));

extern value_ptr value_from_double PARAMS ((struct type *type, double num));

extern value_ptr value_at PARAMS ((struct type *type, CORE_ADDR addr));

extern value_ptr value_at_lazy PARAMS ((struct type *type, CORE_ADDR addr));

/* FIXME:  Assumes equivalence of "struct frame_info *" and "FRAME" */
extern value_ptr value_from_register PARAMS ((struct type *type, int regnum,
					  struct frame_info * frame));

extern value_ptr value_of_variable PARAMS ((struct symbol *var,
					    struct block *b));

extern value_ptr value_of_register PARAMS ((int regnum));

extern int symbol_read_needs_frame PARAMS ((struct symbol *));

/* FIXME:  Assumes equivalence of "struct frame_info *" and "FRAME" */
extern value_ptr read_var_value PARAMS ((struct symbol *var,
					 struct frame_info *frame));

/* FIXME:  Assumes equivalence of "struct frame_info *" and "FRAME" */
extern value_ptr locate_var_value PARAMS ((struct symbol *var,
				       struct frame_info *frame));

extern value_ptr allocate_value PARAMS ((struct type *type));

extern value_ptr allocate_repeat_value PARAMS ((struct type *type, int count));

extern value_ptr value_mark PARAMS ((void));

extern void value_free_to_mark PARAMS ((value_ptr mark));

extern value_ptr value_string PARAMS ((char *ptr, int len));

extern value_ptr value_array PARAMS ((int lowbound, int highbound,
				      value_ptr *elemvec));

extern value_ptr value_concat PARAMS ((value_ptr arg1, value_ptr arg2));

extern value_ptr value_binop PARAMS ((value_ptr arg1, value_ptr arg2,
				      enum exp_opcode op));

extern value_ptr value_add PARAMS ((value_ptr arg1, value_ptr arg2));

extern value_ptr value_sub PARAMS ((value_ptr arg1, value_ptr arg2));

extern value_ptr value_coerce_array PARAMS ((value_ptr arg1));

extern value_ptr value_coerce_function PARAMS ((value_ptr arg1));

extern value_ptr value_ind PARAMS ((value_ptr arg1));

extern value_ptr value_addr PARAMS ((value_ptr arg1));

extern value_ptr value_assign PARAMS ((value_ptr toval, value_ptr fromval));

extern value_ptr value_neg PARAMS ((value_ptr arg1));

extern value_ptr value_complement PARAMS ((value_ptr arg1));

extern value_ptr value_struct_elt PARAMS ((value_ptr *argp, value_ptr *args,
					   char *name,
					   int *static_memfuncp, char *err));

extern value_ptr value_struct_elt_for_reference PARAMS ((struct type *domain,
							 int offset,
							 struct type *curtype,
							 char *name,
							 struct type *intype));

extern value_ptr value_field PARAMS ((value_ptr arg1, int fieldno));

extern value_ptr value_primitive_field PARAMS ((value_ptr arg1, int offset,
						int fieldno,
						struct type *arg_type));

extern value_ptr value_cast PARAMS ((struct type *type, value_ptr arg2));

extern value_ptr value_zero PARAMS ((struct type *type, enum lval_type lv));

extern value_ptr value_repeat PARAMS ((value_ptr arg1, int count));

extern value_ptr value_subscript PARAMS ((value_ptr array, value_ptr idx));

extern value_ptr value_from_vtable_info PARAMS ((value_ptr arg,
						 struct type *type));

extern value_ptr value_being_returned PARAMS ((struct type *valtype, 
					       char retbuf[REGISTER_BYTES],
					       int struct_return));

extern value_ptr value_in PARAMS ((value_ptr element, value_ptr set));

extern int value_bit_index PARAMS ((struct type *type, char *addr, int index));

extern int using_struct_return PARAMS ((value_ptr function, CORE_ADDR funcaddr,
					struct type *value_type, int gcc_p));

extern void set_return_value PARAMS ((value_ptr val));

extern value_ptr evaluate_expression PARAMS ((struct expression *exp));

extern value_ptr evaluate_type PARAMS ((struct expression *exp));

extern value_ptr parse_and_eval PARAMS ((char *exp));

extern value_ptr parse_to_comma_and_eval PARAMS ((char **expp));

extern struct type *parse_and_eval_type PARAMS ((char *p, int length));

extern CORE_ADDR parse_and_eval_address PARAMS ((char *exp));

extern CORE_ADDR parse_and_eval_address_1 PARAMS ((char **expptr));

extern value_ptr access_value_history PARAMS ((int num));

extern value_ptr value_of_internalvar PARAMS ((struct internalvar *var));

extern void set_internalvar PARAMS ((struct internalvar *var, value_ptr val));

extern void set_internalvar_component PARAMS ((struct internalvar *var,
					       int offset,
					       int bitpos, int bitsize,
					       value_ptr newvalue));

extern struct internalvar *lookup_internalvar PARAMS ((char *name));

extern int value_equal PARAMS ((value_ptr arg1, value_ptr arg2));

extern int value_less PARAMS ((value_ptr arg1, value_ptr arg2));

extern int value_logical_not PARAMS ((value_ptr arg1));

/* C++ */

extern value_ptr value_of_this PARAMS ((int complain));

extern value_ptr value_x_binop PARAMS ((value_ptr arg1, value_ptr arg2,
					enum exp_opcode op,
					enum exp_opcode otherop));

extern value_ptr value_x_unop PARAMS ((value_ptr arg1, enum exp_opcode op));

extern value_ptr value_fn_field PARAMS ((value_ptr *arg1p, struct fn_field *f,
					 int j,
					 struct type* type, int offset));

extern value_ptr value_virtual_fn_field PARAMS ((value_ptr *arg1p,
						 struct fn_field *f, int j,
						 struct type *type,
						 int offset));

extern int binop_user_defined_p PARAMS ((enum exp_opcode op,
					 value_ptr arg1, value_ptr arg2));

extern int unop_user_defined_p PARAMS ((enum exp_opcode op, value_ptr arg1));

extern int destructor_name_p PARAMS ((const char *name,
				      const struct type *type));

#define value_free(val) free ((PTR)val)

extern void free_all_values PARAMS ((void));

extern void release_value PARAMS ((value_ptr val));

extern int record_latest_value PARAMS ((value_ptr val));

extern void registers_changed PARAMS ((void));

extern void read_register_bytes PARAMS ((int regbyte, char *myaddr, int len));

extern void write_register_bytes PARAMS ((int regbyte, char *myaddr, int len));

extern void
read_register_gen PARAMS ((int regno, char *myaddr));

extern CORE_ADDR
read_register PARAMS ((int regno));

extern void
write_register PARAMS ((int regno, LONGEST val));

extern void
supply_register PARAMS ((int regno, char *val));

/* FIXME:  Assumes equivalence of "struct frame_info *" and "FRAME" */
extern void
get_saved_register PARAMS ((char *raw_buffer, int *optimized,
			    CORE_ADDR *addrp, struct frame_info *frame,
			    int regnum, enum lval_type *lval));

extern void
modify_field PARAMS ((char *addr, LONGEST fieldval, int bitpos, int bitsize));

extern void
type_print PARAMS ((struct type *type, char *varstring, GDB_FILE *stream,
		    int show));

extern char *baseclass_addr PARAMS ((struct type *type, int index,
				     char *valaddr,
				     value_ptr *valuep, int *errp));

extern void
print_longest PARAMS ((GDB_FILE *stream, int format, int use_local,
		       LONGEST val));

extern void
print_floating PARAMS ((char *valaddr, struct type *type, GDB_FILE *stream));

extern int value_print PARAMS ((value_ptr val, GDB_FILE *stream, int format,
				enum val_prettyprint pretty));

extern void
value_print_array_elements PARAMS ((value_ptr val, GDB_FILE* stream,
				    int format, enum val_prettyprint pretty));

extern value_ptr
value_release_to_mark PARAMS ((value_ptr mark));

extern int
val_print PARAMS ((struct type *type, char *valaddr, CORE_ADDR address,
		   GDB_FILE *stream, int format, int deref_ref,
		   int recurse, enum val_prettyprint pretty));

extern int
val_print_string PARAMS ((CORE_ADDR addr, unsigned int len, GDB_FILE *stream));

/* FIXME:  Assumes equivalence of "struct frame_info *" and "FRAME" */
extern void
print_variable_value PARAMS ((struct symbol *var, struct frame_info *frame,
			      GDB_FILE *stream));

extern value_ptr value_arg_coerce PARAMS ((value_ptr));

extern int check_field PARAMS ((value_ptr, const char *));

extern void
c_typedef_print PARAMS ((struct type *type, struct symbol *new, GDB_FILE *stream));

extern char *
internalvar_name PARAMS ((struct internalvar *var));

extern void
clear_value_history PARAMS ((void));

extern void
clear_internalvars PARAMS ((void));

/* From values.c */

extern value_ptr value_copy PARAMS ((value_ptr));

extern int baseclass_offset PARAMS ((struct type *, int, value_ptr, int));

/* From valops.c */

extern value_ptr call_function_by_hand PARAMS ((value_ptr, int, value_ptr *));

extern value_ptr f77_value_literal_complex PARAMS ((value_ptr, value_ptr, int));

extern value_ptr f77_value_literal_string PARAMS ((int, int, value_ptr *));

extern value_ptr f77_value_substring PARAMS ((value_ptr, int, int));

#endif	/* !defined (VALUE_H) */
Commit	Line	Data
bd5635a1	1	/* Definitions for values of C expressions, for GDB.
30974778	2	Copyright 1986, 1987, 1989, 1992, 1993, 1994 Free Software Foundation, Inc.
bd5635a1 RP	3
	4	This file is part of GDB.
	5
e17960fb	6	This program is free software; you can redistribute it and/or modify
bd5635a1	7	it under the terms of the GNU General Public License as published by
e17960fb JG	8	the Free Software Foundation; either version 2 of the License, or
e17960fb JG	9	(at your option) any later version.
bd5635a1	10
e17960fb	11	This program is distributed in the hope that it will be useful,
bd5635a1 RP	12	but WITHOUT ANY WARRANTY; without even the implied warranty of
	13	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	14	GNU General Public License for more details.
	15
	16	You should have received a copy of the GNU General Public License
e17960fb JG	17	along with this program; if not, write to the Free Software
e17960fb JG	18	Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
bd5635a1 RP	19
	20	#if !defined (VALUE_H)
	21	#define VALUE_H 1
01be6913	22
bd5635a1 RP	23	/*
	24	* The structure which defines the type of a value. It should never
	25	* be possible for a program lval value to survive over a call to the inferior
	26	* (ie to be put into the history list or an internal variable).
	27	*/
	28	enum lval_type {
	29	/* Not an lval. */
	30	not_lval,
	31	/* In memory. Could be a saved register. */
	32	lval_memory,
	33	/* In a register. */
	34	lval_register,
	35	/* In a gdb internal variable. */
	36	lval_internalvar,
	37	/* Part of a gdb internal variable (structure field). */
	38	lval_internalvar_component,
	39	/* In a register series in a frame not the current one, which may have been
	40	partially saved or saved in different places (otherwise would be
	41	lval_register or lval_memory). */
e17960fb	42	lval_reg_frame_relative
bd5635a1 RP	43	};
	44
	45	struct value
	46	{
	47	/* Type of value; either not an lval, or one of the various
	48	different possible kinds of lval. */
	49	enum lval_type lval;
30974778 JK	50	/* Is it modifiable? Only relevant if lval != not_lval. */
30974778 JK	51	int modifiable;
bd5635a1 RP	52	/* Location of value (if lval). */
	53	union
	54	{
	55	/* Address in inferior or byte of registers structure. */
	56	CORE_ADDR address;
35fcebce	57	/* Pointer to internal variable. */
bd5635a1 RP	58	struct internalvar *internalvar;
	59	/* Number of register. Only used with
	60	lval_reg_frame_relative. */
	61	int regnum;
	62	} location;
	63	/* Describes offset of a value within lval a structure in bytes. */
	64	int offset;
	65	/* Only used for bitfields; number of bits contained in them. */
	66	int bitsize;
35fcebce PB	67	/* Only used for bitfields; position of start of field.
	68	For BITS_BIG_ENDIAN=0 targets, it is the position of the LSB.
	69	For BITS_BIG_ENDIAN=1 targets, it is the position of the MSB. */
bd5635a1 RP	70	int bitpos;
	71	/* Frame value is relative to. In practice, this address is only
	72	used if the value is stored in several registers in other than
	73	the current frame, and these registers have not all been saved
	74	at the same place in memory. This will be described in the
	75	lval enum above as "lval_reg_frame_relative". */
	76	CORE_ADDR frame_addr;
	77	/* Type of the value. */
	78	struct type *type;
	79	/* Values are stored in a chain, so that they can be deleted
	80	easily over calls to the inferior. Values assigned to internal
	81	variables or put into the value history are taken off this
	82	list. */
	83	struct value *next;
	84	/* If an lval is forced to repeat, a new value is created with
	85	these fields set. The new value is not an lval. */
	86	short repeated;
	87	short repetitions;
	88	/* Register number if the value is from a register. Is not kept
	89	if you take a field of a structure that is stored in a
	90	register. Shouldn't it be? */
	91	short regno;
	92	/* If zero, contents of this value are in the contents field.
	93	If nonzero, contents are in inferior memory at address
	94	in the location.address field plus the offset field
	95	(and the lval field should be lval_memory). */
	96	char lazy;
	97	/* If nonzero, this is the value of a variable which does not
	98	actually exist in the program. */
	99	char optimized_out;
	100	/* Actual contents of the value. For use of this value; setting
	101	it uses the stuff above. Not valid if lazy is nonzero.
	102	Target byte-order. We force it to be aligned properly for any
	103	possible value. */
	104	union {
	105	long contents[1];
	106	double force_double_align;
30974778	107	LONGEST force_longlong_align;
bd5635a1 RP	108	} aligner;
	109
	110	};
	111
82a2edfb	112	typedef struct value *value_ptr;
bd5635a1 RP	113
	114	#define VALUE_TYPE(val) (val)->type
	115	#define VALUE_LAZY(val) (val)->lazy
	116	/* VALUE_CONTENTS and VALUE_CONTENTS_RAW both return the address of
	117	the gdb buffer used to hold a copy of the contents of the lval.
	118	VALUE_CONTENTS is used when the contents of the buffer are needed --
	119	it uses value_fetch_lazy() to load the buffer from the process being
	120	debugged if it hasn't already been loaded. VALUE_CONTENTS_RAW is
	121	used when data is being stored into the buffer, or when it is
	122	certain that the contents of the buffer are valid. */
	123	#define VALUE_CONTENTS_RAW(val) ((char *) (val)->aligner.contents)
	124	#define VALUE_CONTENTS(val) ((void)(VALUE_LAZY(val) && value_fetch_lazy(val)),\
	125	VALUE_CONTENTS_RAW(val))
82a2edfb	126	extern int value_fetch_lazy PARAMS ((value_ptr val));
01be6913	127
bd5635a1 RP	128	#define VALUE_LVAL(val) (val)->lval
	129	#define VALUE_ADDRESS(val) (val)->location.address
	130	#define VALUE_INTERNALVAR(val) (val)->location.internalvar
	131	#define VALUE_FRAME_REGNUM(val) ((val)->location.regnum)
	132	#define VALUE_FRAME(val) ((val)->frame_addr)
	133	#define VALUE_OFFSET(val) (val)->offset
	134	#define VALUE_BITSIZE(val) (val)->bitsize
	135	#define VALUE_BITPOS(val) (val)->bitpos
	136	#define VALUE_NEXT(val) (val)->next
	137	#define VALUE_REPEATED(val) (val)->repeated
	138	#define VALUE_REPETITIONS(val) (val)->repetitions
	139	#define VALUE_REGNO(val) (val)->regno
	140	#define VALUE_OPTIMIZED_OUT(val) ((val)->optimized_out)
	141
a91a6192 SS	142	/* This is probably not the right thing to do for in-gdb arrays. FIXME */
	143	/* Overload the contents field to store literal data for
	144	arrays. */
	145
	146	#define VALUE_LITERAL_DATA(val) ((val)->aligner.contents[0])
	147
	148	/* Overload the frame address field to contain a pointer to
	149	the base substring, for F77 string substring operators.
	150	We use this ONLY when doing operations of the form
	151
	152	FOO= 'hello'
	153	FOO(2:4) = 'foo'
	154
	155	In the above case VALUE_SUBSTRING_START would point to
	156	FOO(2) in the original FOO string.
	157
	158	Depending on whether the base object is allocated in the
	159	inferior or the superior process, VALUE_SUBSTRING_START
	160	contains a ptr. to memory in the relevant area. */
	161
	162	#define VALUE_SUBSTRING_START(val) VALUE_FRAME(val)
	163
bd5635a1 RP	164	/* Convert a REF to the object referenced. */
	165
	166	#define COERCE_REF(arg) \
e17960fb	167	{ if (TYPE_CODE (VALUE_TYPE (arg)) == TYPE_CODE_REF) \
bd5635a1 RP	168	arg = value_at_lazy (TYPE_TARGET_TYPE (VALUE_TYPE (arg)), \
	169	unpack_long (VALUE_TYPE (arg), \
	170	VALUE_CONTENTS (arg)));}
	171
	172	/* If ARG is an array, convert it to a pointer.
	173	If ARG is an enum, convert it to an integer.
	174	If ARG is a function, convert it to a function pointer.
	175
	176	References are dereferenced. */
	177
	178	#define COERCE_ARRAY(arg) \
	179	{ COERCE_REF(arg); \
	180	if (VALUE_REPEATED (arg) \
	181	\|\| TYPE_CODE (VALUE_TYPE (arg)) == TYPE_CODE_ARRAY) \
	182	arg = value_coerce_array (arg); \
	183	if (TYPE_CODE (VALUE_TYPE (arg)) == TYPE_CODE_FUNC) \
	184	arg = value_coerce_function (arg); \
	185	if (TYPE_CODE (VALUE_TYPE (arg)) == TYPE_CODE_ENUM) \
	186	arg = value_cast (builtin_type_unsigned_int, arg); \
	187	}
	188
	189	/* If ARG is an enum, convert it to an integer. */
	190
	191	#define COERCE_ENUM(arg) \
5573d7d4	192	{ COERCE_REF (arg); \
bd5635a1 RP	193	if (TYPE_CODE (VALUE_TYPE (arg)) == TYPE_CODE_ENUM) \
	194	arg = value_cast (builtin_type_unsigned_int, arg); \
	195	}
	196
	197	/* Internal variables (variables for convenience of use of debugger)
	198	are recorded as a chain of these structures. */
	199
	200	struct internalvar
	201	{
	202	struct internalvar *next;
	203	char *name;
82a2edfb	204	value_ptr value;
bd5635a1	205	};
01be6913	206
35fcebce PB	207	/* Pointer to member function. Depends on compiler implementation. */
	208
	209	#define METHOD_PTR_IS_VIRTUAL(ADDR) ((ADDR) & 0x80000000)
	210	#define METHOD_PTR_FROM_VOFFSET(OFFSET) (0x80000000 + (OFFSET))
	211	#define METHOD_PTR_TO_VOFFSET(ADDR) (~0x80000000 & (ADDR))
	212
bd5635a1 RP	213	\f
bd5635a1 RP	214	#include "symtab.h"
01be6913 PB	215	#include "gdbtypes.h"
	216	#include "expression.h"
	217
e17960fb	218	#ifdef __STDC__
01be6913	219	struct frame_info;
c7da3ed3	220	struct fn_field;
e17960fb	221	#endif
01be6913 PB	222
01be6913 PB	223	extern void
30974778	224	print_address_demangle PARAMS ((CORE_ADDR, GDB_FILE *, int));
01be6913	225
82a2edfb	226	extern LONGEST value_as_long PARAMS ((value_ptr val));
01be6913	227
82a2edfb	228	extern double value_as_double PARAMS ((value_ptr val));
01be6913	229
82a2edfb	230	extern CORE_ADDR value_as_pointer PARAMS ((value_ptr val));
01be6913	231
82a2edfb	232	extern LONGEST unpack_long PARAMS ((struct type type, char valaddr));
01be6913	233
82a2edfb JK	234	extern double unpack_double PARAMS ((struct type type, char valaddr,
82a2edfb JK	235	int *invp));
01be6913	236
5573d7d4	237	extern CORE_ADDR unpack_pointer PARAMS ((struct type type, char valaddr));
01be6913	238
5573d7d4 JK	239	extern LONGEST unpack_field_as_long PARAMS ((struct type type, char valaddr,
5573d7d4 JK	240	int fieldno));
01be6913	241
82a2edfb	242	extern value_ptr value_from_longest PARAMS ((struct type *type, LONGEST num));
01be6913	243
82a2edfb	244	extern value_ptr value_from_double PARAMS ((struct type *type, double num));
01be6913	245
82a2edfb	246	extern value_ptr value_at PARAMS ((struct type *type, CORE_ADDR addr));
01be6913	247
82a2edfb	248	extern value_ptr value_at_lazy PARAMS ((struct type *type, CORE_ADDR addr));
01be6913 PB	249
01be6913 PB	250	/* FIXME: Assumes equivalence of "struct frame_info " and "FRAME" /
82a2edfb	251	extern value_ptr value_from_register PARAMS ((struct type *type, int regnum,
5573d7d4	252	struct frame_info * frame));
01be6913	253
82a2edfb JK	254	extern value_ptr value_of_variable PARAMS ((struct symbol *var,
82a2edfb JK	255	struct block *b));
01be6913	256
82a2edfb	257	extern value_ptr value_of_register PARAMS ((int regnum));
01be6913	258
30974778 JK	259	extern int symbol_read_needs_frame PARAMS ((struct symbol *));
30974778 JK	260
01be6913	261	/* FIXME: Assumes equivalence of "struct frame_info " and "FRAME" /
82a2edfb JK	262	extern value_ptr read_var_value PARAMS ((struct symbol *var,
82a2edfb JK	263	struct frame_info *frame));
01be6913 PB	264
01be6913 PB	265	/* FIXME: Assumes equivalence of "struct frame_info " and "FRAME" /
82a2edfb	266	extern value_ptr locate_var_value PARAMS ((struct symbol *var,
5573d7d4	267	struct frame_info *frame));
01be6913	268
82a2edfb	269	extern value_ptr allocate_value PARAMS ((struct type *type));
01be6913	270
82a2edfb	271	extern value_ptr allocate_repeat_value PARAMS ((struct type *type, int count));
01be6913	272
82a2edfb	273	extern value_ptr value_mark PARAMS ((void));
01be6913	274
82a2edfb	275	extern void value_free_to_mark PARAMS ((value_ptr mark));
01be6913	276
82a2edfb	277	extern value_ptr value_string PARAMS ((char *ptr, int len));
01be6913	278
82a2edfb JK	279	extern value_ptr value_array PARAMS ((int lowbound, int highbound,
82a2edfb JK	280	value_ptr *elemvec));
7efb57c3	281
82a2edfb	282	extern value_ptr value_concat PARAMS ((value_ptr arg1, value_ptr arg2));
7efb57c3	283
82a2edfb JK	284	extern value_ptr value_binop PARAMS ((value_ptr arg1, value_ptr arg2,
82a2edfb JK	285	enum exp_opcode op));
01be6913	286
82a2edfb	287	extern value_ptr value_add PARAMS ((value_ptr arg1, value_ptr arg2));
01be6913	288
82a2edfb	289	extern value_ptr value_sub PARAMS ((value_ptr arg1, value_ptr arg2));
01be6913	290
82a2edfb	291	extern value_ptr value_coerce_array PARAMS ((value_ptr arg1));
01be6913	292
82a2edfb	293	extern value_ptr value_coerce_function PARAMS ((value_ptr arg1));
01be6913	294
82a2edfb	295	extern value_ptr value_ind PARAMS ((value_ptr arg1));
01be6913	296
82a2edfb	297	extern value_ptr value_addr PARAMS ((value_ptr arg1));
01be6913	298
82a2edfb	299	extern value_ptr value_assign PARAMS ((value_ptr toval, value_ptr fromval));
01be6913	300
82a2edfb	301	extern value_ptr value_neg PARAMS ((value_ptr arg1));
01be6913	302
82a2edfb	303	extern value_ptr value_complement PARAMS ((value_ptr arg1));
01be6913	304
999dd04b	305	extern value_ptr value_struct_elt PARAMS ((value_ptr argp, value_ptr args,
82a2edfb JK	306	char *name,
82a2edfb JK	307	int static_memfuncp, char err));
01be6913	308
82a2edfb JK	309	extern value_ptr value_struct_elt_for_reference PARAMS ((struct type *domain,
	310	int offset,
	311	struct type *curtype,
	312	char *name,
	313	struct type *intype));
01be6913	314
82a2edfb	315	extern value_ptr value_field PARAMS ((value_ptr arg1, int fieldno));
01be6913	316
82a2edfb JK	317	extern value_ptr value_primitive_field PARAMS ((value_ptr arg1, int offset,
	318	int fieldno,
	319	struct type *arg_type));
01be6913	320
82a2edfb	321	extern value_ptr value_cast PARAMS ((struct type *type, value_ptr arg2));
01be6913	322
82a2edfb	323	extern value_ptr value_zero PARAMS ((struct type *type, enum lval_type lv));
01be6913	324
82a2edfb	325	extern value_ptr value_repeat PARAMS ((value_ptr arg1, int count));
01be6913	326
82a2edfb	327	extern value_ptr value_subscript PARAMS ((value_ptr array, value_ptr idx));
01be6913	328
82a2edfb JK	329	extern value_ptr value_from_vtable_info PARAMS ((value_ptr arg,
82a2edfb JK	330	struct type *type));
01be6913	331
82a2edfb JK	332	extern value_ptr value_being_returned PARAMS ((struct type *valtype,
	333	char retbuf[REGISTER_BYTES],
	334	int struct_return));
01be6913	335
82a2edfb	336	extern value_ptr value_in PARAMS ((value_ptr element, value_ptr set));
30974778 JK	337
	338	extern int value_bit_index PARAMS ((struct type type, char addr, int index));
	339
82a2edfb JK	340	extern int using_struct_return PARAMS ((value_ptr function, CORE_ADDR funcaddr,
82a2edfb JK	341	struct type *value_type, int gcc_p));
01be6913	342
82a2edfb	343	extern void set_return_value PARAMS ((value_ptr val));
01be6913	344
82a2edfb	345	extern value_ptr evaluate_expression PARAMS ((struct expression *exp));
01be6913	346
82a2edfb	347	extern value_ptr evaluate_type PARAMS ((struct expression *exp));
01be6913	348
82a2edfb	349	extern value_ptr parse_and_eval PARAMS ((char *exp));
01be6913	350
82a2edfb	351	extern value_ptr parse_to_comma_and_eval PARAMS ((char **expp));
01be6913	352
82a2edfb	353	extern struct type parse_and_eval_type PARAMS ((char p, int length));
01be6913	354
82a2edfb	355	extern CORE_ADDR parse_and_eval_address PARAMS ((char *exp));
01be6913	356
82a2edfb	357	extern CORE_ADDR parse_and_eval_address_1 PARAMS ((char **expptr));
01be6913	358
82a2edfb	359	extern value_ptr access_value_history PARAMS ((int num));
01be6913	360
82a2edfb	361	extern value_ptr value_of_internalvar PARAMS ((struct internalvar *var));
01be6913	362
82a2edfb	363	extern void set_internalvar PARAMS ((struct internalvar *var, value_ptr val));
01be6913	364
82a2edfb JK	365	extern void set_internalvar_component PARAMS ((struct internalvar *var,
	366	int offset,
	367	int bitpos, int bitsize,
	368	value_ptr newvalue));
01be6913	369
82a2edfb	370	extern struct internalvar lookup_internalvar PARAMS ((char name));
01be6913	371
82a2edfb	372	extern int value_equal PARAMS ((value_ptr arg1, value_ptr arg2));
01be6913	373
82a2edfb	374	extern int value_less PARAMS ((value_ptr arg1, value_ptr arg2));
01be6913	375
82a2edfb	376	extern int value_logical_not PARAMS ((value_ptr arg1));
bd5635a1 RP	377
bd5635a1 RP	378	/* C++ */
01be6913	379
82a2edfb	380	extern value_ptr value_of_this PARAMS ((int complain));
01be6913	381
82a2edfb JK	382	extern value_ptr value_x_binop PARAMS ((value_ptr arg1, value_ptr arg2,
	383	enum exp_opcode op,
	384	enum exp_opcode otherop));
01be6913	385
82a2edfb	386	extern value_ptr value_x_unop PARAMS ((value_ptr arg1, enum exp_opcode op));
01be6913	387
82a2edfb JK	388	extern value_ptr value_fn_field PARAMS ((value_ptr arg1p, struct fn_field f,
	389	int j,
	390	struct type* type, int offset));
01be6913	391
82a2edfb JK	392	extern value_ptr value_virtual_fn_field PARAMS ((value_ptr *arg1p,
	393	struct fn_field *f, int j,
	394	struct type *type,
	395	int offset));
01be6913	396
82a2edfb JK	397	extern int binop_user_defined_p PARAMS ((enum exp_opcode op,
82a2edfb JK	398	value_ptr arg1, value_ptr arg2));
01be6913	399
82a2edfb	400	extern int unop_user_defined_p PARAMS ((enum exp_opcode op, value_ptr arg1));
01be6913	401
82a2edfb JK	402	extern int destructor_name_p PARAMS ((const char *name,
82a2edfb JK	403	const struct type *type));
bd5635a1	404
35fcebce	405	#define value_free(val) free ((PTR)val)
01be6913	406
82a2edfb	407	extern void free_all_values PARAMS ((void));
01be6913	408
82a2edfb	409	extern void release_value PARAMS ((value_ptr val));
01be6913	410
82a2edfb	411	extern int record_latest_value PARAMS ((value_ptr val));
01be6913	412
82a2edfb	413	extern void registers_changed PARAMS ((void));
01be6913	414
82a2edfb	415	extern void read_register_bytes PARAMS ((int regbyte, char *myaddr, int len));
01be6913	416
82a2edfb	417	extern void write_register_bytes PARAMS ((int regbyte, char *myaddr, int len));
01be6913 PB	418
	419	extern void
	420	read_register_gen PARAMS ((int regno, char *myaddr));
	421
	422	extern CORE_ADDR
	423	read_register PARAMS ((int regno));
	424
	425	extern void
30974778	426	write_register PARAMS ((int regno, LONGEST val));
01be6913 PB	427
	428	extern void
	429	supply_register PARAMS ((int regno, char *val));
	430
	431	/* FIXME: Assumes equivalence of "struct frame_info " and "FRAME" /
	432	extern void
	433	get_saved_register PARAMS ((char raw_buffer, int optimized,
	434	CORE_ADDR addrp, struct frame_info frame,
	435	int regnum, enum lval_type *lval));
	436
	437	extern void
5573d7d4	438	modify_field PARAMS ((char *addr, LONGEST fieldval, int bitpos, int bitsize));
01be6913 PB	439
01be6913 PB	440	extern void
30974778	441	type_print PARAMS ((struct type type, char varstring, GDB_FILE *stream,
01be6913 PB	442	int show));
01be6913 PB	443
82a2edfb JK	444	extern char baseclass_addr PARAMS ((struct type type, int index,
	445	char *valaddr,
	446	value_ptr valuep, int errp));
01be6913	447
7efb57c3	448	extern void
30974778 JK	449	print_longest PARAMS ((GDB_FILE *stream, int format, int use_local,
30974778 JK	450	LONGEST val));
7efb57c3	451
01be6913	452	extern void
30974778	453	print_floating PARAMS ((char valaddr, struct type type, GDB_FILE *stream));
01be6913	454
82a2edfb JK	455	extern int value_print PARAMS ((value_ptr val, GDB_FILE *stream, int format,
82a2edfb JK	456	enum val_prettyprint pretty));
01be6913	457
a91a6192 SS	458	extern void
	459	value_print_array_elements PARAMS ((value_ptr val, GDB_FILE* stream,
	460	int format, enum val_prettyprint pretty));
	461
999dd04b JL	462	extern value_ptr
	463	value_release_to_mark PARAMS ((value_ptr mark));
	464
01be6913 PB	465	extern int
01be6913 PB	466	val_print PARAMS ((struct type type, char valaddr, CORE_ADDR address,
30974778	467	GDB_FILE *stream, int format, int deref_ref,
01be6913 PB	468	int recurse, enum val_prettyprint pretty));
01be6913 PB	469
c7da3ed3	470	extern int
30974778	471	val_print_string PARAMS ((CORE_ADDR addr, unsigned int len, GDB_FILE *stream));
c7da3ed3	472
01be6913 PB	473	/* FIXME: Assumes equivalence of "struct frame_info " and "FRAME" /
	474	extern void
	475	print_variable_value PARAMS ((struct symbol var, struct frame_info frame,
30974778	476	GDB_FILE *stream));
01be6913	477
82a2edfb	478	extern value_ptr value_arg_coerce PARAMS ((value_ptr));
01be6913	479
82a2edfb	480	extern int check_field PARAMS ((value_ptr, const char *));
01be6913 PB	481
01be6913 PB	482	extern void
30974778	483	c_typedef_print PARAMS ((struct type type, struct symbol new, GDB_FILE *stream));
01be6913 PB	484
	485	extern char *
	486	internalvar_name PARAMS ((struct internalvar *var));
	487
	488	extern void
	489	clear_value_history PARAMS ((void));
	490
	491	extern void
	492	clear_internalvars PARAMS ((void));
	493
	494	/* From values.c */
	495
82a2edfb	496	extern value_ptr value_copy PARAMS ((value_ptr));
01be6913	497
82a2edfb	498	extern int baseclass_offset PARAMS ((struct type *, int, value_ptr, int));
c7da3ed3	499
01be6913	500	/* From valops.c */
bd5635a1	501
82a2edfb	502	extern value_ptr call_function_by_hand PARAMS ((value_ptr, int, value_ptr *));
e17960fb	503
a91a6192 SS	504	extern value_ptr f77_value_literal_complex PARAMS ((value_ptr, value_ptr, int));
	505
	506	extern value_ptr f77_value_literal_string PARAMS ((int, int, value_ptr *));
	507
	508	extern value_ptr f77_value_substring PARAMS ((value_ptr, int, int));
	509
01be6913	510	#endif /* !defined (VALUE_H) */