1 /* Error handling during reading and writing of PO files.
2    Copyright (C) 2004, 2006, 2012 Free Software Foundation, Inc.
3    Written by Bruno Haible <bruno@clisp.org>, 2004.
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 3 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, see <https://www.gnu.org/licenses/>.  */
17 
18 #ifndef _PO_ERROR_H
19 #define _PO_ERROR_H
20 
21 #ifndef __attribute__
22 /* This feature is available in gcc versions 2.5 and later.  */
23 # if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 5) || __STRICT_ANSI__
24 #  define __attribute__(Spec) /* empty */
25 # endif
26 /* The __-protected variants of 'format' and 'printf' attributes
27    are accepted by gcc versions 2.6.4 (effectively 2.7) and later.  */
28 # if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 7)
29 #  define __format__ format
30 #  define __printf__ printf
31 # endif
32 #endif
33 
34 #ifdef __cplusplus
35 extern "C" {
36 #endif
37 
38 
39 /* Both functions must work like the GNU error(), error_at_line() functions.
40    In particular,
41      - The functions must not return if the status code is nonzero.
42      - The functions must increment the error_message_count variable declared
43        in error.h.  */
44 
45 extern DLL_VARIABLE
46        void (*po_error) (int status, int errnum,
47                          const char *format, ...)
48 #if (__GNUC__ == 3 && __GNUC_MINOR__ >= 1) || __GNUC__ > 3
49        __attribute__ ((__format__ (__printf__, 3, 4)))
50 #endif
51        ;
52 extern DLL_VARIABLE
53        void (*po_error_at_line) (int status, int errnum,
54                                  const char *filename, unsigned int lineno,
55                                  const char *format, ...)
56 #if (__GNUC__ == 3 && __GNUC_MINOR__ >= 1) || __GNUC__ > 3
57        __attribute__ ((__format__ (__printf__, 5, 6)))
58 #endif
59        ;
60 
61 /* Both functions must work like the xerror.h multiline_warning(),
62    multiline_error() functions.  In particular,
63      - multiline_error must increment the error_message_count variable declared
64        in error.h if prefix != NULL.  */
65 
66 extern DLL_VARIABLE
67        void (*po_multiline_warning) (char *prefix, char *message);
68 extern DLL_VARIABLE
69        void (*po_multiline_error) (char *prefix, char *message);
70 
71 
72 #ifdef __cplusplus
73 }
74 #endif
75 
76 #endif /* _PO_ERROR_H */
77