1 /* Output generating routines for GDB.
3 Copyright (C) 1999-2019 Free Software Foundation, Inc.
5 Contributed by Cygnus Solutions.
6 Written by Fernando Nasser for Cygnus.
8 This file is part of GDB.
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.
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.
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/>. */
24 #include "expression.h" /* For language.h */
35 /* A header of a ui_out_table. */
41 explicit ui_out_hdr (int number, int min_width, ui_align alignment,
42 const std::string &name, const std::string &header)
44 m_min_width (min_width),
45 m_alignment (alignment),
56 int min_width () const
61 ui_align alignment () const
66 const std::string &header () const
71 const std::string &name () const
78 /* The number of the table column this header represents, 1-based. */
81 /* Minimal column width in characters. May or may not be applicable,
82 depending on the actual implementation of ui_out. */
85 /* Alignment of the content in the column. May or may not be applicable,
86 depending on the actual implementation of ui_out. */
89 /* Internal column name, used to internally refer to the column. */
92 /* Printed header text of the column. */
98 /* A level of nesting (either a list or a tuple) in a ui_out output. */
104 explicit ui_out_level (ui_out_type type)
110 ui_out_type type () const
115 int field_count () const
117 return m_field_count;
120 void inc_field_count ()
127 /* The type of this level. */
130 /* Count each field; the first element is for non-list fields. */
134 /* Tables are special. Maintain a separate structure that tracks
135 their state. At present an output can only contain a single table
136 but that restriction might eventually be lifted. */
142 /* States (steps) of a table generation. */
146 /* We are generating the table headers. */
149 /* We are generating the table body. */
153 explicit ui_out_table (int entry_level, int nr_cols, const std::string &id)
154 : m_state (state::HEADERS),
155 m_entry_level (entry_level),
161 /* Start building the body of the table. */
165 /* Add a new header to the table. */
167 void append_header (int width, ui_align alignment,
168 const std::string &col_name, const std::string &col_hdr);
172 /* Extract the format information for the next header and advance
173 the header iterator. Return false if there was no next header. */
175 bool get_next_header (int *colno, int *width, ui_align *alignment,
176 const char **col_hdr);
178 bool query_field (int colno, int *width, int *alignment,
179 const char **col_name) const;
181 state current_state () const;
183 int entry_level () const;
189 /* The level at which each entry of the table is to be found. A row
190 (a tuple) is made up of entries. Consequently ENTRY_LEVEL is one
191 above that of the table. */
194 /* Number of table columns (as specified in the table_begin call). */
197 /* String identifying the table (as specified in the table_begin
201 /* Pointers to the column headers. */
202 std::vector<std::unique_ptr<ui_out_hdr>> m_headers;
204 /* Iterator over the headers vector, used when printing successive fields. */
205 std::vector<std::unique_ptr<ui_out_hdr>>::const_iterator m_headers_iterator;
210 void ui_out_table::start_body ()
212 if (m_state != state::HEADERS)
213 internal_error (__FILE__, __LINE__,
214 _("extra table_body call not allowed; there must be only "
215 "one table_body after a table_begin and before a "
218 /* Check if the number of defined headers matches the number of expected
220 if (m_headers.size () != m_nr_cols)
221 internal_error (__FILE__, __LINE__,
222 _("number of headers differ from number of table "
225 m_state = state::BODY;
226 m_headers_iterator = m_headers.begin ();
231 void ui_out_table::append_header (int width, ui_align alignment,
232 const std::string &col_name,
233 const std::string &col_hdr)
235 if (m_state != state::HEADERS)
236 internal_error (__FILE__, __LINE__,
237 _("table header must be specified after table_begin and "
238 "before table_body."));
240 std::unique_ptr<ui_out_hdr> header (new ui_out_hdr (m_headers.size () + 1,
244 m_headers.push_back (std::move (header));
249 void ui_out_table::start_row ()
251 m_headers_iterator = m_headers.begin ();
256 bool ui_out_table::get_next_header (int *colno, int *width, ui_align *alignment,
257 const char **col_hdr)
259 /* There may be no headers at all or we may have used all columns. */
260 if (m_headers_iterator == m_headers.end ())
263 ui_out_hdr *hdr = m_headers_iterator->get ();
265 *colno = hdr->number ();
266 *width = hdr->min_width ();
267 *alignment = hdr->alignment ();
268 *col_hdr = hdr->header ().c_str ();
270 /* Advance the header pointer to the next entry. */
271 m_headers_iterator++;
278 bool ui_out_table::query_field (int colno, int *width, int *alignment,
279 const char **col_name) const
281 /* Column numbers are 1-based, so convert to 0-based index. */
282 int index = colno - 1;
284 if (index >= 0 && index < m_headers.size ())
286 ui_out_hdr *hdr = m_headers[index].get ();
288 gdb_assert (colno == hdr->number ());
290 *width = hdr->min_width ();
291 *alignment = hdr->alignment ();
292 *col_name = hdr->name ().c_str ();
302 ui_out_table::state ui_out_table::current_state () const
309 int ui_out_table::entry_level () const
311 return m_entry_level;
315 ui_out::level () const
317 return m_levels.size ();
320 /* The current (inner most) level. */
323 ui_out::current_level () const
325 return m_levels.back ().get ();
328 /* Create a new level, of TYPE. */
330 ui_out::push_level (ui_out_type type)
332 std::unique_ptr<ui_out_level> level (new ui_out_level (type));
334 m_levels.push_back (std::move (level));
337 /* Discard the current level. TYPE is the type of the level being
340 ui_out::pop_level (ui_out_type type)
342 /* We had better not underflow the buffer. */
343 gdb_assert (m_levels.size () > 0);
344 gdb_assert (current_level ()->type () == type);
346 m_levels.pop_back ();
349 /* Mark beginning of a table. */
352 ui_out::table_begin (int nr_cols, int nr_rows, const std::string &tblid)
354 if (m_table_up != nullptr)
355 internal_error (__FILE__, __LINE__,
356 _("tables cannot be nested; table_begin found before \
357 previous table_end."));
359 m_table_up.reset (new ui_out_table (level () + 1, nr_cols, tblid));
361 do_table_begin (nr_cols, nr_rows, tblid.c_str ());
365 ui_out::table_header (int width, ui_align alignment,
366 const std::string &col_name, const std::string &col_hdr)
368 if (m_table_up == nullptr)
369 internal_error (__FILE__, __LINE__,
370 _("table_header outside a table is not valid; it must be \
371 after a table_begin and before a table_body."));
373 m_table_up->append_header (width, alignment, col_name, col_hdr);
375 do_table_header (width, alignment, col_name, col_hdr);
379 ui_out::table_body ()
381 if (m_table_up == nullptr)
382 internal_error (__FILE__, __LINE__,
383 _("table_body outside a table is not valid; it must be "
384 "after a table_begin and before a table_end."));
386 m_table_up->start_body ();
394 if (m_table_up == nullptr)
395 internal_error (__FILE__, __LINE__,
396 _("misplaced table_end or missing table_begin."));
400 m_table_up = nullptr;
404 ui_out::begin (ui_out_type type, const char *id)
406 /* Be careful to verify the ``field'' before the new tuple/list is
407 pushed onto the stack. That way the containing list/table/row is
408 verified and not the newly created tuple/list. This verification
409 is needed (at least) for the case where a table row entry
410 contains either a tuple/list. For that case bookkeeping such as
411 updating the column count or advancing to the next heading still
412 needs to be performed. */
418 verify_field (&fldno, &width, &align);
423 /* If the push puts us at the same level as a table row entry, we've
424 got a new table row. Put the header pointer back to the start. */
425 if (m_table_up != nullptr
426 && m_table_up->current_state () == ui_out_table::state::BODY
427 && m_table_up->entry_level () == level ())
428 m_table_up->start_row ();
434 ui_out::end (ui_out_type type)
442 ui_out::field_int (const char *fldname, int value)
448 verify_field (&fldno, &width, &align);
450 do_field_int (fldno, width, align, fldname, value);
454 ui_out::field_fmt_int (int input_width, ui_align input_align,
455 const char *fldname, int value)
461 verify_field (&fldno, &width, &align);
463 do_field_int (fldno, input_width, input_align, fldname, value);
466 /* Documented in ui-out.h. */
469 ui_out::field_core_addr (const char *fldname, struct gdbarch *gdbarch,
472 field_string (fldname, print_core_address (gdbarch, address),
473 ui_out_style_kind::ADDRESS);
477 ui_out::field_stream (const char *fldname, string_file &stream,
478 ui_out_style_kind style)
480 if (!stream.empty ())
481 field_string (fldname, stream.c_str (), style);
483 field_skip (fldname);
487 /* Used to omit a field. */
490 ui_out::field_skip (const char *fldname)
496 verify_field (&fldno, &width, &align);
498 do_field_skip (fldno, width, align, fldname);
502 ui_out::field_string (const char *fldname, const char *string,
503 ui_out_style_kind style)
509 verify_field (&fldno, &width, &align);
511 do_field_string (fldno, width, align, fldname, string, style);
515 ui_out::field_string (const char *fldname, const std::string &string)
517 field_string (fldname, string.c_str ());
522 ui_out::field_fmt (const char *fldname, const char *format, ...)
529 verify_field (&fldno, &width, &align);
531 va_start (args, format);
533 do_field_fmt (fldno, width, align, fldname, format, args);
539 ui_out::spaces (int numspaces)
541 do_spaces (numspaces);
545 ui_out::text (const char *string)
551 ui_out::message (const char *format, ...)
555 va_start (args, format);
556 do_message (format, args);
561 ui_out::wrap_hint (const char *identstring)
563 do_wrap_hint (identstring);
573 ui_out::redirect (ui_file *outstream)
575 do_redirect (outstream);
578 /* Test the flags against the mask given. */
580 ui_out::test_flags (ui_out_flags mask)
582 return m_flags & mask;
586 ui_out::is_mi_like_p () const
588 return do_is_mi_like_p ();
591 /* Verify that the field/tuple/list is correctly positioned. Return
592 the field number and corresponding alignment (if
593 available/applicable). */
596 ui_out::verify_field (int *fldno, int *width, ui_align *align)
598 ui_out_level *current = current_level ();
601 if (m_table_up != nullptr
602 && m_table_up->current_state () != ui_out_table::state::BODY)
604 internal_error (__FILE__, __LINE__,
605 _("table_body missing; table fields must be \
606 specified after table_body and inside a list."));
609 current->inc_field_count ();
611 if (m_table_up != nullptr
612 && m_table_up->current_state () == ui_out_table::state::BODY
613 && m_table_up->entry_level () == level ()
614 && m_table_up->get_next_header (fldno, width, align, &text))
616 if (*fldno != current->field_count ())
617 internal_error (__FILE__, __LINE__,
618 _("ui-out internal error in handling headers."));
624 *fldno = current->field_count ();
628 /* Access table field parameters. */
631 ui_out::query_table_field (int colno, int *width, int *alignment,
632 const char **col_name)
634 if (m_table_up == nullptr)
637 return m_table_up->query_field (colno, width, alignment, col_name);
640 /* The constructor. */
642 ui_out::ui_out (ui_out_flags flags)
645 /* Create the ui-out level #1, the default level. */
646 push_level (ui_out_type_tuple);