src/message.h

   1 /* message.h
   2  * Function prototypes for message.c
   3  * Copyright (C) 1998-2022 Olly Betts
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 2 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this program; if not, write to the Free Software
  17  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  18  */
  19
  20 #ifndef MESSAGE_H /* only include once */
  21 #define MESSAGE_H
  22
  23 #ifdef __cplusplus
  24 extern "C" {
  25 #endif
  26
  27 #include <stdarg.h>
  28
  29 #include "osdepend.h"
  30 #include "osalloc.h"
  31
  32 #define STDERR stdout
  33
  34 #define CHARSET_BAD        -1
  35 #define CHARSET_USASCII     0
  36 #define CHARSET_ISO_8859_1  1
  37 #define CHARSET_DOSCP850    2
  38 #define CHARSET_UTF8        4
  39 #define CHARSET_WINCP1252   5
  40 #define CHARSET_ISO_8859_15 6
  41 #define CHARSET_ISO_8859_2  8
  42 #define CHARSET_WINCP1250   9
  43
  44 extern int msg_warnings; /* keep track of how many warnings we've given */
  45 extern int msg_errors;   /* and how many (non-fatal) errors */
  46
  47 /* The language code - e.g. "en_GB" */
  48 extern const char *msg_lang;
  49 /* If the language code has a country specific qualification, then this will
  50  * be just the language code.  Otherwise it's NULL.  e.g. "en" */
  51 extern const char *msg_lang2;
  52
  53 void msg_init(char *const *argv);
  54
  55 const char *msg_cfgpth(void);
  56 const char *msg_exepth(void);
  57 const char *msg_appname(void);
  58
  59 /* Return the message string corresponding to number en */
  60 const char *msg(int en);
  61
  62 /* These need to fit within DIAG_SEVERITY_MASK defined in datain.h. */
  63 #define DIAG_INFO       0x00
  64 #define DIAG_WARN       0x01
  65 #define DIAG_ERR        0x02
  66 #define DIAG_FATAL      0x03
  67
  68 void v_report(int severity, const char *fnm, int line, int col, int en, va_list ap);
  69
  70 void diag(int severity, int en, ...);
  71
  72 #define information(...) diag(DIAG_INFO, __VA_ARGS__)
  73 #define warning(...) diag(DIAG_WARN, __VA_ARGS__)
  74 #define error(...) diag(DIAG_ERR, __VA_ARGS__)
  75 #define fatalerror(...) diag(DIAG_FATAL, __VA_ARGS__)
  76
  77 void diag_in_file(int severity, const char *fnm, int line, int en, ...);
  78
  79 #define information_in_file(...) diag_in_file(DIAG_INFO, __VA_ARGS__)
  80 #define warning_in_file(...) diag_in_file(DIAG_WARN, __VA_ARGS__)
  81 #define error_in_file(...) diag_in_file(DIAG_ERR, __VA_ARGS__)
  82 #define fatalerror_in_file(...) diag_in_file(DIAG_FATAL, __VA_ARGS__)
  83
  84 int select_charset(int charset_code);
  85
  86 #ifdef __cplusplus
  87 }
  88 #endif
  89
  90 /* Define MSG_SETUP_PROJ_SEARCH_PATH before including this header to enable the
  91  * hooks to setup proj's search path to be relative to the executable if this
  92  * is a relocatable install.
  93  */
  94 #ifdef MSG_SETUP_PROJ_SEARCH_PATH
  95 /* We only need this on these platforms. */
  96 # if OS_WIN32
  97 #  include <proj.h>
  98 #  define msg_init(ARGV) do {\
  99         (msg_init)(ARGV); \
 100         const char* msg_init_proj_path = msg_cfgpth();\
 101         proj_context_set_search_paths(PJ_DEFAULT_CTX, 1, &msg_init_proj_path);\
 102     } while (0)
 103 # endif
 104 #endif
 105
 106 #endif /* MESSAGE_H */