gnu/dist/gdb6/gdb/ui-file.h

   1 /* UI_FILE - a generic STDIO like output stream.
   2    Copyright (C) 1999, 2000 Free Software Foundation, Inc.
   3
   4    This file is part of GDB.
   5
   6    This program is free software; you can redistribute it and/or modify
   7    it under the terms of the GNU General Public License as published by
   8    the Free Software Foundation; either version 2 of the License, or
   9    (at your option) any later version.
  10
  11    This program is distributed in the hope that it will be useful,
  12    but WITHOUT ANY WARRANTY; without even the implied warranty of
  13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14    GNU General Public License for more details.
  15
  16    You should have received a copy of the GNU General Public License
  17    along with this program; if not, write to the Free Software
  18    Foundation, Inc., 51 Franklin Street, Fifth Floor,
  19    Boston, MA 02110-1301, USA.  */
  20
  21 #ifndef UI_FILE_H
  22 #define UI_FILE_H
  23
  24 struct ui_file;
  25
  26 /* Create a generic ui_file object with null methods. */
  27
  28 extern struct ui_file *ui_file_new (void);
  29
  30 /* Override methods used by specific implementations of a UI_FILE
  31    object. */
  32
  33 typedef void (ui_file_flush_ftype) (struct ui_file * stream);
  34 extern void set_ui_file_flush (struct ui_file *stream, ui_file_flush_ftype * flush);
  35
  36 /* NOTE: Both fputs and write methods are available. Default
  37    implementations that mapping one onto the other are included. */
  38 typedef void (ui_file_write_ftype) (struct ui_file * stream, const char *buf, long length_buf);
  39 extern void set_ui_file_write (struct ui_file *stream, ui_file_write_ftype *fputs);
  40
  41 typedef void (ui_file_fputs_ftype) (const char *, struct ui_file * stream);
  42 extern void set_ui_file_fputs (struct ui_file *stream, ui_file_fputs_ftype * fputs);
  43
  44 typedef long (ui_file_read_ftype) (struct ui_file * stream, char *buf, long length_buf);
  45 extern void set_ui_file_read (struct ui_file *stream, ui_file_read_ftype *fread);
  46
  47 typedef int (ui_file_isatty_ftype) (struct ui_file * stream);
  48 extern void set_ui_file_isatty (struct ui_file *stream, ui_file_isatty_ftype * isatty);
  49
  50 typedef void (ui_file_rewind_ftype) (struct ui_file * stream);
  51 extern void set_ui_file_rewind (struct ui_file *stream, ui_file_rewind_ftype * rewind);
  52
  53 typedef void (ui_file_put_method_ftype) (void *object, const char *buffer, long length_buffer);
  54 typedef void (ui_file_put_ftype) (struct ui_file *stream, ui_file_put_method_ftype * method, void *context);
  55 extern void set_ui_file_put (struct ui_file *stream, ui_file_put_ftype * put);
  56
  57 typedef void (ui_file_delete_ftype) (struct ui_file * stream);
  58 extern void set_ui_file_data (struct ui_file *stream, void *data, ui_file_delete_ftype * delete);
  59
  60 extern void *ui_file_data (struct ui_file *file);
  61
  62
  63 extern void gdb_flush (struct ui_file *);
  64
  65 extern void ui_file_delete (struct ui_file *stream);
  66
  67 extern void ui_file_rewind (struct ui_file *stream);
  68
  69 extern int ui_file_isatty (struct ui_file *);
  70
  71 extern void ui_file_write (struct ui_file *file, const char *buf, long length_buf);
  72
  73 /* NOTE: copies left to right */
  74 extern void ui_file_put (struct ui_file *src, ui_file_put_method_ftype *write, void *dest);
  75
  76 /* Returns a freshly allocated buffer containing the entire contents
  77    of FILE (as determined by ui_file_put()) with a NUL character
  78    appended.  LENGTH is set to the size of the buffer minus that
  79    appended NUL. */
  80 extern char *ui_file_xstrdup (struct ui_file *file, long *length);
  81
  82
  83
  84 extern long ui_file_read (struct ui_file *file, char *buf, long length_buf);
  85
  86 /* Create/open a memory based file. Can be used as a scratch buffer
  87    for collecting output. */
  88 extern struct ui_file *mem_fileopen (void);
  89
  90
  91
  92 /* Open/create a an STDIO based UI_FILE using the already open FILE. */
  93 extern struct ui_file *stdio_fileopen (FILE *file);
  94
  95 /* Open NAME returning an STDIO based UI_FILE. */
  96 extern struct ui_file *gdb_fopen (char *name, char *mode);
  97
  98 /* Create a file which writes to both ONE and TWO.  CLOSE_ONE
  99    and CLOSE_TWO indicate whether the original files should be
 100    closed when the new file is closed.  */
 101 struct ui_file *tee_file_new (struct ui_file *one,
 102                               int close_one,
 103                               struct ui_file *two,
 104                               int close_two);
 105 #endif