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