Commit | Line | Data |
---|---|---|
8b93c638 | 1 | /* GDB variable objects API. |
9b254dd1 DJ |
2 | Copyright (C) 1999, 2000, 2001, 2005, 2007, 2008 |
3 | Free Software Foundation, Inc. | |
8b93c638 JM |
4 | |
5 | This program is free software; you can redistribute it and/or modify | |
6 | it under the terms of the GNU General Public License as published by | |
a9762ec7 | 7 | the Free Software Foundation; either version 3 of the License, or |
8b93c638 JM |
8 | (at your option) any later version. |
9 | ||
10 | This program is distributed in the hope that it will be useful, | |
11 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
13 | GNU General Public License for more details. | |
14 | ||
15 | You should have received a copy of the GNU General Public License | |
a9762ec7 | 16 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
8b93c638 JM |
17 | |
18 | #ifndef VAROBJ_H | |
19 | #define VAROBJ_H 1 | |
20 | ||
21 | #include "symtab.h" | |
22 | #include "gdbtypes.h" | |
d56d46f5 | 23 | #include "vec.h" |
8b93c638 JM |
24 | |
25 | /* Enumeration for the format types */ | |
26 | enum varobj_display_formats | |
27 | { | |
28 | FORMAT_NATURAL, /* What gdb actually calls 'natural' */ | |
29 | FORMAT_BINARY, /* Binary display */ | |
30 | FORMAT_DECIMAL, /* Decimal display */ | |
31 | FORMAT_HEXADECIMAL, /* Hex display */ | |
32 | FORMAT_OCTAL /* Octal display */ | |
33 | }; | |
34 | ||
73a93a32 JI |
35 | enum varobj_type |
36 | { | |
37 | USE_SPECIFIED_FRAME, /* Use the frame passed to varobj_create */ | |
38 | USE_CURRENT_FRAME, /* Use the current frame */ | |
39 | USE_SELECTED_FRAME /* Always reevaluate in selected frame */ | |
40 | }; | |
8756216b | 41 | |
f7f9ae2c VP |
42 | /* Enumerator describing if a variable object is in scope. */ |
43 | enum varobj_scope_status | |
8756216b | 44 | { |
f7f9ae2c VP |
45 | VAROBJ_IN_SCOPE = 0, /* Varobj is scope, value available. */ |
46 | VAROBJ_NOT_IN_SCOPE = 1, /* Varobj is not in scope, value not available, | |
47 | but varobj can become in scope later. */ | |
48 | VAROBJ_INVALID = 2, /* Varobj no longer has any value, and never | |
49 | will. */ | |
8756216b DP |
50 | }; |
51 | ||
8b93c638 JM |
52 | /* String representations of gdb's format codes (defined in varobj.c) */ |
53 | extern char *varobj_format_string[]; | |
54 | ||
55 | /* Languages supported by this variable objects system. */ | |
56 | enum varobj_languages | |
57 | { | |
58 | vlang_unknown = 0, vlang_c, vlang_cplus, vlang_java, vlang_end | |
59 | }; | |
60 | ||
61 | /* String representations of gdb's known languages (defined in varobj.c) */ | |
62 | extern char *varobj_language_string[]; | |
63 | ||
64 | /* Struct thar describes a variable object instance */ | |
65 | struct varobj; | |
66 | ||
d56d46f5 VP |
67 | typedef struct varobj *varobj_p; |
68 | DEF_VEC_P (varobj_p); | |
69 | ||
f7f9ae2c VP |
70 | typedef struct varobj_update_result_t |
71 | { | |
72 | struct varobj *varobj; | |
73 | int type_changed; | |
74 | int changed; | |
75 | enum varobj_scope_status status; | |
76 | } varobj_update_result; | |
77 | ||
78 | DEF_VEC_O (varobj_update_result); | |
79 | ||
8b93c638 JM |
80 | /* API functions */ |
81 | ||
82 | extern struct varobj *varobj_create (char *objname, | |
73a93a32 JI |
83 | char *expression, CORE_ADDR frame, |
84 | enum varobj_type type); | |
8b93c638 JM |
85 | |
86 | extern char *varobj_gen_name (void); | |
87 | ||
88 | extern struct varobj *varobj_get_handle (char *name); | |
89 | ||
90 | extern char *varobj_get_objname (struct varobj *var); | |
91 | ||
92 | extern char *varobj_get_expression (struct varobj *var); | |
93 | ||
94 | extern int varobj_delete (struct varobj *var, char ***dellist, | |
95 | int only_children); | |
96 | ||
97 | extern enum varobj_display_formats varobj_set_display_format ( | |
98 | struct varobj *var, | |
99 | enum varobj_display_formats format); | |
100 | ||
101 | extern enum varobj_display_formats varobj_get_display_format ( | |
102 | struct varobj *var); | |
103 | ||
c5b48eac VP |
104 | extern int varobj_get_thread_id (struct varobj *var); |
105 | ||
25d5ea92 VP |
106 | extern void varobj_set_frozen (struct varobj *var, int frozen); |
107 | ||
108 | extern int varobj_get_frozen (struct varobj *var); | |
109 | ||
8b93c638 JM |
110 | extern int varobj_get_num_children (struct varobj *var); |
111 | ||
d56d46f5 VP |
112 | /* Return the list of children of VAR. The returned vector |
113 | should not be modified in any way. */ | |
114 | extern VEC (varobj_p)* varobj_list_children (struct varobj *var); | |
8b93c638 JM |
115 | |
116 | extern char *varobj_get_type (struct varobj *var); | |
117 | ||
1ecb4ee0 DJ |
118 | extern struct type *varobj_get_gdb_type (struct varobj *var); |
119 | ||
02142340 VP |
120 | extern char *varobj_get_path_expr (struct varobj *var); |
121 | ||
8b93c638 JM |
122 | extern enum varobj_languages varobj_get_language (struct varobj *var); |
123 | ||
124 | extern int varobj_get_attributes (struct varobj *var); | |
125 | ||
de051565 MK |
126 | extern char *varobj_get_formatted_value (struct varobj *var, |
127 | enum varobj_display_formats format); | |
128 | ||
8b93c638 JM |
129 | extern char *varobj_get_value (struct varobj *var); |
130 | ||
131 | extern int varobj_set_value (struct varobj *var, char *expression); | |
132 | ||
133 | extern int varobj_list (struct varobj ***rootlist); | |
134 | ||
f7f9ae2c VP |
135 | extern VEC(varobj_update_result) *varobj_update (struct varobj **varp, |
136 | int explicit); | |
8b93c638 | 137 | |
8756216b DP |
138 | extern void varobj_invalidate (void); |
139 | ||
c203027e NR |
140 | extern int varobj_editable_p (struct varobj *var); |
141 | ||
5a413362 VP |
142 | extern int varobj_floating_p (struct varobj *var); |
143 | ||
8b93c638 | 144 | #endif /* VAROBJ_H */ |