[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;

    /* ??? When is this used?  */
    union {
      CORE_ADDR memaddr;
      char *myaddr;
    } substring_addr;

    /* 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;
      char *literal_data;
    } 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.literal_data)

/* 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_* 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, use VALUE_SUBSTRING_MYADDR or
   VALUE_SUBSTRING_MEMADDR.  */

#define VALUE_SUBSTRING_MEMADDR(val) (val)->substring_addr.memaddr
#define VALUE_SUBSTRING_MYADDR(val) (val)->substring_addr.myaddr

/* 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));

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 *));

extern value_ptr read_var_value PARAMS ((struct symbol *var,
					 struct frame_info *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));

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));

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;
ff87df19 JK	84
	85	/* ??? When is this used? */
	86	union {
	87	CORE_ADDR memaddr;
	88	char *myaddr;
	89	} substring_addr;
	90
bd5635a1 RP	91	/* If an lval is forced to repeat, a new value is created with
	92	these fields set. The new value is not an lval. */
	93	short repeated;
	94	short repetitions;
	95	/* Register number if the value is from a register. Is not kept
	96	if you take a field of a structure that is stored in a
	97	register. Shouldn't it be? */
	98	short regno;
	99	/* If zero, contents of this value are in the contents field.
	100	If nonzero, contents are in inferior memory at address
	101	in the location.address field plus the offset field
	102	(and the lval field should be lval_memory). */
	103	char lazy;
	104	/* If nonzero, this is the value of a variable which does not
	105	actually exist in the program. */
	106	char optimized_out;
	107	/* Actual contents of the value. For use of this value; setting
	108	it uses the stuff above. Not valid if lazy is nonzero.
	109	Target byte-order. We force it to be aligned properly for any
	110	possible value. */
	111	union {
	112	long contents[1];
	113	double force_double_align;
30974778	114	LONGEST force_longlong_align;
ff87df19	115	char *literal_data;
bd5635a1 RP	116	} aligner;
	117
	118	};
	119
82a2edfb	120	typedef struct value *value_ptr;
bd5635a1 RP	121
	122	#define VALUE_TYPE(val) (val)->type
	123	#define VALUE_LAZY(val) (val)->lazy
	124	/* VALUE_CONTENTS and VALUE_CONTENTS_RAW both return the address of
	125	the gdb buffer used to hold a copy of the contents of the lval.
	126	VALUE_CONTENTS is used when the contents of the buffer are needed --
	127	it uses value_fetch_lazy() to load the buffer from the process being
	128	debugged if it hasn't already been loaded. VALUE_CONTENTS_RAW is
	129	used when data is being stored into the buffer, or when it is
	130	certain that the contents of the buffer are valid. */
	131	#define VALUE_CONTENTS_RAW(val) ((char *) (val)->aligner.contents)
	132	#define VALUE_CONTENTS(val) ((void)(VALUE_LAZY(val) && value_fetch_lazy(val)),\
	133	VALUE_CONTENTS_RAW(val))
82a2edfb	134	extern int value_fetch_lazy PARAMS ((value_ptr val));
01be6913	135
bd5635a1 RP	136	#define VALUE_LVAL(val) (val)->lval
	137	#define VALUE_ADDRESS(val) (val)->location.address
	138	#define VALUE_INTERNALVAR(val) (val)->location.internalvar
	139	#define VALUE_FRAME_REGNUM(val) ((val)->location.regnum)
	140	#define VALUE_FRAME(val) ((val)->frame_addr)
	141	#define VALUE_OFFSET(val) (val)->offset
	142	#define VALUE_BITSIZE(val) (val)->bitsize
	143	#define VALUE_BITPOS(val) (val)->bitpos
	144	#define VALUE_NEXT(val) (val)->next
	145	#define VALUE_REPEATED(val) (val)->repeated
	146	#define VALUE_REPETITIONS(val) (val)->repetitions
	147	#define VALUE_REGNO(val) (val)->regno
	148	#define VALUE_OPTIMIZED_OUT(val) ((val)->optimized_out)
	149
a91a6192 SS	150	/* This is probably not the right thing to do for in-gdb arrays. FIXME */
	151	/* Overload the contents field to store literal data for
	152	arrays. */
	153
