* write.c (relax_segment <rs_space>): Calculate growth using
[deliverable/binutils-gdb.git] / gdb / ui-out.h
index d8db5885457d546569bcb2baa07c2b3e48b4470b..9fe0be7ae7e1bb51d9d3415575c23afc4d0849f0 100644 (file)
@@ -1,5 +1,5 @@
 /* Output generating routines for GDB.
-   Copyright 1999, 2000 Free Software Foundation, Inc.
+   Copyright 1999, 2000, 2001 Free Software Foundation, Inc.
    Contributed by Cygnus Solutions.
    Written by Fernando Nasser for Cygnus.
 
 
 /* The ui_out structure */
 
-#if __STDC__
 struct ui_out;
 struct ui_out_data;
-#endif
 
 
 /* the current ui_out */
@@ -67,88 +65,120 @@ struct ui_stream
 
 /* Prototypes for ui-out API. */
 
-extern void ui_out_table_begin PARAMS ((struct ui_out * uiout, int nbrofcols,
-                                       char *tblid));
+/* A result is a recursive data structure consisting of lists and
+   tuples. */
+
+enum ui_out_type
+  {
+    ui_out_type_tuple,
+    ui_out_type_list
+  };
+
+extern void ui_out_begin (struct ui_out *uiout,
+                         enum ui_out_type level_type,
+                         const char *id);
+
+extern void ui_out_end (struct ui_out *uiout, enum ui_out_type type);
+
+extern struct cleanup *ui_out_begin_cleanup_end (struct ui_out *uiout,
+                                                enum ui_out_type level_type,
+                                                const char *id);
+
+/* A table can be considered a special tuple/list combination with
+   the implied structure: ``table = { hdr = { header, ... } , body = [ {
+   field, ... }, ... ] }'' */
+
+extern void ui_out_table_begin (struct ui_out *uiout, int nbrofcols,
+                               char *tblid);
+
+extern void ui_out_table_header (struct ui_out *uiout, int width,
+                                enum ui_align align, char *colhdr);
+
+extern void ui_out_table_body (struct ui_out *uiout);
+
+extern void ui_out_table_end (struct ui_out *uiout);
+
+/* Compatibility wrappers, new code should use ui_out_begin() and
+   ui_out_end(). */
+
+extern void ui_out_list_begin (struct ui_out *uiout);
 
-extern void ui_out_table_header PARAMS ((struct ui_out * uiout, int width,
-                                        enum ui_align align, char *colhdr));
+extern void ui_out_list_end (struct ui_out *uiout);
 
-extern void ui_out_table_body PARAMS ((struct ui_out * uiout));
+extern struct cleanup *make_cleanup_ui_out_list_begin_end (struct ui_out *uiout);
 
-extern void ui_out_table_end PARAMS ((struct ui_out * uiout));
+extern void ui_out_tuple_begin (struct ui_out *uiout, const char *id);
 
-extern void ui_out_list_begin PARAMS ((struct ui_out * uiout, char *lstid));
+extern void ui_out_tuple_end (struct ui_out *uiout);
 
-extern void ui_out_list_end PARAMS ((struct ui_out * uiout));
+extern struct cleanup *make_cleanup_ui_out_tuple_begin_end (struct ui_out *uiout,
+                                                           const char *id);
 
-extern void ui_out_field_int PARAMS ((struct ui_out * uiout, char *fldname,
-                                     int value));
+extern void ui_out_field_int (struct ui_out *uiout, char *fldname, int value);
 
-extern void ui_out_field_core_addr PARAMS ((struct ui_out * uiout, char *fldname,
-                                           CORE_ADDR address));
+extern void ui_out_field_core_addr (struct ui_out *uiout, char *fldname,
+                                   CORE_ADDR address);
 
 extern void ui_out_field_string (struct ui_out * uiout, char *fldname,
                                 const char *string);
 
-extern void ui_out_field_stream PARAMS ((struct ui_out * uiout, char *fldname,
-                                        struct ui_stream * buf));
+extern void ui_out_field_stream (struct ui_out *uiout, char *fldname,
+                                struct ui_stream *buf);
 
-extern void ui_out_field_fmt PARAMS ((struct ui_out * uiout, char *fldname,
-                                     char *format,...));
+extern void ui_out_field_fmt (struct ui_out *uiout, char *fldname,
+                             char *format, ...);
 
-extern void ui_out_field_skip PARAMS ((struct ui_out * uiout, char *fldname));
+extern void ui_out_field_skip (struct ui_out *uiout, char *fldname);
 
-extern void ui_out_spaces PARAMS ((struct ui_out * uiout, int numspaces));
+extern void ui_out_spaces (struct ui_out *uiout, int numspaces);
 
-extern void ui_out_text PARAMS ((struct ui_out * uiout, char *string));
+extern void ui_out_text (struct ui_out *uiout, char *string);
 
-extern void ui_out_message PARAMS ((struct ui_out * uiout, int verbosity,
-                                   char *format,...));
+extern void ui_out_message (struct ui_out *uiout, int verbosity,
+                           char *format, ...);
 
