1 | /* SPDX-License-Identifier: GPL-2.0-or-later */ |
2 | /* ANSI and traditional C compatibility macros |
3 | Copyright 1991, 1992 Free Software Foundation, Inc. |
4 | This file is part of the GNU C Library. |
5 | |
6 | */ |
7 | |
8 | /* ANSI and traditional C compatibility macros |
9 | |
10 | ANSI C is assumed if __STDC__ is #defined. |
11 | |
12 | Macro ANSI C definition Traditional C definition |
13 | ----- ---- - ---------- ----------- - ---------- |
14 | PTR `void *' `char *' |
15 | LONG_DOUBLE `long double' `double' |
16 | VOLATILE `volatile' `' |
17 | SIGNED `signed' `' |
18 | PTRCONST `void *const' `char *' |
19 | ANSI_PROTOTYPES 1 not defined |
20 | |
21 | CONST is also defined, but is obsolete. Just use const. |
22 | |
23 | DEFUN (name, arglist, args) |
24 | |
25 | Defines function NAME. |
26 | |
27 | ARGLIST lists the arguments, separated by commas and enclosed in |
28 | parentheses. ARGLIST becomes the argument list in traditional C. |
29 | |
30 | ARGS list the arguments with their types. It becomes a prototype in |
31 | ANSI C, and the type declarations in traditional C. Arguments should |
32 | be separated with `AND'. For functions with a variable number of |
33 | arguments, the last thing listed should be `DOTS'. |
34 | |
35 | DEFUN_VOID (name) |
36 | |
37 | Defines a function NAME, which takes no arguments. |
38 | |
39 | obsolete -- EXFUN (name, (prototype)) -- obsolete. |
40 | |
41 | Replaced by PARAMS. Do not use; will disappear someday soon. |
42 | Was used in external function declarations. |
43 | In ANSI C it is `NAME PROTOTYPE' (so PROTOTYPE should be enclosed in |
44 | parentheses). In traditional C it is `NAME()'. |
45 | For a function that takes no arguments, PROTOTYPE should be `(void)'. |
46 | |
47 | PARAMS ((args)) |
48 | |
49 | We could use the EXFUN macro to handle prototype declarations, but |
50 | the name is misleading and the result is ugly. So we just define a |
51 | simple macro to handle the parameter lists, as in: |
52 | |
53 | static int foo PARAMS ((int, char)); |
54 | |
55 | This produces: `static int foo();' or `static int foo (int, char);' |
56 | |
57 | EXFUN would have done it like this: |
58 | |
59 | static int EXFUN (foo, (int, char)); |
60 | |
61 | but the function is not external...and it's hard to visually parse |
62 | the function name out of the mess. EXFUN should be considered |
63 | obsolete; new code should be written to use PARAMS. |
64 | |
65 | For example: |
66 | extern int printf PARAMS ((CONST char *format DOTS)); |
67 | int DEFUN(fprintf, (stream, format), |
68 | FILE *stream AND CONST char *format DOTS) { ... } |
69 | void DEFUN_VOID(abort) { ... } |
70 | */ |
71 | |
72 | #ifndef _ANSIDECL_H |
73 | |
74 | #define _ANSIDECL_H 1 |
75 | |
76 | |
77 | /* Every source file includes this file, |
78 | so they will all get the switch for lint. */ |
79 | /* LINTLIBRARY */ |
80 | |
81 | |
82 | #if defined (__STDC__) || defined (_AIX) || (defined (__mips) && defined (_SYSTYPE_SVR4)) || defined(WIN32) |
83 | /* All known AIX compilers implement these things (but don't always |
84 | define __STDC__). The RISC/OS MIPS compiler defines these things |
85 | in SVR4 mode, but does not define __STDC__. */ |
86 | |
87 | #define PTR void * |
88 | #define PTRCONST void *CONST |
89 | #define LONG_DOUBLE long double |
90 | |
91 | #define AND , |
92 | #define NOARGS void |
93 | #define CONST const |
94 | #define VOLATILE volatile |
95 | #define SIGNED signed |
96 | #define DOTS , ... |
97 | |
98 | #define EXFUN(name, proto) name proto |
99 | #define DEFUN(name, arglist, args) name(args) |
100 | #define DEFUN_VOID(name) name(void) |
101 | |
102 | #define PROTO(type, name, arglist) type name arglist |
103 | #define PARAMS(paramlist) paramlist |
104 | #define ANSI_PROTOTYPES 1 |
105 | |
106 | #else /* Not ANSI C. */ |
107 | |
108 | #define PTR char * |
109 | #define PTRCONST PTR |
110 | #define LONG_DOUBLE double |
111 | |
112 | #define AND ; |
113 | #define NOARGS |
114 | #define CONST |
115 | #ifndef const /* some systems define it in header files for non-ansi mode */ |
116 | #define const |
117 | #endif |
118 | #define VOLATILE |
119 | #define SIGNED |
120 | #define DOTS |
121 | |
122 | #define EXFUN(name, proto) name() |
123 | #define DEFUN(name, arglist, args) name arglist args; |
124 | #define DEFUN_VOID(name) name() |
125 | #define PROTO(type, name, arglist) type name () |
126 | #define PARAMS(paramlist) () |
127 | |
128 | #endif /* ANSI C. */ |
129 | |
130 | #endif /* ansidecl.h */ |
131 | |