xref: /netbsd-src/external/gpl3/gdb.old/dist/gdb/mi/mi-out.h (revision ae87de8892f277bece3527c15b186ebcfa188227)
1 /* MI Command Set - MI output generating routines for GDB.
2    Copyright (C) 2000-2020 Free Software Foundation, Inc.
3    Contributed by Cygnus Solutions (a Red Hat company).
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 #ifndef MI_MI_OUT_H
21 #define MI_MI_OUT_H
22 
23 #include <vector>
24 
25 struct ui_out;
26 struct ui_file;
27 
28 
29 class mi_ui_out : public ui_out
30 {
31 public:
32 
33   explicit mi_ui_out (int mi_version);
34   virtual ~mi_ui_out ();
35 
36   /* MI-specific */
37   void rewind ();
38   void put (struct ui_file *stream);
39 
40   /* Return the version number of the current MI.  */
41   int version ();
42 
43   bool can_emit_style_escape () const override
44   {
45     return false;
46   }
47 
48 protected:
49 
50   virtual void do_table_begin (int nbrofcols, int nr_rows, const char *tblid)
51     override;
52   virtual void do_table_body () override;
53   virtual void do_table_header (int width, ui_align align,
54 			     const std::string &col_name,
55 			     const std::string &col_hdr) override;
56   virtual void do_table_end () override;
57 
58   virtual void do_begin (ui_out_type type, const char *id) override;
59   virtual void do_end (ui_out_type type) override;
60   virtual void do_field_signed (int fldno, int width, ui_align align,
61 				const char *fldname, LONGEST value) override;
62   virtual void do_field_unsigned (int fldno, int width, ui_align align,
63 				  const char *fldname, ULONGEST value)
64     override;
65   virtual void do_field_skip (int fldno, int width, ui_align align,
66 			   const char *fldname) override;
67   virtual void do_field_string (int fldno, int width, ui_align align,
68 				const char *fldname, const char *string,
69 				const ui_file_style &style) override;
70   virtual void do_field_fmt (int fldno, int width, ui_align align,
71 			     const char *fldname, const ui_file_style &style,
72 			     const char *format, va_list args)
73     override ATTRIBUTE_PRINTF (7,0);
74   virtual void do_spaces (int numspaces) override;
75   virtual void do_text (const char *string) override;
76   virtual void do_message (const ui_file_style &style,
77 			   const char *format, va_list args) override
78     ATTRIBUTE_PRINTF (3,0);
79   virtual void do_wrap_hint (const char *identstring) override;
80   virtual void do_flush () override;
81   virtual void do_redirect (struct ui_file *outstream) override;
82 
83   virtual bool do_is_mi_like_p () const override
84   { return true; }
85 
86 private:
87 
88   void field_separator ();
89   void open (const char *name, ui_out_type type);
90   void close (ui_out_type type);
91 
92   /* Convenience method that returns the MI out's string stream cast
93      to its appropriate type.  Assumes/asserts that output was not
94      redirected.  */
95   string_file *main_stream ();
96 
97   bool m_suppress_field_separator;
98   bool m_suppress_output;
99   int m_mi_version;
100   std::vector<ui_file *> m_streams;
101 };
102 
103 /* Create an MI ui-out object with MI version MI_VERSION, which should be equal
104    to one of the INTERP_MI* constants (see interps.h).
105 
106    Return nullptr if an invalid version is provided.  */
107 mi_ui_out *mi_out_new (const char *mi_version);
108 
109 int mi_version (ui_out *uiout);
110 void mi_out_put (ui_out *uiout, struct ui_file *stream);
111 void mi_out_rewind (ui_out *uiout);
112 
113 #endif /* MI_MI_OUT_H */
114