-extern struct ui_stream *ui_out_stream_new PARAMS ((struct ui_out * uiout));
+extern struct ui_stream *ui_out_stream_new (struct ui_out *uiout);
 
-extern void ui_out_stream_delete PARAMS ((struct ui_stream * buf));
+extern void ui_out_stream_delete (struct ui_stream *buf);
 
 struct cleanup *make_cleanup_ui_out_stream_delete (struct ui_stream *buf);
 
-extern void ui_out_wrap_hint PARAMS ((struct ui_out * uiout, char *identstring));
+extern void ui_out_wrap_hint (struct ui_out *uiout, char *identstring);
 
-extern void ui_out_flush PARAMS ((struct ui_out * uiout));
+extern void ui_out_flush (struct ui_out *uiout);
 
-extern void ui_out_get_field_separator PARAMS ((struct ui_out * uiout));
+extern void ui_out_get_field_separator (struct ui_out *uiout);
 
-extern int ui_out_set_flags PARAMS ((struct ui_out * uiout, int mask));
+extern int ui_out_set_flags (struct ui_out *uiout, int mask);
 
-extern int ui_out_clear_flags PARAMS ((struct ui_out * uiout, int mask));
+extern int ui_out_clear_flags (struct ui_out *uiout, int mask);
 
-extern int ui_out_get_verblvl PARAMS ((struct ui_out * uiout));
+extern int ui_out_get_verblvl (struct ui_out *uiout);
 
 extern int ui_out_test_flags (struct ui_out *uiout, int mask);
 
 #if 0
-extern void ui_out_result_begin PARAMS ((struct ui_out * uiout, char *class));
+extern void ui_out_result_begin (struct ui_out *uiout, char *class);
 
-extern void ui_out_result_end PARAMS ((struct ui_out * uiout));
+extern void ui_out_result_end (struct ui_out *uiout);
 
-extern void ui_out_info_begin PARAMS ((struct ui_out * uiout, char *class));
+extern void ui_out_info_begin (struct ui_out *uiout, char *class);
 
-extern void ui_out_info_end PARAMS ((struct ui_out * uiout));
+extern void ui_out_info_end (struct ui_out *uiout);
 
-extern void ui_out_notify_begin PARAMS ((struct ui_out * uiout, char *class));
+extern void ui_out_notify_begin (struct ui_out *uiout, char *class);
 
-extern void ui_out_notify_end PARAMS ((struct ui_out * uiout));
+extern void ui_out_notify_end (struct ui_out *uiout);
 
-extern void ui_out_error_begin PARAMS ((struct ui_out * uiout, char *class));
+extern void ui_out_error_begin (struct ui_out *uiout, char *class);
 
-extern void ui_out_error_end PARAMS ((struct ui_out * uiout));
+extern void ui_out_error_end (struct ui_out *uiout);
 #endif
 
 #if 0
-extern void gdb_error PARAMS ((struct ui_out * uiout, int severity,
-                              char *format,...));
+extern void gdb_error (struct ui_out *uiout, int severity, char *format, ...);
 
-extern void gdb_query PARAMS ((struct ui_out * uiout,
-                              int qflags, char *qprompt));
+extern void gdb_query (struct ui_out *uiout, int qflags, char *qprompt);
 #endif
 
 /* From here on we have things that are only needed by implementation
@@ -165,9 +195,14 @@ typedef void (table_body_ftype) (struct ui_out * uiout);
 typedef void (table_end_ftype) (struct ui_out * uiout);
 typedef void (table_header_ftype) (struct ui_out * uiout, int width,
                                   enum ui_align align, char *colhdr);
-typedef void (list_begin_ftype) (struct ui_out * uiout,
-                                int list_flag, char *lstid);
-typedef void (list_end_ftype) (struct ui_out * uiout, int list_flag);
+/* Note: level 0 is the top-level so LEVEL is always greater than
+   zero. */
+typedef void (ui_out_begin_ftype) (struct ui_out *uiout,
+                                  enum ui_out_type type,
+                                  int level, const char *id);
+typedef void (ui_out_end_ftype) (struct ui_out *uiout,
+                                enum ui_out_type type,
+                                int level);
 typedef void (field_int_ftype) (struct ui_out * uiout, int fldno, int width,
                             enum ui_align align, char *fldname, int value);
 typedef void (field_skip_ftype) (struct ui_out * uiout, int fldno, int width,
@@ -196,8 +231,8 @@ struct ui_out_impl
     table_body_ftype *table_body;
     table_end_ftype *table_end;
     table_header_ftype *table_header;
-    list_begin_ftype *list_begin;
-    list_end_ftype *list_end;
+    ui_out_begin_ftype *begin;
+    ui_out_end_ftype *end;
     field_int_ftype *field_int;
     field_skip_ftype *field_skip;
     field_string_ftype *field_string;
This page took 0.026676 seconds and 4 git commands to generate.