Commit | Line | Data |
---|---|---|
c906108c | 1 | /* Definitions for values of C expressions, for GDB. |
dea7f9ba | 2 | |
3666a048 | 3 | Copyright (C) 1986-2021 Free Software Foundation, Inc. |
c906108c | 4 | |
c5aa993b | 5 | This file is part of GDB. |
c906108c | 6 | |
c5aa993b JM |
7 | This program is free software; you can redistribute it and/or modify |
8 | it under the terms of the GNU General Public License as published by | |
a9762ec7 | 9 | the Free Software Foundation; either version 3 of the License, or |
c5aa993b | 10 | (at your option) any later version. |
c906108c | 11 | |
c5aa993b JM |
12 | This program is distributed in the hope that it will be useful, |
13 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
15 | GNU General Public License for more details. | |
c906108c | 16 | |
c5aa993b | 17 | You should have received a copy of the GNU General Public License |
a9762ec7 | 18 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
c906108c SS |
19 | |
20 | #if !defined (VALUE_H) | |
21 | #define VALUE_H 1 | |
22 | ||
1df6926e | 23 | #include "frame.h" /* For struct frame_id. */ |
ba18742c | 24 | #include "extension.h" |
268a13a5 | 25 | #include "gdbsupport/gdb_ref_ptr.h" |
b49180ac | 26 | #include "gmp-utils.h" |
dea7f9ba MK |
27 | |
28 | struct block; | |
da3331ec | 29 | struct expression; |
dea7f9ba | 30 | struct regcache; |
da3331ec AC |
31 | struct symbol; |
32 | struct type; | |
dea7f9ba | 33 | struct ui_file; |
d8ca156b | 34 | struct language_defn; |
79a45b7d | 35 | struct value_print_options; |
d16aafd8 | 36 | |
9a0dc9e3 PA |
37 | /* Values can be partially 'optimized out' and/or 'unavailable'. |
38 | These are distinct states and have different string representations | |
39 | and related error strings. | |
40 | ||
41 | 'unavailable' has a specific meaning in this context. It means the | |
42 | value exists in the program (at the machine level), but GDB has no | |
43 | means to get to it. Such a value is normally printed as | |
44 | <unavailable>. Examples of how to end up with an unavailable value | |
45 | would be: | |
46 | ||
47 | - We're inspecting a traceframe, and the memory or registers the | |
48 | debug information says the value lives on haven't been collected. | |
49 | ||
50 | - We're inspecting a core dump, the memory or registers the debug | |
51 | information says the value lives aren't present in the dump | |
52 | (that is, we have a partial/trimmed core dump, or we don't fully | |
53 | understand/handle the core dump's format). | |
54 | ||
55 | - We're doing live debugging, but the debug API has no means to | |
56 | get at where the value lives in the machine, like e.g., ptrace | |
57 | not having access to some register or register set. | |
58 | ||
59 | - Any other similar scenario. | |
60 | ||
61 | OTOH, "optimized out" is about what the compiler decided to generate | |
62 | (or not generate). A chunk of a value that was optimized out does | |
63 | not actually exist in the program. There's no way to get at it | |
64 | short of compiling the program differently. | |
65 | ||
66 | A register that has not been saved in a frame is likewise considered | |
67 | optimized out, except not-saved registers have a different string | |
68 | representation and related error strings. E.g., we'll print them as | |
69 | <not-saved> instead of <optimized out>, as in: | |
70 | ||
71 | (gdb) p/x $rax | |
72 | $1 = <not saved> | |
73 | (gdb) info registers rax | |
74 | rax <not saved> | |
75 | ||
76 | If the debug info describes a variable as being in such a register, | |
77 | we'll still print the variable as <optimized out>. IOW, <not saved> | |
78 | is reserved for inspecting registers at the machine level. | |
79 | ||
80 | When comparing value contents, optimized out chunks, unavailable | |
81 | chunks, and valid contents data are all considered different. See | |
82 | value_contents_eq for more info. | |
83 | */ | |
84 | ||
e4153ae6 CB |
85 | extern bool overload_resolution; |
86 | ||
dea7f9ba MK |
87 | /* The structure which defines the type of a value. It should never |
88 | be possible for a program lval value to survive over a call to the | |
89 | inferior (i.e. to be put into the history list or an internal | |
90 | variable). */ | |
c906108c | 91 | |
91294c83 | 92 | struct value; |
c906108c | 93 | |
bbfa6f00 | 94 | /* Increase VAL's reference count. */ |
22bc8444 | 95 | |
bbfa6f00 | 96 | extern void value_incref (struct value *val); |
22bc8444 | 97 | |
bbfa6f00 TT |
98 | /* Decrease VAL's reference count. When the reference count drops to |
99 | 0, VAL will be freed. */ | |
22bc8444 TT |
100 | |
101 | extern void value_decref (struct value *val); | |
102 | ||
103 | /* A policy class to interface gdb::ref_ptr with struct value. */ | |
104 | ||
105 | struct value_ref_policy | |
106 | { | |
107 | static void incref (struct value *ptr) | |
108 | { | |
109 | value_incref (ptr); | |
110 | } | |
111 | ||
112 | static void decref (struct value *ptr) | |
113 | { | |
114 | value_decref (ptr); | |
115 | } | |
116 | }; | |
117 | ||
118 | /* A gdb:;ref_ptr pointer to a struct value. */ | |
119 | ||
120 | typedef gdb::ref_ptr<struct value, value_ref_policy> value_ref_ptr; | |
121 | ||
17cf0ecd | 122 | /* Values are stored in a chain, so that they can be deleted easily |
a08702d6 TJB |
123 | over calls to the inferior. Values assigned to internal variables, |
124 | put into the value history or exposed to Python are taken off this | |
125 | list. */ | |
91294c83 | 126 | |
4bf7b526 | 127 | struct value *value_next (const struct value *); |
17cf0ecd | 128 | |
91294c83 AC |
129 | /* Type of the value. */ |
130 | ||
0e03807e | 131 | extern struct type *value_type (const struct value *); |
91294c83 | 132 | |
e512cdbd SM |
133 | /* Return the gdbarch associated with the value. */ |
134 | ||
135 | extern struct gdbarch *get_value_arch (const struct value *value); | |
136 | ||
04624583 AC |
137 | /* This is being used to change the type of an existing value, that |
138 | code should instead be creating a new value with the changed type | |
139 | (but possibly shared content). */ | |
91294c83 | 140 | |
04624583 AC |
141 | extern void deprecated_set_value_type (struct value *value, |
142 | struct type *type); | |
91294c83 AC |
143 | |
144 | /* Only used for bitfields; number of bits contained in them. */ | |
145 | ||
6b850546 DT |
146 | extern LONGEST value_bitsize (const struct value *); |
147 | extern void set_value_bitsize (struct value *, LONGEST bit); | |
91294c83 AC |
148 | |
149 | /* Only used for bitfields; position of start of field. For | |
d5a22e77 TT |
150 | little-endian targets, it is the position of the LSB. For |
151 | big-endian targets, it is the position of the MSB. */ | |
91294c83 | 152 | |
6b850546 DT |
153 | extern LONGEST value_bitpos (const struct value *); |
154 | extern void set_value_bitpos (struct value *, LONGEST bit); | |
f5cf64a7 | 155 | |
4ea48cc1 DJ |
156 | /* Only used for bitfields; the containing value. This allows a |
157 | single read from the target when displaying multiple | |
158 | bitfields. */ | |
159 | ||
4bf7b526 | 160 | struct value *value_parent (const struct value *); |
53ba8333 | 161 | extern void set_value_parent (struct value *value, struct value *parent); |
4ea48cc1 | 162 | |
91294c83 AC |
163 | /* Describes offset of a value within lval of a structure in bytes. |
164 | If lval == lval_memory, this is an offset to the address. If lval | |
165 | == lval_register, this is a further offset from location.address | |
166 | within the registers structure. Note also the member | |
167 | embedded_offset below. */ | |
168 | ||
6b850546 DT |
169 | extern LONGEST value_offset (const struct value *); |
170 | extern void set_value_offset (struct value *, LONGEST offset); | |
df407dfe | 171 | |
88e3b34b AC |
172 | /* The comment from "struct value" reads: ``Is it modifiable? Only |
173 | relevant if lval != not_lval.''. Shouldn't the value instead be | |
174 | not_lval and be done with it? */ | |
91294c83 | 175 | |
4bf7b526 | 176 | extern int deprecated_value_modifiable (const struct value *value); |
88e3b34b | 177 | |
91294c83 AC |
178 | /* If a value represents a C++ object, then the `type' field gives the |
179 | object's compile-time type. If the object actually belongs to some | |
180 | class derived from `type', perhaps with other base classes and | |
181 | additional members, then `type' is just a subobject of the real | |
182 | thing, and the full object is probably larger than `type' would | |
183 | suggest. | |
184 | ||
185 | If `type' is a dynamic class (i.e. one with a vtable), then GDB can | |
186 | actually determine the object's run-time type by looking at the | |
187 | run-time type information in the vtable. When this information is | |
188 | available, we may elect to read in the entire object, for several | |
189 | reasons: | |
190 | ||
191 | - When printing the value, the user would probably rather see the | |
192 | full object, not just the limited portion apparent from the | |
193 | compile-time type. | |
194 | ||
195 | - If `type' has virtual base classes, then even printing `type' | |
196 | alone may require reaching outside the `type' portion of the | |
197 | object to wherever the virtual base class has been stored. | |
198 | ||
199 | When we store the entire object, `enclosing_type' is the run-time | |
200 | type -- the complete object -- and `embedded_offset' is the offset | |
201 | of `type' within that larger type, in bytes. The value_contents() | |
202 | macro takes `embedded_offset' into account, so most GDB code | |
203 | continues to see the `type' portion of the value, just as the | |
204 | inferior would. | |
205 | ||
206 | If `type' is a pointer to an object, then `enclosing_type' is a | |
207 | pointer to the object's run-time type, and `pointed_to_offset' is | |
208 | the offset in bytes from the full object to the pointed-to object | |
209 | -- that is, the value `embedded_offset' would have if we followed | |
210 | the pointer and fetched the complete object. (I don't really see | |
211 | the point. Why not just determine the run-time type when you | |
212 | indirect, and avoid the special case? The contents don't matter | |
213 | until you indirect anyway.) | |
214 | ||
215 | If we're not doing anything fancy, `enclosing_type' is equal to | |
216 | `type', and `embedded_offset' is zero, so everything works | |
217 | normally. */ | |
218 | ||
4bf7b526 | 219 | extern struct type *value_enclosing_type (const struct value *); |
4dfea560 DE |
220 | extern void set_value_enclosing_type (struct value *val, |
221 | struct type *new_type); | |
222 | ||
8264ba82 AG |
223 | /* Returns value_type or value_enclosing_type depending on |
224 | value_print_options.objectprint. | |
225 | ||
226 | If RESOLVE_SIMPLE_TYPES is 0 the enclosing type will be resolved | |
227 | only for pointers and references, else it will be returned | |
228 | for all the types (e.g. structures). This option is useful | |
229 | to prevent retrieving enclosing type for the base classes fields. | |
230 | ||
231 | REAL_TYPE_FOUND is used to inform whether the real type was found | |
232 | (or just static type was used). The NULL may be passed if it is not | |
233 | necessary. */ | |
234 | ||
235 | extern struct type *value_actual_type (struct value *value, | |
236 | int resolve_simple_types, | |
237 | int *real_type_found); | |
238 | ||
6b850546 DT |
239 | extern LONGEST value_pointed_to_offset (const struct value *value); |
240 | extern void set_value_pointed_to_offset (struct value *value, LONGEST val); | |
241 | extern LONGEST value_embedded_offset (const struct value *value); | |
242 | extern void set_value_embedded_offset (struct value *value, LONGEST val); | |
91294c83 | 243 | |
5f5233d4 PA |
244 | /* For lval_computed values, this structure holds functions used to |
245 | retrieve and set the value (or portions of the value). | |
246 | ||
247 | For each function, 'V' is the 'this' pointer: an lval_funcs | |
248 | function F may always assume that the V it receives is an | |
249 | lval_computed value, and has F in the appropriate slot of its | |
250 | lval_funcs structure. */ | |
251 | ||
252 | struct lval_funcs | |
253 | { | |
254 | /* Fill in VALUE's contents. This is used to "un-lazy" values. If | |
255 | a problem arises in obtaining VALUE's bits, this function should | |
ac71a68c JK |
256 | call 'error'. If it is NULL value_fetch_lazy on "un-lazy" |
257 | non-optimized-out value is an internal error. */ | |
5f5233d4 PA |
258 | void (*read) (struct value *v); |
259 | ||
260 | /* Handle an assignment TOVAL = FROMVAL by writing the value of | |
261 | FROMVAL to TOVAL's location. The contents of TOVAL have not yet | |
262 | been updated. If a problem arises in doing so, this function | |
ac71a68c JK |
263 | should call 'error'. If it is NULL such TOVAL assignment is an error as |
264 | TOVAL is not considered as an lvalue. */ | |
5f5233d4 PA |
265 | void (*write) (struct value *toval, struct value *fromval); |
266 | ||
8cf6f0b1 TT |
267 | /* If non-NULL, this is used to implement pointer indirection for |
268 | this value. This method may return NULL, in which case value_ind | |
269 | will fall back to ordinary indirection. */ | |
270 | struct value *(*indirect) (struct value *value); | |
271 | ||
a471c594 JK |
272 | /* If non-NULL, this is used to implement reference resolving for |
273 | this value. This method may return NULL, in which case coerce_ref | |
274 | will fall back to ordinary references resolving. */ | |
275 | struct value *(*coerce_ref) (const struct value *value); | |
276 | ||
8cf6f0b1 TT |
277 | /* If non-NULL, this is used to determine whether the indicated bits |
278 | of VALUE are a synthetic pointer. */ | |
279 | int (*check_synthetic_pointer) (const struct value *value, | |
6b850546 | 280 | LONGEST offset, int length); |
8cf6f0b1 | 281 | |
5f5233d4 PA |
282 | /* Return a duplicate of VALUE's closure, for use in a new value. |
283 | This may simply return the same closure, if VALUE's is | |
284 | reference-counted or statically allocated. | |
285 | ||
286 | This may be NULL, in which case VALUE's closure is re-used in the | |
287 | new value. */ | |
0e03807e | 288 | void *(*copy_closure) (const struct value *v); |
5f5233d4 PA |
289 | |
290 | /* Drop VALUE's reference to its closure. Maybe this frees the | |
291 | closure; maybe this decrements a reference count; maybe the | |
292 | closure is statically allocated and this does nothing. | |
293 | ||
294 | This may be NULL, in which case no action is taken to free | |
295 | VALUE's closure. */ | |
296 | void (*free_closure) (struct value *v); | |
297 | }; | |
298 | ||
299 | /* Create a computed lvalue, with type TYPE, function pointers FUNCS, | |
300 | and closure CLOSURE. */ | |
301 | ||
302 | extern struct value *allocate_computed_value (struct type *type, | |
c8f2448a JK |
303 | const struct lval_funcs *funcs, |
304 | void *closure); | |
5f5233d4 | 305 | |
a7035dbb JK |
306 | extern struct value *allocate_optimized_out_value (struct type *type); |
307 | ||
5f5233d4 PA |
308 | /* If VALUE is lval_computed, return its lval_funcs structure. */ |
309 | ||
a471c594 | 310 | extern const struct lval_funcs *value_computed_funcs (const struct value *); |
5f5233d4 PA |
311 | |
312 | /* If VALUE is lval_computed, return its closure. The meaning of the | |
313 | returned value depends on the functions VALUE uses. */ | |
314 | ||
0e03807e | 315 | extern void *value_computed_closure (const struct value *value); |
5f5233d4 | 316 | |
91294c83 | 317 | /* If zero, contents of this value are in the contents field. If |
9214ee5f DJ |
318 | nonzero, contents are in inferior. If the lval field is lval_memory, |
319 | the contents are in inferior memory at location.address plus offset. | |
320 | The lval field may also be lval_register. | |
91294c83 AC |
321 | |
322 | WARNING: This field is used by the code which handles watchpoints | |
323 | (see breakpoint.c) to decide whether a particular value can be | |
324 | watched by hardware watchpoints. If the lazy flag is set for some | |
325 | member of a value chain, it is assumed that this member of the | |
326 | chain doesn't need to be watched as part of watching the value | |
327 | itself. This is how GDB avoids watching the entire struct or array | |
328 | when the user wants to watch a single struct member or array | |
329 | element. If you ever change the way lazy flag is set and reset, be | |
330 | sure to consider this use as well! */ | |
331 | ||
4bf7b526 | 332 | extern int value_lazy (const struct value *); |
dfa52d88 | 333 | extern void set_value_lazy (struct value *value, int val); |
dea7f9ba | 334 | |
4bf7b526 | 335 | extern int value_stack (const struct value *); |
4e5d721f DE |
336 | extern void set_value_stack (struct value *value, int val); |
337 | ||
901461f8 PA |
338 | /* Throw an error complaining that the value has been optimized |
339 | out. */ | |
340 | ||
341 | extern void error_value_optimized_out (void); | |
342 | ||
0fd88904 AC |
343 | /* value_contents() and value_contents_raw() both return the address |
344 | of the gdb buffer used to hold a copy of the contents of the lval. | |
345 | value_contents() is used when the contents of the buffer are needed | |
dea7f9ba | 346 | -- it uses value_fetch_lazy() to load the buffer from the process |
0fd88904 AC |
347 | being debugged if it hasn't already been loaded |
348 | (value_contents_writeable() is used when a writeable but fetched | |
349 | buffer is required).. value_contents_raw() is used when data is | |
350 | being stored into the buffer, or when it is certain that the | |
351 | contents of the buffer are valid. | |
dea7f9ba | 352 | |
c906108c SS |
353 | Note: The contents pointer is adjusted by the offset required to |
354 | get to the real subobject, if the value happens to represent | |
dea7f9ba | 355 | something embedded in a larger run-time object. */ |
c906108c | 356 | |
fc1a4b47 | 357 | extern gdb_byte *value_contents_raw (struct value *); |
91294c83 AC |
358 | |
359 | /* Actual contents of the value. For use of this value; setting it | |
360 | uses the stuff above. Not valid if lazy is nonzero. Target | |
361 | byte-order. We force it to be aligned properly for any possible | |
362 | value. Note that a value therefore extends beyond what is | |
363 | declared here. */ | |
364 | ||
fc1a4b47 AC |
365 | extern const gdb_byte *value_contents (struct value *); |
366 | extern gdb_byte *value_contents_writeable (struct value *); | |
c906108c SS |
367 | |
368 | /* The ALL variants of the above two macros do not adjust the returned | |
dea7f9ba | 369 | pointer by the embedded_offset value. */ |
c5aa993b | 370 | |
fc1a4b47 AC |
371 | extern gdb_byte *value_contents_all_raw (struct value *); |
372 | extern const gdb_byte *value_contents_all (struct value *); | |
c5aa993b | 373 | |
0e03807e TT |
374 | /* Like value_contents_all, but does not require that the returned |
375 | bits be valid. This should only be used in situations where you | |
376 | plan to check the validity manually. */ | |
377 | extern const gdb_byte *value_contents_for_printing (struct value *value); | |
378 | ||
de4127a3 PA |
379 | /* Like value_contents_for_printing, but accepts a constant value |
380 | pointer. Unlike value_contents_for_printing however, the pointed | |
381 | value must _not_ be lazy. */ | |
382 | extern const gdb_byte * | |
383 | value_contents_for_printing_const (const struct value *value); | |
384 | ||
a844296a | 385 | extern void value_fetch_lazy (struct value *val); |
c906108c | 386 | |
91294c83 | 387 | /* If nonzero, this is the value of a variable which does not actually |
eca07816 JB |
388 | exist in the program, at least partially. If the value is lazy, |
389 | this may fetch it now. */ | |
feb13ab0 | 390 | extern int value_optimized_out (struct value *value); |
c906108c | 391 | |
9a0dc9e3 PA |
392 | /* Given a value, return true if any of the contents bits starting at |
393 | OFFSET and extending for LENGTH bits is optimized out, false | |
394 | otherwise. */ | |
395 | ||
396 | extern int value_bits_any_optimized_out (const struct value *value, | |
397 | int bit_offset, int bit_length); | |
398 | ||
399 | /* Like value_optimized_out, but return true iff the whole value is | |
400 | optimized out. */ | |
401 | extern int value_entirely_optimized_out (struct value *value); | |
402 | ||
403 | /* Mark VALUE's content bytes starting at OFFSET and extending for | |
404 | LENGTH bytes as optimized out. */ | |
405 | ||
406 | extern void mark_value_bytes_optimized_out (struct value *value, | |
407 | int offset, int length); | |
408 | ||
409 | /* Mark VALUE's content bits starting at OFFSET and extending for | |
410 | LENGTH bits as optimized out. */ | |
eca07816 | 411 | |
9a0dc9e3 | 412 | extern void mark_value_bits_optimized_out (struct value *value, |
6b850546 | 413 | LONGEST offset, LONGEST length); |
0e03807e | 414 | |
f372da99 | 415 | /* Set or return field indicating whether a variable is initialized or |
581e13c1 | 416 | not, based on debugging information supplied by the compiler. |
f372da99 | 417 | 1 = initialized; 0 = uninitialized. */ |
4bf7b526 | 418 | extern int value_initialized (const struct value *); |
f372da99 CT |
419 | extern void set_value_initialized (struct value *, int); |
420 | ||
74bcbdf3 PA |
421 | /* Set COMPONENT's location as appropriate for a component of WHOLE |
422 | --- regardless of what kind of lvalue WHOLE is. */ | |
423 | extern void set_value_component_location (struct value *component, | |
dda83cd7 | 424 | const struct value *whole); |
74bcbdf3 | 425 | |
13bb5560 AC |
426 | /* While the following fields are per- VALUE .CONTENT .PIECE (i.e., a |
427 | single value might have multiple LVALs), this hacked interface is | |
428 | limited to just the first PIECE. Expect further change. */ | |
91294c83 AC |
429 | /* Type of value; either not an lval, or one of the various different |
430 | possible kinds of lval. */ | |
13bb5560 AC |
431 | extern enum lval_type *deprecated_value_lval_hack (struct value *); |
432 | #define VALUE_LVAL(val) (*deprecated_value_lval_hack (val)) | |
91294c83 | 433 | |
a471c594 JK |
434 | /* Like VALUE_LVAL, except the parameter can be const. */ |
435 | extern enum lval_type value_lval_const (const struct value *value); | |
436 | ||
42ae5230 TT |
437 | /* If lval == lval_memory, return the address in the inferior. If |
438 | lval == lval_register, return the byte offset into the registers | |
439 | structure. Otherwise, return 0. The returned address | |
440 | includes the offset, if any. */ | |
de4127a3 | 441 | extern CORE_ADDR value_address (const struct value *); |
42ae5230 TT |
442 | |
443 | /* Like value_address, except the result does not include value's | |
444 | offset. */ | |
4bf7b526 | 445 | extern CORE_ADDR value_raw_address (const struct value *); |
42ae5230 TT |
446 | |
447 | /* Set the address of a value. */ | |
448 | extern void set_value_address (struct value *, CORE_ADDR); | |
91294c83 AC |
449 | |
450 | /* Pointer to internal variable. */ | |
13bb5560 AC |
451 | extern struct internalvar **deprecated_value_internalvar_hack (struct value *); |
452 | #define VALUE_INTERNALVAR(val) (*deprecated_value_internalvar_hack (val)) | |
91294c83 | 453 | |
41b56feb KB |
454 | /* Frame ID of "next" frame to which a register value is relative. A |
455 | register value is indicated by VALUE_LVAL being set to lval_register. | |
456 | So, if the register value is found relative to frame F, then the | |
457 | frame id of F->next will be stored in VALUE_NEXT_FRAME_ID. */ | |
458 | extern struct frame_id *deprecated_value_next_frame_id_hack (struct value *); | |
459 | #define VALUE_NEXT_FRAME_ID(val) (*deprecated_value_next_frame_id_hack (val)) | |
460 | ||
461 | /* Frame ID of frame to which a register value is relative. This is | |
462 | similar to VALUE_NEXT_FRAME_ID, above, but may not be assigned to. | |
463 | Note that VALUE_FRAME_ID effectively undoes the "next" operation | |
464 | that was performed during the assignment to VALUE_NEXT_FRAME_ID. */ | |
465 | #define VALUE_FRAME_ID(val) (get_prev_frame_id_by_id (VALUE_NEXT_FRAME_ID (val))) | |
91294c83 AC |
466 | |
467 | /* Register number if the value is from a register. */ | |
7dc54575 | 468 | extern int *deprecated_value_regnum_hack (struct value *); |
13bb5560 AC |
469 | #define VALUE_REGNUM(val) (*deprecated_value_regnum_hack (val)) |
470 | ||
a471c594 JK |
471 | /* Return value after lval_funcs->coerce_ref (after check_typedef). Return |
472 | NULL if lval_funcs->coerce_ref is not applicable for whatever reason. */ | |
473 | ||
474 | extern struct value *coerce_ref_if_computed (const struct value *arg); | |
475 | ||
dfcee124 AG |
476 | /* Setup a new value type and enclosing value type for dereferenced value VALUE. |
477 | ENC_TYPE is the new enclosing type that should be set. ORIGINAL_TYPE and | |
e79eb02f AB |
478 | ORIGINAL_VAL are the type and value of the original reference or |
479 | pointer. ORIGINAL_VALUE_ADDRESS is the address within VALUE, that is | |
480 | the address that was dereferenced. | |
dfcee124 AG |
481 | |
482 | Note, that VALUE is modified by this function. | |
483 | ||
484 | It is a common implementation for coerce_ref and value_ind. */ | |
485 | ||
486 | extern struct value * readjust_indirect_value_type (struct value *value, | |
487 | struct type *enc_type, | |
4bf7b526 | 488 | const struct type *original_type, |
e79eb02f AB |
489 | struct value *original_val, |
490 | CORE_ADDR original_value_address); | |
dfcee124 | 491 | |
dea7f9ba | 492 | /* Convert a REF to the object referenced. */ |
c906108c | 493 | |
994b9211 | 494 | extern struct value *coerce_ref (struct value *value); |
c906108c SS |
495 | |
496 | /* If ARG is an array, convert it to a pointer. | |
c906108c SS |
497 | If ARG is a function, convert it to a function pointer. |
498 | ||
499 | References are dereferenced. */ | |
500 | ||
994b9211 | 501 | extern struct value *coerce_array (struct value *value); |
c906108c | 502 | |
8cf6f0b1 TT |
503 | /* Given a value, determine whether the bits starting at OFFSET and |
504 | extending for LENGTH bits are a synthetic pointer. */ | |
505 | ||
506 | extern int value_bits_synthetic_pointer (const struct value *value, | |
6b850546 | 507 | LONGEST offset, LONGEST length); |
8cf6f0b1 | 508 | |
4e07d55f PA |
509 | /* Given a value, determine whether the contents bytes starting at |
510 | OFFSET and extending for LENGTH bytes are available. This returns | |
511 | nonzero if all bytes in the given range are available, zero if any | |
512 | byte is unavailable. */ | |
513 | ||
514 | extern int value_bytes_available (const struct value *value, | |
6b850546 | 515 | LONGEST offset, LONGEST length); |
4e07d55f | 516 | |
bdf22206 AB |
517 | /* Given a value, determine whether the contents bits starting at |
518 | OFFSET and extending for LENGTH bits are available. This returns | |
519 | nonzero if all bits in the given range are available, zero if any | |
520 | bit is unavailable. */ | |
521 | ||
522 | extern int value_bits_available (const struct value *value, | |
6b850546 | 523 | LONGEST offset, LONGEST length); |
bdf22206 | 524 | |
ec0a52e1 PA |
525 | /* Like value_bytes_available, but return false if any byte in the |
526 | whole object is unavailable. */ | |
527 | extern int value_entirely_available (struct value *value); | |
528 | ||
6211c335 YQ |
529 | /* Like value_entirely_available, but return false if any byte in the |
530 | whole object is available. */ | |
531 | extern int value_entirely_unavailable (struct value *value); | |
532 | ||
4e07d55f PA |
533 | /* Mark VALUE's content bytes starting at OFFSET and extending for |
534 | LENGTH bytes as unavailable. */ | |
535 | ||
536 | extern void mark_value_bytes_unavailable (struct value *value, | |
6b850546 | 537 | LONGEST offset, LONGEST length); |
c8c1c22f | 538 | |
bdf22206 AB |
539 | /* Mark VALUE's content bits starting at OFFSET and extending for |
540 | LENGTH bits as unavailable. */ | |
541 | ||
542 | extern void mark_value_bits_unavailable (struct value *value, | |
6b850546 | 543 | LONGEST offset, LONGEST length); |
bdf22206 | 544 | |
c8c1c22f | 545 | /* Compare LENGTH bytes of VAL1's contents starting at OFFSET1 with |
cd24cfaa PA |
546 | LENGTH bytes of VAL2's contents starting at OFFSET2. |
547 | ||
548 | Note that "contents" refers to the whole value's contents | |
549 | (value_contents_all), without any embedded offset adjustment. For | |
550 | example, to compare a complete object value with itself, including | |
551 | its enclosing type chunk, you'd do: | |
552 | ||
553 | int len = TYPE_LENGTH (check_typedef (value_enclosing_type (val))); | |
9a0dc9e3 PA |
554 | value_contents_eq (val, 0, val, 0, len); |
555 | ||
556 | Returns true iff the set of available/valid contents match. | |
557 | ||
558 | Optimized-out contents are equal to optimized-out contents, and are | |
559 | not equal to non-optimized-out contents. | |
cd24cfaa | 560 | |
30baf67b | 561 | Unavailable contents are equal to unavailable contents, and are not |
9a0dc9e3 | 562 | equal to non-unavailable contents. |
c8c1c22f | 563 | |
9a0dc9e3 PA |
564 | For example, if 'x's represent an unavailable byte, and 'V' and 'Z' |
565 | represent different available/valid bytes, in a value with length | |
566 | 16: | |
567 | ||
568 | offset: 0 4 8 12 16 | |
569 | contents: xxxxVVVVxxxxVVZZ | |
c8c1c22f PA |
570 | |
571 | then: | |
572 | ||
98ead37e YQ |
573 | value_contents_eq(val, 0, val, 8, 6) => true |
574 | value_contents_eq(val, 0, val, 4, 4) => false | |
575 | value_contents_eq(val, 0, val, 8, 8) => false | |
576 | value_contents_eq(val, 4, val, 12, 2) => true | |
577 | value_contents_eq(val, 4, val, 12, 4) => true | |
578 | value_contents_eq(val, 3, val, 4, 4) => true | |
9a0dc9e3 PA |
579 | |
580 | If 'x's represent an unavailable byte, 'o' represents an optimized | |
581 | out byte, in a value with length 8: | |
582 | ||
583 | offset: 0 4 8 | |
584 | contents: xxxxoooo | |
585 | ||
586 | then: | |
587 | ||
98ead37e YQ |
588 | value_contents_eq(val, 0, val, 2, 2) => true |
589 | value_contents_eq(val, 4, val, 6, 2) => true | |
590 | value_contents_eq(val, 0, val, 4, 4) => true | |
9a0dc9e3 PA |
591 | |
592 | We only know whether a value chunk is unavailable or optimized out | |
593 | if we've tried to read it. As this routine is used by printing | |
594 | routines, which may be printing values in the value history, long | |
595 | after the inferior is gone, it works with const values. Therefore, | |
596 | this routine must not be called with lazy values. */ | |
597 | ||
98ead37e YQ |
598 | extern bool value_contents_eq (const struct value *val1, LONGEST offset1, |
599 | const struct value *val2, LONGEST offset2, | |
600 | LONGEST length); | |
4e07d55f | 601 | |
3ae385af SM |
602 | /* Read LENGTH addressable memory units starting at MEMADDR into BUFFER, |
603 | which is (or will be copied to) VAL's contents buffer offset by | |
23f945bf AA |
604 | BIT_OFFSET bits. Marks value contents ranges as unavailable if |
605 | the corresponding memory is likewise unavailable. STACK indicates | |
606 | whether the memory is known to be stack memory. */ | |
e6ca34fc | 607 | |
23f945bf | 608 | extern void read_value_memory (struct value *val, LONGEST bit_offset, |
e6ca34fc PA |
609 | int stack, CORE_ADDR memaddr, |
610 | gdb_byte *buffer, size_t length); | |
611 | ||
8954db33 AB |
612 | /* Cast SCALAR_VALUE to the element type of VECTOR_TYPE, then replicate |
613 | into each element of a new vector value with VECTOR_TYPE. */ | |
614 | ||
615 | struct value *value_vector_widen (struct value *scalar_value, | |
616 | struct type *vector_type); | |
617 | ||
c906108c | 618 | \f |
c5aa993b | 619 | |
c906108c SS |
620 | #include "symtab.h" |
621 | #include "gdbtypes.h" | |
622 | #include "expression.h" | |
623 | ||
c906108c SS |
624 | struct frame_info; |
625 | struct fn_field; | |
c906108c | 626 | |
9cb709b6 TT |
627 | extern int print_address_demangle (const struct value_print_options *, |
628 | struct gdbarch *, CORE_ADDR, | |
629 | struct ui_file *, int); | |
c906108c | 630 | |
70100014 UW |
631 | /* Returns true if VAL is of floating-point type. In addition, |
632 | throws an error if the value is an invalid floating-point value. */ | |
633 | extern bool is_floating_value (struct value *val); | |
634 | ||
f23631e4 | 635 | extern LONGEST value_as_long (struct value *val); |
f23631e4 | 636 | extern CORE_ADDR value_as_address (struct value *val); |
c906108c | 637 | |
fc1a4b47 | 638 | extern LONGEST unpack_long (struct type *type, const gdb_byte *valaddr); |
fc1a4b47 | 639 | extern CORE_ADDR unpack_pointer (struct type *type, const gdb_byte *valaddr); |
5467c6c8 | 640 | |
8929e59d | 641 | extern LONGEST unpack_field_as_long (struct type *type, |
fc1a4b47 | 642 | const gdb_byte *valaddr, |
a14ed312 | 643 | int fieldno); |
ef83a141 TT |
644 | |
645 | /* Unpack a bitfield of the specified FIELD_TYPE, from the object at | |
646 | VALADDR, and store the result in *RESULT. | |
647 | The bitfield starts at BITPOS bits and contains BITSIZE bits; if | |
648 | BITSIZE is zero, then the length is taken from FIELD_TYPE. | |
649 | ||
650 | Extracting bits depends on endianness of the machine. Compute the | |
651 | number of least significant bits to discard. For big endian machines, | |
652 | we compute the total number of bits in the anonymous object, subtract | |
653 | off the bit count from the MSB of the object to the MSB of the | |
654 | bitfield, then the size of the bitfield, which leaves the LSB discard | |
655 | count. For little endian machines, the discard count is simply the | |
656 | number of bits from the LSB of the anonymous object to the LSB of the | |
657 | bitfield. | |
658 | ||
659 | If the field is signed, we also do sign extension. */ | |
660 | ||
661 | extern LONGEST unpack_bits_as_long (struct type *field_type, | |
662 | const gdb_byte *valaddr, | |
663 | LONGEST bitpos, LONGEST bitsize); | |
664 | ||
5467c6c8 | 665 | extern int unpack_value_field_as_long (struct type *type, const gdb_byte *valaddr, |
6b850546 | 666 | LONGEST embedded_offset, int fieldno, |
5467c6c8 PA |
667 | const struct value *val, LONGEST *result); |
668 | ||
bb9d5f81 | 669 | extern void unpack_value_bitfield (struct value *dest_val, |
6b850546 DT |
670 | LONGEST bitpos, LONGEST bitsize, |
671 | const gdb_byte *valaddr, | |
672 | LONGEST embedded_offset, | |
bb9d5f81 PP |
673 | const struct value *val); |
674 | ||
5467c6c8 PA |
675 | extern struct value *value_field_bitfield (struct type *type, int fieldno, |
676 | const gdb_byte *valaddr, | |
6b850546 | 677 | LONGEST embedded_offset, |
5467c6c8 | 678 | const struct value *val); |
c906108c | 679 | |
14d06750 DJ |
680 | extern void pack_long (gdb_byte *buf, struct type *type, LONGEST num); |
681 | ||
f23631e4 | 682 | extern struct value *value_from_longest (struct type *type, LONGEST num); |
595939de | 683 | extern struct value *value_from_ulongest (struct type *type, ULONGEST num); |
f23631e4 | 684 | extern struct value *value_from_pointer (struct type *type, CORE_ADDR addr); |
7584bb30 | 685 | extern struct value *value_from_host_double (struct type *type, double d); |
e799154c | 686 | extern struct value *value_from_history_ref (const char *, const char **); |
3fff9862 YQ |
687 | extern struct value *value_from_component (struct value *, struct type *, |
688 | LONGEST); | |
0f71a2f6 | 689 | |
00a4c844 AC |
690 | extern struct value *value_at (struct type *type, CORE_ADDR addr); |
691 | extern struct value *value_at_lazy (struct type *type, CORE_ADDR addr); | |
c906108c | 692 | |
012370f6 TT |
693 | extern struct value *value_from_contents_and_address_unresolved |
694 | (struct type *, const gdb_byte *, CORE_ADDR); | |
8acb6b92 TT |
695 | extern struct value *value_from_contents_and_address (struct type *, |
696 | const gdb_byte *, | |
697 | CORE_ADDR); | |
8a9b8146 | 698 | extern struct value *value_from_contents (struct type *, const gdb_byte *); |
8acb6b92 | 699 | |
2ed3c037 UW |
700 | extern struct value *default_value_from_register (struct gdbarch *gdbarch, |
701 | struct type *type, | |
9acbedc0 | 702 | int regnum, |
2ed3c037 | 703 | struct frame_id frame_id); |
9acbedc0 | 704 | |
b56d6f31 JB |
705 | extern void read_frame_register_value (struct value *value, |
706 | struct frame_info *frame); | |
707 | ||
f23631e4 AC |
708 | extern struct value *value_from_register (struct type *type, int regnum, |
709 | struct frame_info *frame); | |
c906108c | 710 | |
2ed3c037 | 711 | extern CORE_ADDR address_from_register (int regnum, |
0b2b0195 UW |
712 | struct frame_info *frame); |
713 | ||
9df2fbc4 PM |
714 | extern struct value *value_of_variable (struct symbol *var, |
715 | const struct block *b); | |
c906108c | 716 | |
270140bd TT |
717 | extern struct value *address_of_variable (struct symbol *var, |
718 | const struct block *b); | |
61212c0f | 719 | |
89f5065b | 720 | extern struct value *value_of_register (int regnum, struct frame_info *frame); |
c906108c | 721 | |
9214ee5f DJ |
722 | struct value *value_of_register_lazy (struct frame_info *frame, int regnum); |
723 | ||
0b31a4bc TT |
724 | /* Return the symbol's reading requirement. */ |
725 | ||
726 | extern enum symbol_needs_kind symbol_read_needs (struct symbol *); | |
727 | ||
728 | /* Return true if the symbol needs a frame. This is a wrapper for | |
729 | symbol_read_needs that simply checks for SYMBOL_NEEDS_FRAME. */ | |
730 | ||
a14ed312 | 731 | extern int symbol_read_needs_frame (struct symbol *); |
c906108c | 732 | |
f23631e4 | 733 | extern struct value *read_var_value (struct symbol *var, |
63e43d3a | 734 | const struct block *var_block, |
f23631e4 | 735 | struct frame_info *frame); |
c906108c | 736 | |
f23631e4 | 737 | extern struct value *allocate_value (struct type *type); |
3e3d7139 | 738 | extern struct value *allocate_value_lazy (struct type *type); |
6b850546 DT |
739 | extern void value_contents_copy (struct value *dst, LONGEST dst_offset, |
740 | struct value *src, LONGEST src_offset, | |
741 | LONGEST length); | |
c906108c | 742 | |
f23631e4 | 743 | extern struct value *allocate_repeat_value (struct type *type, int count); |
c906108c | 744 | |
f23631e4 | 745 | extern struct value *value_mark (void); |
c906108c | 746 | |
4bf7b526 | 747 | extern void value_free_to_mark (const struct value *mark); |
c906108c | 748 | |
eb115069 TT |
749 | /* A helper class that uses value_mark at construction time and calls |
750 | value_free_to_mark in the destructor. This is used to clear out | |
751 | temporary values created during the lifetime of this object. */ | |
752 | class scoped_value_mark | |
753 | { | |
754 | public: | |
755 | ||
756 | scoped_value_mark () | |
757 | : m_value (value_mark ()) | |
758 | { | |
759 | } | |
760 | ||
761 | ~scoped_value_mark () | |
762 | { | |
0cf08227 TT |
763 | free_to_mark (); |
764 | } | |
765 | ||
54f70bc1 TT |
766 | scoped_value_mark (scoped_value_mark &&other) = default; |
767 | ||
768 | DISABLE_COPY_AND_ASSIGN (scoped_value_mark); | |
769 | ||
0cf08227 TT |
770 | /* Free the values currently on the value stack. */ |
771 | void free_to_mark () | |
772 | { | |
773 | if (m_value != NULL) | |
774 | { | |
775 | value_free_to_mark (m_value); | |
776 | m_value = NULL; | |
777 | } | |
eb115069 TT |
778 | } |
779 | ||
780 | private: | |
781 | ||
782 | const struct value *m_value; | |
783 | }; | |
784 | ||
e3a3797e | 785 | extern struct value *value_cstring (const char *ptr, ssize_t len, |
3b7538c0 | 786 | struct type *char_type); |
7cc3f8e2 | 787 | extern struct value *value_string (const char *ptr, ssize_t len, |
3b7538c0 | 788 | struct type *char_type); |
c906108c | 789 | |
f23631e4 | 790 | extern struct value *value_array (int lowbound, int highbound, |
89f5065b | 791 | struct value **elemvec); |
c906108c | 792 | |
f23631e4 | 793 | extern struct value *value_concat (struct value *arg1, struct value *arg2); |
c906108c | 794 | |
f23631e4 AC |
795 | extern struct value *value_binop (struct value *arg1, struct value *arg2, |
796 | enum exp_opcode op); | |
c906108c | 797 | |
2497b498 | 798 | extern struct value *value_ptradd (struct value *arg1, LONGEST arg2); |
89eef114 UW |
799 | |
800 | extern LONGEST value_ptrdiff (struct value *arg1, struct value *arg2); | |
c906108c | 801 | |
00db9531 SM |
802 | /* Return true if VAL does not live in target memory, but should in order |
803 | to operate on it. Otherwise return false. */ | |
804 | ||
805 | extern bool value_must_coerce_to_target (struct value *arg1); | |
63092375 DJ |
806 | |
807 | extern struct value *value_coerce_to_target (struct value *arg1); | |
808 | ||
f23631e4 | 809 | extern struct value *value_coerce_array (struct value *arg1); |
c906108c | 810 | |
f23631e4 | 811 | extern struct value *value_coerce_function (struct value *arg1); |
c906108c | 812 | |
f23631e4 | 813 | extern struct value *value_ind (struct value *arg1); |
c906108c | 814 | |
f23631e4 | 815 | extern struct value *value_addr (struct value *arg1); |
c906108c | 816 | |
a65cfae5 | 817 | extern struct value *value_ref (struct value *arg1, enum type_code refcode); |
fb933624 | 818 | |
89f5065b AC |
819 | extern struct value *value_assign (struct value *toval, |
820 | struct value *fromval); | |
c906108c | 821 | |
36e9969c NS |
822 | extern struct value *value_pos (struct value *arg1); |
823 | ||
f23631e4 | 824 | extern struct value *value_neg (struct value *arg1); |
c906108c | 825 | |
f23631e4 | 826 | extern struct value *value_complement (struct value *arg1); |
c906108c | 827 | |
f23631e4 AC |
828 | extern struct value *value_struct_elt (struct value **argp, |
829 | struct value **args, | |
714f19d5 TT |
830 | const char *name, int *static_memfuncp, |
831 | const char *err); | |
c906108c | 832 | |
b5b08fb4 SC |
833 | extern struct value *value_struct_elt_bitpos (struct value **argp, |
834 | int bitpos, | |
835 | struct type *field_type, | |
836 | const char *err); | |
837 | ||
79c2c32d | 838 | extern struct value *value_aggregate_elt (struct type *curtype, |
c848d642 | 839 | const char *name, |
072bba3b | 840 | struct type *expect_type, |
0d5de010 DJ |
841 | int want_address, |
842 | enum noside noside); | |
c906108c | 843 | |
f23631e4 | 844 | extern struct value *value_static_field (struct type *type, int fieldno); |
c906108c | 845 | |
4c3376c8 SW |
846 | enum oload_search_type { NON_METHOD, METHOD, BOTH }; |
847 | ||
6b1747cd | 848 | extern int find_overload_match (gdb::array_view<value *> args, |
4c3376c8 | 849 | const char *name, |
28c64fc2 | 850 | enum oload_search_type method, |
7f8c9282 | 851 | struct value **objp, struct symbol *fsym, |
f23631e4 | 852 | struct value **valp, struct symbol **symp, |
e66d4446 SC |
853 | int *staticp, const int no_adl, |
854 | enum noside noside); | |
c906108c | 855 | |
f23631e4 | 856 | extern struct value *value_field (struct value *arg1, int fieldno); |
c906108c | 857 | |
6b850546 | 858 | extern struct value *value_primitive_field (struct value *arg1, LONGEST offset, |
f23631e4 AC |
859 | int fieldno, |
860 | struct type *arg_type); | |
c906108c | 861 | |
c906108c | 862 | |
6b850546 | 863 | extern struct type *value_rtti_indirect_type (struct value *, int *, LONGEST *, |
dfcee124 | 864 | int *); |
c906108c | 865 | |
f23631e4 AC |
866 | extern struct value *value_full_object (struct value *, struct type *, int, |
867 | int, int); | |
c906108c | 868 | |
b1af9e97 | 869 | extern struct value *value_cast_pointers (struct type *, struct value *, int); |
fb933624 | 870 | |
f23631e4 | 871 | extern struct value *value_cast (struct type *type, struct value *arg2); |
c906108c | 872 | |
4e8f195d TT |
873 | extern struct value *value_reinterpret_cast (struct type *type, |
874 | struct value *arg); | |
875 | ||
876 | extern struct value *value_dynamic_cast (struct type *type, struct value *arg); | |
877 | ||
f23631e4 | 878 | extern struct value *value_zero (struct type *type, enum lval_type lv); |
c906108c | 879 | |
18a46dbe | 880 | extern struct value *value_one (struct type *type); |
301f0ecf | 881 | |
f23631e4 | 882 | extern struct value *value_repeat (struct value *arg1, int count); |
c906108c | 883 | |
2497b498 | 884 | extern struct value *value_subscript (struct value *array, LONGEST index); |
c906108c | 885 | |
afc05acb UW |
886 | extern struct value *value_bitstring_subscript (struct type *type, |
887 | struct value *bitstring, | |
2497b498 | 888 | LONGEST index); |
afc05acb | 889 | |
5fe830e4 AC |
890 | extern struct value *register_value_being_returned (struct type *valtype, |
891 | struct regcache *retbuf); | |
c906108c | 892 | |
fbb06eb1 | 893 | extern int value_in (struct value *element, struct value *set); |
c906108c | 894 | |
fc1a4b47 | 895 | extern int value_bit_index (struct type *type, const gdb_byte *addr, |
c84141d6 | 896 | int index); |
c906108c | 897 | |
bbfdfe1c DM |
898 | extern enum return_value_convention |
899 | struct_return_convention (struct gdbarch *gdbarch, struct value *function, | |
900 | struct type *value_type); | |
901 | ||
d80b854b | 902 | extern int using_struct_return (struct gdbarch *gdbarch, |
6a3a010b | 903 | struct value *function, |
c055b101 | 904 | struct type *value_type); |
c906108c | 905 | |
efd7ff14 TT |
906 | /* Evaluate the expression EXP. If set, EXPECT_TYPE is passed to the |
907 | outermost operation's evaluation. This is ignored by most | |
908 | operations, but may be used, e.g., to determine the type of an | |
909 | otherwise untyped symbol. The caller should not assume that the | |
910 | returned value has this type. */ | |
911 | ||
912 | extern struct value *evaluate_expression (struct expression *exp, | |
913 | struct type *expect_type = nullptr); | |
c906108c | 914 | |
f23631e4 | 915 | extern struct value *evaluate_type (struct expression *exp); |
c906108c | 916 | |
ced9779b JB |
917 | extern value *evaluate_var_value (enum noside noside, const block *blk, |
918 | symbol *var); | |
919 | ||
920 | extern value *evaluate_var_msym_value (enum noside noside, | |
921 | struct objfile *objfile, | |
922 | minimal_symbol *msymbol); | |
923 | ||
413403fc | 924 | namespace expr { class operation; }; |
1eaebe02 | 925 | extern void fetch_subexp_value (struct expression *exp, |
413403fc | 926 | expr::operation *op, |
0cf6dd15 | 927 | struct value **valp, struct value **resultp, |
a6535de1 | 928 | std::vector<value_ref_ptr> *val_chain, |
2e362716 | 929 | bool preserve_errors); |
0cf6dd15 | 930 | |
bbc13ae3 | 931 | extern struct value *parse_and_eval (const char *exp); |
c906108c | 932 | |
bbc13ae3 | 933 | extern struct value *parse_to_comma_and_eval (const char **expp); |
c906108c | 934 | |
f5756acc | 935 | extern struct type *parse_and_eval_type (const char *p, int length); |
c906108c | 936 | |
bbc13ae3 | 937 | extern CORE_ADDR parse_and_eval_address (const char *exp); |
c906108c | 938 | |
a1b8c4cc | 939 | extern LONGEST parse_and_eval_long (const char *exp); |
bb518678 | 940 | |
4066e646 UW |
941 | extern void unop_promote (const struct language_defn *language, |
942 | struct gdbarch *gdbarch, | |
943 | struct value **arg1); | |
944 | ||
945 | extern void binop_promote (const struct language_defn *language, | |
946 | struct gdbarch *gdbarch, | |
947 | struct value **arg1, struct value **arg2); | |
948 | ||
f23631e4 | 949 | extern struct value *access_value_history (int num); |
c906108c | 950 | |
78267919 UW |
951 | extern struct value *value_of_internalvar (struct gdbarch *gdbarch, |
952 | struct internalvar *var); | |
c906108c | 953 | |
4fa62494 UW |
954 | extern int get_internalvar_integer (struct internalvar *var, LONGEST *l); |
955 | ||
f23631e4 | 956 | extern void set_internalvar (struct internalvar *var, struct value *val); |
c906108c | 957 | |
4fa62494 UW |
958 | extern void set_internalvar_integer (struct internalvar *var, LONGEST l); |
959 | ||
78267919 UW |
960 | extern void set_internalvar_string (struct internalvar *var, |
961 | const char *string); | |
962 | ||
4fa62494 UW |
963 | extern void clear_internalvar (struct internalvar *var); |
964 | ||
a14ed312 | 965 | extern void set_internalvar_component (struct internalvar *var, |
6b850546 DT |
966 | LONGEST offset, |
967 | LONGEST bitpos, LONGEST bitsize, | |
f23631e4 | 968 | struct value *newvalue); |
c906108c | 969 | |
bc3b79fd | 970 | extern struct internalvar *lookup_only_internalvar (const char *name); |
c4a3d09a | 971 | |
bc3b79fd | 972 | extern struct internalvar *create_internalvar (const char *name); |
c4a3d09a | 973 | |
eb3ff9a5 PA |
974 | extern void complete_internalvar (completion_tracker &tracker, |
975 | const char *name); | |
d55637df | 976 | |
22d2b532 SDJ |
977 | /* An internalvar can be dynamically computed by supplying a vector of |
978 | function pointers to perform various operations. */ | |
979 | ||
980 | struct internalvar_funcs | |
981 | { | |
982 | /* Compute the value of the variable. The DATA argument passed to | |
983 | the function is the same argument that was passed to | |
984 | `create_internalvar_type_lazy'. */ | |
985 | ||
986 | struct value *(*make_value) (struct gdbarch *arch, | |
987 | struct internalvar *var, | |
988 | void *data); | |
989 | ||
990 | /* Update the agent expression EXPR with bytecode to compute the | |
991 | value. VALUE is the agent value we are updating. The DATA | |
992 | argument passed to this function is the same argument that was | |
993 | passed to `create_internalvar_type_lazy'. If this pointer is | |
994 | NULL, then the internalvar cannot be compiled to an agent | |
995 | expression. */ | |
996 | ||
997 | void (*compile_to_ax) (struct internalvar *var, | |
998 | struct agent_expr *expr, | |
999 | struct axs_value *value, | |
1000 | void *data); | |
1001 | ||
1002 | /* If non-NULL, this is called to destroy DATA. The DATA argument | |
1003 | passed to this function is the same argument that was passed to | |
1004 | `create_internalvar_type_lazy'. */ | |
1005 | ||
1006 | void (*destroy) (void *data); | |
1007 | }; | |
1008 | ||
73033f12 SDJ |
1009 | extern struct internalvar *create_internalvar_type_lazy (const char *name, |
1010 | const struct internalvar_funcs *funcs, | |
1011 | void *data); | |
22d2b532 SDJ |
1012 | |
1013 | /* Compile an internal variable to an agent expression. VAR is the | |
1014 | variable to compile; EXPR and VALUE are the agent expression we are | |
1015 | updating. This will return 0 if there is no known way to compile | |
1016 | VAR, and 1 if VAR was successfully compiled. It may also throw an | |
1017 | exception on error. */ | |
1018 | ||
1019 | extern int compile_internalvar_to_ax (struct internalvar *var, | |
1020 | struct agent_expr *expr, | |
1021 | struct axs_value *value); | |
4aa995e1 | 1022 | |
bc3b79fd | 1023 | extern struct internalvar *lookup_internalvar (const char *name); |
c906108c | 1024 | |
f23631e4 | 1025 | extern int value_equal (struct value *arg1, struct value *arg2); |
c906108c | 1026 | |
218d2fc6 TJB |
1027 | extern int value_equal_contents (struct value *arg1, struct value *arg2); |
1028 | ||
f23631e4 | 1029 | extern int value_less (struct value *arg1, struct value *arg2); |
c906108c | 1030 | |
f23631e4 | 1031 | extern int value_logical_not (struct value *arg1); |
c906108c SS |
1032 | |
1033 | /* C++ */ | |
1034 | ||
85bc8cb7 JK |
1035 | extern struct value *value_of_this (const struct language_defn *lang); |
1036 | ||
1037 | extern struct value *value_of_this_silent (const struct language_defn *lang); | |
c906108c | 1038 | |
f23631e4 AC |
1039 | extern struct value *value_x_binop (struct value *arg1, struct value *arg2, |
1040 | enum exp_opcode op, | |
1041 | enum exp_opcode otherop, | |
1042 | enum noside noside); | |
c906108c | 1043 | |
f23631e4 AC |
1044 | extern struct value *value_x_unop (struct value *arg1, enum exp_opcode op, |
1045 | enum noside noside); | |
c906108c | 1046 | |
89f5065b | 1047 | extern struct value *value_fn_field (struct value **arg1p, struct fn_field *f, |
6b850546 | 1048 | int j, struct type *type, LONGEST offset); |
c906108c | 1049 | |
be636754 PA |
1050 | extern int binop_types_user_defined_p (enum exp_opcode op, |
1051 | struct type *type1, | |
1052 | struct type *type2); | |
1053 | ||
f23631e4 AC |
1054 | extern int binop_user_defined_p (enum exp_opcode op, struct value *arg1, |
1055 | struct value *arg2); | |
c906108c | 1056 | |
f23631e4 | 1057 | extern int unop_user_defined_p (enum exp_opcode op, struct value *arg1); |
c906108c | 1058 | |
d8228535 | 1059 | extern int destructor_name_p (const char *name, struct type *type); |
c906108c | 1060 | |
22bc8444 | 1061 | extern value_ref_ptr release_value (struct value *val); |
e848a8a5 | 1062 | |
f23631e4 | 1063 | extern int record_latest_value (struct value *val); |
c906108c | 1064 | |
50810684 | 1065 | extern void modify_field (struct type *type, gdb_byte *addr, |
6b850546 | 1066 | LONGEST fieldval, LONGEST bitpos, LONGEST bitsize); |
c906108c | 1067 | |
0d5cff50 | 1068 | extern void type_print (struct type *type, const char *varstring, |
89f5065b | 1069 | struct ui_file *stream, int show); |
c906108c | 1070 | |
2f408ecb | 1071 | extern std::string type_to_string (struct type *type); |
ae6a3a4c | 1072 | |
fc1a4b47 AC |
1073 | extern gdb_byte *baseclass_addr (struct type *type, int index, |
1074 | gdb_byte *valaddr, | |
8929e59d | 1075 | struct value **valuep, int *errp); |
c906108c | 1076 | |
89f5065b | 1077 | extern void print_longest (struct ui_file *stream, int format, |
d9fcf2fb | 1078 | int use_local, LONGEST val); |
c906108c | 1079 | |
fc1a4b47 | 1080 | extern void print_floating (const gdb_byte *valaddr, struct type *type, |
89f5065b | 1081 | struct ui_file *stream); |
c906108c | 1082 | |
8e069a98 TT |
1083 | extern void value_print (struct value *val, struct ui_file *stream, |
1084 | const struct value_print_options *options); | |
c906108c | 1085 | |
f23631e4 AC |
1086 | extern void value_print_array_elements (struct value *val, |
1087 | struct ui_file *stream, int format, | |
2a998fc0 | 1088 | enum val_prettyformat pretty); |
c906108c | 1089 | |
a6535de1 TT |
1090 | /* Release values from the value chain and return them. Values |
1091 | created after MARK are released. If MARK is nullptr, or if MARK is | |
1092 | not found on the value chain, then all values are released. Values | |
1093 | are returned in reverse order of creation; that is, newest | |
1094 | first. */ | |
1095 | ||
1096 | extern std::vector<value_ref_ptr> value_release_to_mark | |
1097 | (const struct value *mark); | |
c906108c | 1098 | |
a1f5dd1b TT |
1099 | extern void common_val_print (struct value *val, |
1100 | struct ui_file *stream, int recurse, | |
1101 | const struct value_print_options *options, | |
1102 | const struct language_defn *language); | |
806048c6 | 1103 | |
09ca9e2e TT |
1104 | extern int val_print_string (struct type *elttype, const char *encoding, |
1105 | CORE_ADDR addr, int len, | |
79a45b7d TT |
1106 | struct ui_file *stream, |
1107 | const struct value_print_options *options); | |
c906108c | 1108 | |
aad95b57 TT |
1109 | extern void print_variable_and_value (const char *name, |
1110 | struct symbol *var, | |
1111 | struct frame_info *frame, | |
1112 | struct ui_file *stream, | |
1113 | int indent); | |
c906108c | 1114 | |
89f5065b AC |
1115 | extern void typedef_print (struct type *type, struct symbol *news, |
1116 | struct ui_file *stream); | |
c906108c | 1117 | |
baf20f76 | 1118 | extern const char *internalvar_name (const struct internalvar *var); |
c906108c | 1119 | |
ae5a43e0 | 1120 | extern void preserve_values (struct objfile *); |
c906108c SS |
1121 | |
1122 | /* From values.c */ | |
1123 | ||
f23631e4 | 1124 | extern struct value *value_copy (struct value *); |
c906108c | 1125 | |
c37f7098 KW |
1126 | extern struct value *value_non_lval (struct value *); |
1127 | ||
6c659fc2 SC |
1128 | extern void value_force_lval (struct value *, CORE_ADDR); |
1129 | ||
4c082a81 SC |
1130 | extern struct value *make_cv_value (int, int, struct value *); |
1131 | ||
4e7a5ef5 TT |
1132 | extern void preserve_one_value (struct value *, struct objfile *, htab_t); |
1133 | ||
c906108c SS |
1134 | /* From valops.c */ |
1135 | ||
f23631e4 | 1136 | extern struct value *varying_to_slice (struct value *); |
c906108c | 1137 | |
f23631e4 | 1138 | extern struct value *value_slice (struct value *, int, int); |
c906108c | 1139 | |
6b4a335b TT |
1140 | /* Create a complex number. The type is the complex type; the values |
1141 | are cast to the underlying scalar type before the complex number is | |
1142 | created. */ | |
1143 | ||
f23631e4 AC |
1144 | extern struct value *value_literal_complex (struct value *, struct value *, |
1145 | struct type *); | |
c906108c | 1146 | |
4c99290d TT |
1147 | /* Return the real part of a complex value. */ |
1148 | ||
1149 | extern struct value *value_real_part (struct value *value); | |
1150 | ||
1151 | /* Return the imaginary part of a complex value. */ | |
1152 | ||
1153 | extern struct value *value_imaginary_part (struct value *value); | |
1154 | ||
3e3b026f UW |
1155 | extern struct value *find_function_in_inferior (const char *, |
1156 | struct objfile **); | |
c906108c | 1157 | |
f23631e4 | 1158 | extern struct value *value_allocate_space_in_inferior (int); |
c906108c | 1159 | |
2497b498 | 1160 | extern struct value *value_subscripted_rvalue (struct value *array, |
592f9d27 AB |
1161 | LONGEST index, |
1162 | LONGEST lowerbound); | |
bc3b79fd TJB |
1163 | |
1164 | /* User function handler. */ | |
1165 | ||
d452c4bc UW |
1166 | typedef struct value *(*internal_function_fn) (struct gdbarch *gdbarch, |
1167 | const struct language_defn *language, | |
1168 | void *cookie, | |
bc3b79fd TJB |
1169 | int argc, |
1170 | struct value **argv); | |
1171 | ||
1a6d41c6 TT |
1172 | /* Add a new internal function. NAME is the name of the function; DOC |
1173 | is a documentation string describing the function. HANDLER is | |
1174 | called when the function is invoked. COOKIE is an arbitrary | |
1175 | pointer which is passed to HANDLER and is intended for "user | |
1176 | data". */ | |
1177 | ||
1178 | extern void add_internal_function (const char *name, const char *doc, | |
1179 | internal_function_fn handler, | |
1180 | void *cookie); | |
1181 | ||
1182 | /* This overload takes an allocated documentation string. */ | |
1183 | ||
3ea16160 | 1184 | extern void add_internal_function (gdb::unique_xmalloc_ptr<char> &&name, |
1a6d41c6 TT |
1185 | gdb::unique_xmalloc_ptr<char> &&doc, |
1186 | internal_function_fn handler, | |
1187 | void *cookie); | |
bc3b79fd | 1188 | |
d452c4bc UW |
1189 | struct value *call_internal_function (struct gdbarch *gdbarch, |
1190 | const struct language_defn *language, | |
1191 | struct value *function, | |
bc3b79fd TJB |
1192 | int argc, struct value **argv); |
1193 | ||
91f87213 | 1194 | const char *value_internal_function_name (struct value *); |
bc3b79fd | 1195 | |
ba18742c SM |
1196 | /* Build a value wrapping and representing WORKER. The value takes ownership |
1197 | of the xmethod_worker object. */ | |
1198 | ||
1199 | extern struct value *value_from_xmethod (xmethod_worker_up &&worker); | |
e81e7f5e | 1200 | |
2ce1cdbf | 1201 | extern struct type *result_type_of_xmethod (struct value *method, |
6b1747cd | 1202 | gdb::array_view<value *> argv); |
2ce1cdbf DE |
1203 | |
1204 | extern struct value *call_xmethod (struct value *method, | |
6b1747cd | 1205 | gdb::array_view<value *> argv); |
e81e7f5e | 1206 | |
9d1447e0 SDJ |
1207 | /* Destroy the values currently allocated. This is called when GDB is |
1208 | exiting (e.g., on quit_force). */ | |
1209 | extern void finalize_values (); | |
1210 | ||
b49180ac TT |
1211 | /* Convert VALUE to a gdb_mpq. The caller must ensure that VALUE is |
1212 | of floating-point, fixed-point, or integer type. */ | |
1213 | extern gdb_mpq value_to_gdb_mpq (struct value *value); | |
1214 | ||
c5aa993b | 1215 | #endif /* !defined (VALUE_H) */ |