ff87df19	154	#define VALUE_LITERAL_DATA(val) ((val)->aligner.literal_data)
a91a6192	155
ff87df19	156	/* Pointer to
a91a6192 SS	157	the base substring, for F77 string substring operators.
	158	We use this ONLY when doing operations of the form
	159
	160	FOO= 'hello'
	161	FOO(2:4) = 'foo'
	162
ff87df19	163	In the above case VALUE_SUBSTRING_* would point to
a91a6192 SS	164	FOO(2) in the original FOO string.
	165
	166	Depending on whether the base object is allocated in the
ff87df19 JK	167	inferior or the superior process, use VALUE_SUBSTRING_MYADDR or
ff87df19 JK	168	VALUE_SUBSTRING_MEMADDR. */
a91a6192	169
ff87df19 JK	170	#define VALUE_SUBSTRING_MEMADDR(val) (val)->substring_addr.memaddr
ff87df19 JK	171	#define VALUE_SUBSTRING_MYADDR(val) (val)->substring_addr.myaddr
a91a6192	172
bd5635a1 RP	173	/* Convert a REF to the object referenced. */
	174
	175	#define COERCE_REF(arg) \
e17960fb	176	{ if (TYPE_CODE (VALUE_TYPE (arg)) == TYPE_CODE_REF) \
bd5635a1 RP	177	arg = value_at_lazy (TYPE_TARGET_TYPE (VALUE_TYPE (arg)), \
	178	unpack_long (VALUE_TYPE (arg), \
	179	VALUE_CONTENTS (arg)));}
	180
	181	/* If ARG is an array, convert it to a pointer.
	182	If ARG is an enum, convert it to an integer.
	183	If ARG is a function, convert it to a function pointer.
	184
	185	References are dereferenced. */
	186
	187	#define COERCE_ARRAY(arg) \
	188	{ COERCE_REF(arg); \
	189	if (VALUE_REPEATED (arg) \
	190	\|\| TYPE_CODE (VALUE_TYPE (arg)) == TYPE_CODE_ARRAY) \
	191	arg = value_coerce_array (arg); \
	192	if (TYPE_CODE (VALUE_TYPE (arg)) == TYPE_CODE_FUNC) \
	193	arg = value_coerce_function (arg); \
	194	if (TYPE_CODE (VALUE_TYPE (arg)) == TYPE_CODE_ENUM) \
	195	arg = value_cast (builtin_type_unsigned_int, arg); \
	196	}
	197
	198	/* If ARG is an enum, convert it to an integer. */
	199
	200	#define COERCE_ENUM(arg) \
5573d7d4	201	{ COERCE_REF (arg); \
bd5635a1 RP	202	if (TYPE_CODE (VALUE_TYPE (arg)) == TYPE_CODE_ENUM) \
	203	arg = value_cast (builtin_type_unsigned_int, arg); \
	204	}
	205
	206	/* Internal variables (variables for convenience of use of debugger)
	207	are recorded as a chain of these structures. */
	208
	209	struct internalvar
	210	{
	211	struct internalvar *next;
	212	char *name;
82a2edfb	213	value_ptr value;
bd5635a1	214	};
01be6913	215
35fcebce PB	216	/* Pointer to member function. Depends on compiler implementation. */
	217
	218	#define METHOD_PTR_IS_VIRTUAL(ADDR) ((ADDR) & 0x80000000)
	219	#define METHOD_PTR_FROM_VOFFSET(OFFSET) (0x80000000 + (OFFSET))
	220	#define METHOD_PTR_TO_VOFFSET(ADDR) (~0x80000000 & (ADDR))
	221
bd5635a1 RP	222	\f
bd5635a1 RP	223	#include "symtab.h"
01be6913 PB	224	#include "gdbtypes.h"
	225	#include "expression.h"
	226
