-Wwrite-strings: The Rest
[external/binutils.git] / gdb / c-lang.h
1 /* C language support definitions for GDB, the GNU debugger.
2
3    Copyright (C) 1992-2017 Free Software Foundation, Inc.
4
5    This file is part of GDB.
6
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
9    the Free Software Foundation; either version 3 of the License, or
10    (at your option) any later version.
11
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.
16
17    You should have received a copy of the GNU General Public License
18    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
19
20
21 #if !defined (C_LANG_H)
22 #define C_LANG_H 1
23
24 struct ui_file;
25 struct language_arch_info;
26 struct type_print_options;
27 struct parser_state;
28
29 #include "value.h"
30 #include "macroexp.h"
31 #include "parser-defs.h"
32 #include "common/enum-flags.h"
33
34
35 /* The various kinds of C string and character.  Note that these
36    values are chosen so that they may be or'd together in certain
37    ways.  */
38 enum c_string_type_values
39   {
40     /* An ordinary string: "value".  */
41     C_STRING = 0,
42     /* A wide string: L"value".  */
43     C_WIDE_STRING = 1,
44     /* A 16-bit Unicode string: u"value".  */
45     C_STRING_16 = 2,
46     /* A 32-bit Unicode string: U"value".  */
47     C_STRING_32 = 3,
48     /* An ordinary char: 'v'.  This can also be or'd with one of the
49        above to form the corresponding CHAR value from a STRING
50        value.  */
51     C_CHAR = 4,
52     /* A wide char: L'v'.  */
53     C_WIDE_CHAR = 5,
54     /* A 16-bit Unicode char: u'v'.  */
55     C_CHAR_16 = 6,
56     /* A 32-bit Unicode char: U'v'.  */
57     C_CHAR_32 = 7
58   };
59
60 DEF_ENUM_FLAGS_TYPE (enum c_string_type_values, c_string_type);
61
62 /* Defined in c-exp.y.  */
63
64 extern int c_parse (struct parser_state *);
65
66 extern void c_yyerror (const char *);
67
68 extern int c_parse_escape (const char **, struct obstack *);
69
70 /* Defined in c-typeprint.c */
71 extern void c_print_type (struct type *, const char *,
72                           struct ui_file *, int, int,
73                           const struct type_print_options *);
74
75 extern void c_print_typedef (struct type *,
76                              struct symbol *,
77                              struct ui_file *);
78
79 extern void c_val_print (struct type *,
80                          int, CORE_ADDR,
81                          struct ui_file *, int,
82                          struct value *,
83                          const struct value_print_options *);
84
85 extern void c_value_print (struct value *, struct ui_file *,
86                            const struct value_print_options *);
87
88 /* These are in c-lang.c: */
89
90 extern struct value *evaluate_subexp_c (struct type *expect_type,
91                                         struct expression *exp,
92                                         int *pos,
93                                         enum noside noside);
94
95 extern void c_printchar (int, struct type *, struct ui_file *);
96
97 extern void c_printstr (struct ui_file * stream,
98                         struct type *elttype,
99                         const gdb_byte *string,
100                         unsigned int length,
101                         const char *user_encoding,
102                         int force_ellipses,
103                         const struct value_print_options *options);
104
105 extern void c_language_arch_info (struct gdbarch *gdbarch,
106                                   struct language_arch_info *lai);
107
108 extern const struct exp_descriptor exp_descriptor_c;
109
110 extern void c_emit_char (int c, struct type *type,
111                          struct ui_file *stream, int quoter);
112
113 extern const struct op_print c_op_print_tab[];
114
115 /* These are in c-typeprint.c: */
116
117 extern void c_type_print_base (struct type *, struct ui_file *,
118                                int, int, const struct type_print_options *);
119
120 /* These are in cp-valprint.c */
121
122 extern void cp_print_class_member (const gdb_byte *, struct type *,
123                                    struct ui_file *, const char *);
124
125 extern void cp_print_value_fields (struct type *, struct type *,
126                                    LONGEST, CORE_ADDR,
127                                    struct ui_file *, int,
128                                    struct value *,
129                                    const struct value_print_options *,
130                                    struct type **, int);
131
132 extern void cp_print_value_fields_rtti (struct type *,
133                                         const gdb_byte *, LONGEST, CORE_ADDR,
134                                         struct ui_file *, int,
135                                         struct value *,
136                                         const struct value_print_options *,
137                                         struct type **, int);
138
139 extern int cp_is_vtbl_ptr_type (struct type *);
140
141 extern int cp_is_vtbl_member (struct type *);
142
143 /* These are in c-valprint.c.  */
144
145 extern int c_textual_element_type (struct type *, char);
146
147 /* Create a new instance of the C compiler and return it.  The new
148    compiler is owned by the caller and must be freed using the destroy
149    method.  This function never returns NULL, but rather throws an
150    exception on failure.  This is suitable for use as the
151    la_get_compile_instance language method.  */
152
153 extern struct compile_instance *c_get_compile_context (void);
154
155 /* This takes the user-supplied text and returns a new bit of code to
156    compile.
157
158    This is used as the la_compute_program language method; see that
159    for a description of the arguments.  */
160
161 extern std::string c_compute_program (struct compile_instance *inst,
162                                       const char *input,
163                                       struct gdbarch *gdbarch,
164                                       const struct block *expr_block,
165                                       CORE_ADDR expr_pc);
166
167 #endif /* !defined (C_LANG_H) */