pintos-os.org Git - pspp/blob - src/libpspp/message.h

   1 /* PSPP - a program for statistical analysis.
   2    Copyright (C) 1997-9, 2000, 2006, 2010, 2011, 2014 Free Software Foundation, Inc.
   3
   4    This program is free software: you can redistribute it and/or modify
   5    it under the terms of the GNU General Public License as published by
   6    the Free Software Foundation, either version 3 of the License, or
   7    (at your option) any later version.
   8
   9    This program is distributed in the hope that it will be useful,
  10    but WITHOUT ANY WARRANTY; without even the implied warranty of
  11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12    GNU General Public License for more details.
  13
  14    You should have received a copy of the GNU General Public License
  15    along with this program.  If not, see <http://www.gnu.org/licenses/>. */
  16
  17 #ifndef MESSAGE_H
  18 #define MESSAGE_H 1
  19
  20 #include <stdarg.h>
  21 #include <stdbool.h>
  22 #include <stddef.h>
  23 #include "libpspp/compiler.h"
  24
  25 struct string;
  26
  27 /* What kind of message is this? */
  28 enum msg_category
  29   {
  30     MSG_C_GENERAL,              /* General info. */
  31     MSG_C_SYNTAX,               /* Messages that relate to syntax files. */
  32     MSG_C_DATA,                 /* Messages that relate to data files. */
  33     MSG_N_CATEGORIES
  34   };
  35
  36 /* How important a condition is it? */
  37 enum msg_severity
  38   {
  39     MSG_S_ERROR,
  40     MSG_S_WARNING,
  41     MSG_S_NOTE,
  42     MSG_N_SEVERITIES
  43   };
  44
  45 const char *msg_severity_to_string (enum msg_severity);
  46
  47 /* Combination of a category and a severity for convenience. */
  48 enum msg_class
  49   {
  50     ME, MW, MN,                 /* General error/warning/note. */
  51     SE, SW, SN,                 /* Script error/warning/note. */
  52     DE, DW, DN,                 /* Data-file error/note. */
  53     MSG_CLASS_CNT,
  54   };
  55
  56 static inline enum msg_category
  57 msg_class_to_category (enum msg_class class)
  58 {
  59   return class / 3;
  60 }
  61
  62 static inline enum msg_severity
  63 msg_class_to_severity (enum msg_class class)
  64 {
  65   return class % 3;
  66 }
  67
  68 static inline enum msg_class
  69 msg_class_from_category_and_severity (enum msg_category category,
  70                                       enum msg_severity severity)
  71 {
  72   return category * 3 + severity;
  73 }
  74
  75 struct msg_point
  76   {
  77     int line;                   /* 1-based line number, or 0 if none. */
  78     int column;                 /* 1-based column number, or 0 if none. */
  79   };
  80
  81 struct msg_location
  82   {
  83     const char *file_name;      /* Interned file name, or NULL. */
  84     struct msg_point p[2];
  85 #if 0
  86     int first_line;             /* 1-based line number, or 0 if none. */
  87     int last_line;              /* 1-based exclusive last line (0=none). */
  88     int first_column;           /* 1-based first column, or 0 if none. */
  89     int last_column;            /* 1-based exclusive last column (0=none). */
  90 #endif
  91   };
  92
  93 void msg_location_uninit (struct msg_location *);
  94 void msg_location_destroy (struct msg_location *);
  95 struct msg_location *msg_location_dup (const struct msg_location *);
  96
  97 void msg_location_merge (struct msg_location *, const struct msg_location *);
  98
  99 bool msg_location_is_empty (const struct msg_location *);
 100 void msg_location_format (const struct msg_location *, struct string *);
 101
 102 struct msg_stack
 103   {
 104     struct msg_location *location;
 105     char *description;
 106   };
 107
 108 void msg_stack_destroy (struct msg_stack *);
 109 struct msg_stack *msg_stack_dup (const struct msg_stack *);
 110
 111 /* A message. */
 112 struct msg
 113   {
 114     enum msg_category category; /* Message category. */
 115     enum msg_severity severity; /* Message severity. */
 116     struct msg_location *location; /* Code location. */
 117     struct msg_stack **stack;
 118     size_t n_stack;
 119     char *command_name;         /* Name of erroneous command, or NULL.  */
 120     char *text;                 /* Error text. */
 121   };
 122
 123 /* Initialization. */
 124 void msg_set_handler (void (*handler) (const struct msg *, void *lexer),
 125                       void *aux);
 126
 127 /* Working with messages. */
 128 struct msg *msg_dup (const struct msg *);
 129 void msg_destroy(struct msg *);
 130 char *msg_to_string (const struct msg *);
 131
 132 /* Emitting messages. */
 133 void vmsg (enum msg_class, const struct msg_location *,
 134            const char *format, va_list args)
 135      PRINTF_FORMAT (3, 0);
 136 void msg (enum msg_class, const char *format, ...)
 137      PRINTF_FORMAT (2, 3);
 138 void msg_at (enum msg_class, const struct msg_location *,
 139              const char *format, ...)
 140      PRINTF_FORMAT (3, 4);
 141 void msg_emit (struct msg *);
 142
 143 void msg_error (int errnum, const char *format, ...)
 144   PRINTF_FORMAT (2, 3);
 145
 146
 147 /* Enable and disable messages. */
 148 void msg_enable (void);
 149 void msg_disable (void);
 150
 151 /* Error context. */
 152 bool msg_ui_too_many_errors (void);
 153 void msg_ui_reset_counts (void);
 154 bool msg_ui_any_errors (void);
 155 void msg_ui_disable_warnings (bool);
 156
 157
 158 /* Used in panic situations only. */
 159 const char * prepare_diagnostic_information (void);
 160 const char * prepare_fatal_error_message (void);
 161 void request_bug_report (const char *msg);
 162
 163
 164 #endif /* message.h */