e17960fb	227	#ifdef __STDC__
01be6913	228	struct frame_info;
c7da3ed3	229	struct fn_field;
e17960fb	230	#endif
01be6913 PB	231
01be6913 PB	232	extern void
30974778	233	print_address_demangle PARAMS ((CORE_ADDR, GDB_FILE *, int));
01be6913	234
82a2edfb	235	extern LONGEST value_as_long PARAMS ((value_ptr val));
01be6913	236
82a2edfb	237	extern double value_as_double PARAMS ((value_ptr val));
01be6913	238
82a2edfb	239	extern CORE_ADDR value_as_pointer PARAMS ((value_ptr val));
01be6913	240
82a2edfb	241	extern LONGEST unpack_long PARAMS ((struct type type, char valaddr));
01be6913	242
82a2edfb JK	243	extern double unpack_double PARAMS ((struct type type, char valaddr,
82a2edfb JK	244	int *invp));
01be6913	245
5573d7d4	246	extern CORE_ADDR unpack_pointer PARAMS ((struct type type, char valaddr));
01be6913	247
5573d7d4 JK	248	extern LONGEST unpack_field_as_long PARAMS ((struct type type, char valaddr,
5573d7d4 JK	249	int fieldno));
01be6913	250
82a2edfb	251	extern value_ptr value_from_longest PARAMS ((struct type *type, LONGEST num));
01be6913	252
82a2edfb	253	extern value_ptr value_from_double PARAMS ((struct type *type, double num));
01be6913	254
82a2edfb	255	extern value_ptr value_at PARAMS ((struct type *type, CORE_ADDR addr));
01be6913	256
82a2edfb	257	extern value_ptr value_at_lazy PARAMS ((struct type *type, CORE_ADDR addr));
01be6913	258
82a2edfb	259	extern value_ptr value_from_register PARAMS ((struct type *type, int regnum,
5573d7d4	260	struct frame_info * frame));
01be6913	261
82a2edfb JK	262	extern value_ptr value_of_variable PARAMS ((struct symbol *var,
82a2edfb JK	263	struct block *b));
01be6913	264
82a2edfb	265	extern value_ptr value_of_register PARAMS ((int regnum));
01be6913	266
30974778 JK	267	extern int symbol_read_needs_frame PARAMS ((struct symbol *));
30974778 JK	268
82a2edfb JK	269	extern value_ptr read_var_value PARAMS ((struct symbol *var,
82a2edfb JK	270	struct frame_info *frame));
01be6913	271
82a2edfb	272	extern value_ptr locate_var_value PARAMS ((struct symbol *var,
5573d7d4	273	struct frame_info *frame));
01be6913	274
82a2edfb	275	extern value_ptr allocate_value PARAMS ((struct type *type));
01be6913	276
82a2edfb	277	extern value_ptr allocate_repeat_value PARAMS ((struct type *type, int count));
01be6913	278
82a2edfb	279	extern value_ptr value_mark PARAMS ((void));
01be6913	280
82a2edfb	281	extern void value_free_to_mark PARAMS ((value_ptr mark));
01be6913	282
82a2edfb	283	extern value_ptr value_string PARAMS ((char *ptr, int len));
01be6913	284
82a2edfb JK	285	extern value_ptr value_array PARAMS ((int lowbound, int highbound,
82a2edfb JK	286	value_ptr *elemvec));
7efb57c3	287
82a2edfb	288	extern value_ptr value_concat PARAMS ((value_ptr arg1, value_ptr arg2));
7efb57c3	289
82a2edfb JK	290	extern value_ptr value_binop PARAMS ((value_ptr arg1, value_ptr arg2,
82a2edfb JK	291	enum exp_opcode op));
01be6913	292
82a2edfb	293	extern value_ptr value_add PARAMS ((value_ptr arg1, value_ptr arg2));
01be6913	294
82a2edfb	295	extern value_ptr value_sub PARAMS ((value_ptr arg1, value_ptr arg2));
01be6913	296
82a2edfb	297	extern value_ptr value_coerce_array PARAMS ((value_ptr arg1));
01be6913	298
82a2edfb	299	extern value_ptr value_coerce_function PARAMS ((value_ptr arg1));
01be6913	300
82a2edfb	301	extern value_ptr value_ind PARAMS ((value_ptr arg1));
01be6913	302
82a2edfb	303	extern value_ptr value_addr PARAMS ((value_ptr arg1));
01be6913	304
82a2edfb	305	extern value_ptr value_assign PARAMS ((value_ptr toval, value_ptr fromval));
01be6913	306
82a2edfb	307	extern value_ptr value_neg PARAMS ((value_ptr arg1));
01be6913	308
82a2edfb	309	extern value_ptr value_complement PARAMS ((value_ptr arg1));
01be6913	310
999dd04b	311	extern value_ptr value_struct_elt PARAMS ((value_ptr argp, value_ptr args,
82a2edfb JK	312	char *name,
82a2edfb JK	313	int static_memfuncp, char err));
01be6913	314
82a2edfb JK	315	extern value_ptr value_struct_elt_for_reference PARAMS ((struct type *domain,
	316	int offset,
	317	struct type *curtype,
	318	char *name,
	319	struct type *intype));
01be6913	320
82a2edfb	321	extern value_ptr value_field PARAMS ((value_ptr arg1, int fieldno));
01be6913	322
82a2edfb JK	323	extern value_ptr value_primitive_field PARAMS ((value_ptr arg1, int offset,
	324	int fieldno,
	325	struct type *arg_type));
