gdb/cli-out.c

   1 /* Output generating routines for GDB CLI.
   2
   3    Copyright (C) 1999-2019 Free Software Foundation, Inc.
   4
   5    Contributed by Cygnus Solutions.
   6    Written by Fernando Nasser for Cygnus.
   7
   8    This file is part of GDB.
   9
  10    This program is free software; you can redistribute it and/or modify
  11    it under the terms of the GNU General Public License as published by
  12    the Free Software Foundation; either version 3 of the License, or
  13    (at your option) any later version.
  14
  15    This program is distributed in the hope that it will be useful,
  16    but WITHOUT ANY WARRANTY; without even the implied warranty of
  17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18    GNU General Public License for more details.
  19
  20    You should have received a copy of the GNU General Public License
  21    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  22
  23 #include "defs.h"
  24 #include "ui-out.h"
  25 #include "cli-out.h"
  26 #include "completer.h"
  27 #include "readline/readline.h"
  28 #include "cli/cli-style.h"
  29
  30 /* These are the CLI output functions */
  31
  32 /* Mark beginning of a table */
  33
  34 void
  35 cli_ui_out::do_table_begin (int nbrofcols, int nr_rows, const char *tblid)
  36 {
  37   if (nr_rows == 0)
  38     m_suppress_output = true;
  39   else
  40     /* Only the table suppresses the output and, fortunately, a table
  41        is not a recursive data structure.  */
  42     gdb_assert (!m_suppress_output);
  43 }
  44
  45 /* Mark beginning of a table body */
  46
  47 void
  48 cli_ui_out::do_table_body ()
  49 {
  50   if (m_suppress_output)
  51     return;
  52
  53   /* first, close the table header line */
  54   text ("\n");
  55 }
  56
  57 /* Mark end of a table */
  58
  59 void
  60 cli_ui_out::do_table_end ()
  61 {
  62   m_suppress_output = false;
  63 }
  64
  65 /* Specify table header */
  66
  67 void
  68 cli_ui_out::do_table_header (int width, ui_align alignment,
  69                              const std::string &col_name,
  70                              const std::string &col_hdr)
  71 {
  72   if (m_suppress_output)
  73     return;
  74
  75   do_field_string (0, width, alignment, 0, col_hdr.c_str (),
  76                    ui_out_style_kind::DEFAULT);
  77 }
  78
  79 /* Mark beginning of a list */
  80
  81 void
  82 cli_ui_out::do_begin (ui_out_type type, const char *id)
  83 {
  84 }
  85
  86 /* Mark end of a list */
  87
  88 void
  89 cli_ui_out::do_end (ui_out_type type)
  90 {
  91 }
  92
  93 /* output an int field */
  94
  95 void
  96 cli_ui_out::do_field_signed (int fldno, int width, ui_align alignment,
  97                              const char *fldname, LONGEST value)
  98 {
  99   if (m_suppress_output)
 100     return;
 101
 102   do_field_string (fldno, width, alignment, fldname, plongest (value),
 103                    ui_out_style_kind::DEFAULT);
 104 }
 105
 106 /* output an unsigned field */
 107
 108 void
 109 cli_ui_out::do_field_unsigned (int fldno, int width, ui_align alignment,
 110                                const char *fldname, ULONGEST value)
 111 {
 112   if (m_suppress_output)
 113     return;
 114
 115   do_field_string (fldno, width, alignment, fldname, pulongest (value),
 116                    ui_out_style_kind::DEFAULT);
 117 }
 118
 119 /* used to omit a field */
 120
 121 void
 122 cli_ui_out::do_field_skip (int fldno, int width, ui_align alignment,
 123                            const char *fldname)
 124 {
 125   if (m_suppress_output)
 126     return;
 127
 128   do_field_string (fldno, width, alignment, fldname, "",
 129                    ui_out_style_kind::DEFAULT);
 130 }
 131
 132 /* other specific cli_field_* end up here so alignment and field
 133    separators are both handled by cli_field_string */
 134
 135 void
 136 cli_ui_out::do_field_string (int fldno, int width, ui_align align,
 137                              const char *fldname, const char *string,
 138                              ui_out_style_kind style)
 139 {
 140   int before = 0;
 141   int after = 0;
 142
 143   if (m_suppress_output)
 144     return;
 145
 146   if ((align != ui_noalign) && string)
 147     {
 148       before = width - strlen (string);
 149       if (before <= 0)
 150         before = 0;
 151       else
 152         {
 153           if (align == ui_right)
 154             after = 0;
 155           else if (align == ui_left)
 156             {
 157               after = before;
 158               before = 0;
 159             }
 160           else
 161             /* ui_center */
 162             {
 163               after = before / 2;
 164               before -= after;
 165             }
 166         }
 167     }
 168
 169   if (before)
 170     spaces (before);
 171
 172   if (string)
 173     {
 174       ui_file_style fstyle;
 175       switch (style)
 176         {
 177         case ui_out_style_kind::DEFAULT:
 178           /* Nothing.  */
 179           break;
 180         case ui_out_style_kind::FILE:
 181           /* Nothing.  */
 182           fstyle = file_name_style.style ();
 183           break;
 184         case ui_out_style_kind::FUNCTION:
 185           fstyle = function_name_style.style ();
 186           break;
 187         case ui_out_style_kind::VARIABLE:
 188           fstyle = variable_name_style.style ();
 189           break;
 190         case ui_out_style_kind::ADDRESS:
 191           fstyle = address_style.style ();
 192           break;
 193         default:
 194           gdb_assert_not_reached ("missing case");
 195         }
 196       fputs_styled (string, fstyle, m_streams.back ());
 197     }
 198
 199   if (after)
 200     spaces (after);
 201
 202   if (align != ui_noalign)
 203     field_separator ();
 204 }
 205
 206 /* Output field containing ARGS using printf formatting in FORMAT.  */
 207
 208 void
 209 cli_ui_out::do_field_fmt (int fldno, int width, ui_align align,
 210                           const char *fldname, const char *format,
 211                           va_list args)
 212 {
 213   if (m_suppress_output)
 214     return;
 215
 216   std::string str = string_vprintf (format, args);
 217
 218   do_field_string (fldno, width, align, fldname, str.c_str (),
 219                    ui_out_style_kind::DEFAULT);
 220 }
 221
 222 void
 223 cli_ui_out::do_spaces (int numspaces)
 224 {
 225   if (m_suppress_output)
 226     return;
 227
 228   print_spaces_filtered (numspaces, m_streams.back ());
 229 }
 230
 231 void
 232 cli_ui_out::do_text (const char *string)
 233 {
 234   if (m_suppress_output)
 235     return;
 236
 237   fputs_filtered (string, m_streams.back ());
 238 }
 239
 240 void
 241 cli_ui_out::do_message (const char *format, va_list args)
 242 {
 243   if (m_suppress_output)
 244     return;
 245
 246   vfprintf_unfiltered (m_streams.back (), format, args);
 247 }
 248
 249 void
 250 cli_ui_out::do_wrap_hint (const char *identstring)
 251 {
 252   if (m_suppress_output)
 253     return;
 254
 255   wrap_here (identstring);
 256 }
 257
 258 void
 259 cli_ui_out::do_flush ()
 260 {
 261   gdb_flush (m_streams.back ());
 262 }
 263
 264 /* OUTSTREAM as non-NULL will push OUTSTREAM on the stack of output streams
 265    and make it therefore active.  OUTSTREAM as NULL will pop the last pushed
 266    output stream; it is an internal error if it does not exist.  */
 267
 268 void
 269 cli_ui_out::do_redirect (ui_file *outstream)
 270 {
 271   if (outstream != NULL)
 272     m_streams.push_back (outstream);
 273   else
 274     m_streams.pop_back ();
 275 }
 276
 277 /* local functions */
 278
 279 void
 280 cli_ui_out::field_separator ()
 281 {
 282   fputc_filtered (' ', m_streams.back ());
 283 }
 284
 285 /* Constructor for cli_ui_out.  */
 286
 287 cli_ui_out::cli_ui_out (ui_file *stream, ui_out_flags flags)
 288 : ui_out (flags),
 289   m_suppress_output (false)
 290 {
 291   gdb_assert (stream != NULL);
 292
 293   m_streams.push_back (stream);
 294 }
 295
 296 cli_ui_out::~cli_ui_out ()
 297 {
 298 }
 299
 300 /* Initialize private members at startup.  */
 301
 302 cli_ui_out *
 303 cli_out_new (struct ui_file *stream)
 304 {
 305   return new cli_ui_out (stream, ui_source_list);
 306 }
 307
 308 ui_file *
 309 cli_ui_out::set_stream (struct ui_file *stream)
 310 {
 311   ui_file *old;
 312
 313   old = m_streams.back ();
 314   m_streams.back () = stream;
 315
 316   return old;
 317 }
 318
 319 bool
 320 cli_ui_out::can_emit_style_escape () const
 321 {
 322   return m_streams.back ()->can_emit_style_escape ();
 323 }
 324
 325 /* CLI interface to display tab-completion matches.  */
 326
 327 /* CLI version of displayer.crlf.  */
 328
 329 static void
 330 cli_mld_crlf (const struct match_list_displayer *displayer)
 331 {
 332   rl_crlf ();
 333 }
 334
 335 /* CLI version of displayer.putch.  */
 336
 337 static void
 338 cli_mld_putch (const struct match_list_displayer *displayer, int ch)
 339 {
 340   putc (ch, rl_outstream);
 341 }
 342
 343 /* CLI version of displayer.puts.  */
 344
 345 static void
 346 cli_mld_puts (const struct match_list_displayer *displayer, const char *s)
 347 {
 348   fputs (s, rl_outstream);
 349 }
 350
 351 /* CLI version of displayer.flush.  */
 352
 353 static void
 354 cli_mld_flush (const struct match_list_displayer *displayer)
 355 {
 356   fflush (rl_outstream);
 357 }
 358
 359 EXTERN_C void _rl_erase_entire_line (void);
 360
 361 /* CLI version of displayer.erase_entire_line.  */
 362
 363 static void
 364 cli_mld_erase_entire_line (const struct match_list_displayer *displayer)
 365 {
 366   _rl_erase_entire_line ();
 367 }
 368
 369 /* CLI version of displayer.beep.  */
 370
 371 static void
 372 cli_mld_beep (const struct match_list_displayer *displayer)
 373 {
 374   rl_ding ();
 375 }
 376
 377 /* CLI version of displayer.read_key.  */
 378
 379 static int
 380 cli_mld_read_key (const struct match_list_displayer *displayer)
 381 {
 382   return rl_read_key ();
 383 }
 384
 385 /* CLI version of rl_completion_display_matches_hook.
 386    See gdb_display_match_list for a description of the arguments.  */
 387
 388 void
 389 cli_display_match_list (char **matches, int len, int max)
 390 {
 391   struct match_list_displayer displayer;
 392
 393   rl_get_screen_size (&displayer.height, &displayer.width);
 394   displayer.crlf = cli_mld_crlf;
 395   displayer.putch = cli_mld_putch;
 396   displayer.puts = cli_mld_puts;
 397   displayer.flush = cli_mld_flush;
 398   displayer.erase_entire_line = cli_mld_erase_entire_line;
 399   displayer.beep = cli_mld_beep;
 400   displayer.read_key = cli_mld_read_key;
 401
 402   gdb_display_match_list (matches, len, max, &displayer);
 403   rl_forced_update_display ();
 404 }