01be6913	326
82a2edfb	327	extern value_ptr value_cast PARAMS ((struct type *type, value_ptr arg2));
01be6913	328
82a2edfb	329	extern value_ptr value_zero PARAMS ((struct type *type, enum lval_type lv));
01be6913	330
82a2edfb	331	extern value_ptr value_repeat PARAMS ((value_ptr arg1, int count));
01be6913	332
82a2edfb	333	extern value_ptr value_subscript PARAMS ((value_ptr array, value_ptr idx));
01be6913	334
82a2edfb JK	335	extern value_ptr value_from_vtable_info PARAMS ((value_ptr arg,
82a2edfb JK	336	struct type *type));
01be6913	337
82a2edfb JK	338	extern value_ptr value_being_returned PARAMS ((struct type *valtype,
	339	char retbuf[REGISTER_BYTES],
	340	int struct_return));
01be6913	341
82a2edfb	342	extern value_ptr value_in PARAMS ((value_ptr element, value_ptr set));
30974778 JK	343
	344	extern int value_bit_index PARAMS ((struct type type, char addr, int index));
	345
82a2edfb JK	346	extern int using_struct_return PARAMS ((value_ptr function, CORE_ADDR funcaddr,
82a2edfb JK	347	struct type *value_type, int gcc_p));
01be6913	348
82a2edfb	349	extern void set_return_value PARAMS ((value_ptr val));
01be6913	350
82a2edfb	351	extern value_ptr evaluate_expression PARAMS ((struct expression *exp));
01be6913	352
82a2edfb	353	extern value_ptr evaluate_type PARAMS ((struct expression *exp));
01be6913	354
82a2edfb	355	extern value_ptr parse_and_eval PARAMS ((char *exp));
01be6913	356
82a2edfb	357	extern value_ptr parse_to_comma_and_eval PARAMS ((char **expp));
01be6913	358
82a2edfb	359	extern struct type parse_and_eval_type PARAMS ((char p, int length));
01be6913	360
82a2edfb	361	extern CORE_ADDR parse_and_eval_address PARAMS ((char *exp));
01be6913	362
82a2edfb	363	extern CORE_ADDR parse_and_eval_address_1 PARAMS ((char **expptr));
01be6913	364
82a2edfb	365	extern value_ptr access_value_history PARAMS ((int num));
01be6913	366
82a2edfb	367	extern value_ptr value_of_internalvar PARAMS ((struct internalvar *var));
01be6913	368
82a2edfb	369	extern void set_internalvar PARAMS ((struct internalvar *var, value_ptr val));
01be6913	370
82a2edfb JK	371	extern void set_internalvar_component PARAMS ((struct internalvar *var,
	372	int offset,
	373	int bitpos, int bitsize,
	374	value_ptr newvalue));
01be6913	375
82a2edfb	376	extern struct internalvar lookup_internalvar PARAMS ((char name));
01be6913	377
82a2edfb	378	extern int value_equal PARAMS ((value_ptr arg1, value_ptr arg2));
01be6913	379
82a2edfb	380	extern int value_less PARAMS ((value_ptr arg1, value_ptr arg2));
01be6913	381
82a2edfb	382	extern int value_logical_not PARAMS ((value_ptr arg1));
bd5635a1 RP	383
bd5635a1 RP	384	/* C++ */
01be6913	385
82a2edfb	386	extern value_ptr value_of_this PARAMS ((int complain));
01be6913	387
82a2edfb JK	388	extern value_ptr value_x_binop PARAMS ((value_ptr arg1, value_ptr arg2,
	389	enum exp_opcode op,
	390	enum exp_opcode otherop));
01be6913	391
82a2edfb	392	extern value_ptr value_x_unop PARAMS ((value_ptr arg1, enum exp_opcode op));
01be6913	393
82a2edfb JK	394	extern value_ptr value_fn_field PARAMS ((value_ptr arg1p, struct fn_field f,
	395	int j,
	396	struct type* type, int offset));
01be6913	397
82a2edfb JK	398	extern value_ptr value_virtual_fn_field PARAMS ((value_ptr *arg1p,
	399	struct fn_field *f, int j,
	400	struct type *type,
	401	int offset));
01be6913	402
82a2edfb JK	403	extern int binop_user_defined_p PARAMS ((enum exp_opcode op,
82a2edfb JK	404	value_ptr arg1, value_ptr arg2));
01be6913	405
82a2edfb	406	extern int unop_user_defined_p PARAMS ((enum exp_opcode op, value_ptr arg1));
01be6913	407
82a2edfb JK	408	extern int destructor_name_p PARAMS ((const char *name,
82a2edfb JK	409	const struct type *type));
bd5635a1	410
35fcebce	411	#define value_free(val) free ((PTR)val)
01be6913	412
82a2edfb	413	extern void free_all_values PARAMS ((void));
01be6913	414
82a2edfb	415	extern void release_value PARAMS ((value_ptr val));
01be6913	416
82a2edfb	417	extern int record_latest_value PARAMS ((value_ptr val));
01be6913	418
82a2edfb	419	extern void registers_changed PARAMS ((void));
01be6913	420
82a2edfb	421	extern void read_register_bytes PARAMS ((int regbyte, char *myaddr, int len));
01be6913	422
82a2edfb	423	extern void write_register_bytes PARAMS ((int regbyte, char *myaddr, int len));
01be6913 PB	424
	425	extern void
	426	read_register_gen PARAMS ((int regno, char *myaddr));
	427
	428	extern CORE_ADDR
	429	read_register PARAMS ((int regno));
	430
	431	extern void
30974778	432	write_register PARAMS ((int regno, LONGEST val));
01be6913 PB	433
	434	extern void
	435	supply_register PARAMS ((int regno, char *val));
	436
01be6913 PB	437	extern void
	438	get_saved_register PARAMS ((char raw_buffer, int optimized,
	439	CORE_ADDR addrp, struct frame_info frame,
	440	int regnum, enum lval_type *lval));
	441
	442	extern void
5573d7d4	443	modify_field PARAMS ((char *addr, LONGEST fieldval, int bitpos, int bitsize));
01be6913 PB	444
01be6913 PB	445	extern void
30974778	446	type_print PARAMS ((struct type type, char varstring, GDB_FILE *stream,
01be6913 PB	447	int show));
01be6913 PB	448
82a2edfb JK	449	extern char baseclass_addr PARAMS ((struct type type, int index,
	450	char *valaddr,
	451	value_ptr valuep, int errp));
01be6913	452
7efb57c3	453	extern void
30974778 JK	454	print_longest PARAMS ((GDB_FILE *stream, int format, int use_local,
30974778 JK	455	LONGEST val));
7efb57c3	456
01be6913	457	extern void
30974778	458	print_floating PARAMS ((char valaddr, struct type type, GDB_FILE *stream));
01be6913	459
82a2edfb JK	460	extern int value_print PARAMS ((value_ptr val, GDB_FILE *stream, int format,
82a2edfb JK	461	enum val_prettyprint pretty));
01be6913	462
a91a6192 SS	463	extern void
	464	value_print_array_elements PARAMS ((value_ptr val, GDB_FILE* stream,
	465	int format, enum val_prettyprint pretty));
	466
999dd04b JL	467	extern value_ptr
	468	value_release_to_mark PARAMS ((value_ptr mark));
	469
01be6913 PB	470	extern int
01be6913 PB	471	val_print PARAMS ((struct type type, char valaddr, CORE_ADDR address,
30974778	472	GDB_FILE *stream, int format, int deref_ref,
01be6913 PB	473	int recurse, enum val_prettyprint pretty));
01be6913 PB	474
c7da3ed3	475	extern int
30974778	476	val_print_string PARAMS ((CORE_ADDR addr, unsigned int len, GDB_FILE *stream));
c7da3ed3	477
01be6913 PB	478	extern void
01be6913 PB	479	print_variable_value PARAMS ((struct symbol var, struct frame_info frame,
30974778	480	GDB_FILE *stream));
01be6913	481
82a2edfb	482	extern value_ptr value_arg_coerce PARAMS ((value_ptr));
01be6913	483
82a2edfb	484	extern int check_field PARAMS ((value_ptr, const char *));
01be6913 PB	485
01be6913 PB	486	extern void
30974778	487	c_typedef_print PARAMS ((struct type type, struct symbol new, GDB_FILE *stream));
01be6913 PB	488
	489	extern char *
	490	internalvar_name PARAMS ((struct internalvar *var));
	491
	492	extern void
	493	clear_value_history PARAMS ((void));
	494
	495	extern void
	496	clear_internalvars PARAMS ((void));
	497
	498	/* From values.c */
	499
82a2edfb	500	extern value_ptr value_copy PARAMS ((value_ptr));
01be6913	501
82a2edfb	502	extern int baseclass_offset PARAMS ((struct type *, int, value_ptr, int));
c7da3ed3	503
01be6913	504	/* From valops.c */
bd5635a1	505
82a2edfb	506	extern value_ptr call_function_by_hand PARAMS ((value_ptr, int, value_ptr *));
e17960fb	507
a91a6192 SS	508	extern value_ptr f77_value_literal_complex PARAMS ((value_ptr, value_ptr, int));
	509
	510	extern value_ptr f77_value_literal_string PARAMS ((int, int, value_ptr *));
	511
	512	extern value_ptr f77_value_substring PARAMS ((value_ptr, int, int));
	513
01be6913	514	#endif /* !defined (VALUE_H) */