forked from Qortal/Brooklyn
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
130 lines
3.7 KiB
130 lines
3.7 KiB
/* SPDX-License-Identifier: GPL-2.0-or-later */ |
|
/* ANSI and traditional C compatibility macros |
|
Copyright 1991, 1992 Free Software Foundation, Inc. |
|
This file is part of the GNU C Library. |
|
|
|
*/ |
|
|
|
/* ANSI and traditional C compatibility macros |
|
|
|
ANSI C is assumed if __STDC__ is #defined. |
|
|
|
Macro ANSI C definition Traditional C definition |
|
----- ---- - ---------- ----------- - ---------- |
|
PTR `void *' `char *' |
|
LONG_DOUBLE `long double' `double' |
|
VOLATILE `volatile' `' |
|
SIGNED `signed' `' |
|
PTRCONST `void *const' `char *' |
|
ANSI_PROTOTYPES 1 not defined |
|
|
|
CONST is also defined, but is obsolete. Just use const. |
|
|
|
DEFUN (name, arglist, args) |
|
|
|
Defines function NAME. |
|
|
|
ARGLIST lists the arguments, separated by commas and enclosed in |
|
parentheses. ARGLIST becomes the argument list in traditional C. |
|
|
|
ARGS list the arguments with their types. It becomes a prototype in |
|
ANSI C, and the type declarations in traditional C. Arguments should |
|
be separated with `AND'. For functions with a variable number of |
|
arguments, the last thing listed should be `DOTS'. |
|
|
|
DEFUN_VOID (name) |
|
|
|
Defines a function NAME, which takes no arguments. |
|
|
|
obsolete -- EXFUN (name, (prototype)) -- obsolete. |
|
|
|
Replaced by PARAMS. Do not use; will disappear someday soon. |
|
Was used in external function declarations. |
|
In ANSI C it is `NAME PROTOTYPE' (so PROTOTYPE should be enclosed in |
|
parentheses). In traditional C it is `NAME()'. |
|
For a function that takes no arguments, PROTOTYPE should be `(void)'. |
|
|
|
PARAMS ((args)) |
|
|
|
We could use the EXFUN macro to handle prototype declarations, but |
|
the name is misleading and the result is ugly. So we just define a |
|
simple macro to handle the parameter lists, as in: |
|
|
|
static int foo PARAMS ((int, char)); |
|
|
|
This produces: `static int foo();' or `static int foo (int, char);' |
|
|
|
EXFUN would have done it like this: |
|
|
|
static int EXFUN (foo, (int, char)); |
|
|
|
but the function is not external...and it's hard to visually parse |
|
the function name out of the mess. EXFUN should be considered |
|
obsolete; new code should be written to use PARAMS. |
|
|
|
For example: |
|
extern int printf PARAMS ((CONST char *format DOTS)); |
|
int DEFUN(fprintf, (stream, format), |
|
FILE *stream AND CONST char *format DOTS) { ... } |
|
void DEFUN_VOID(abort) { ... } |
|
*/ |
|
|
|
#ifndef _ANSIDECL_H |
|
|
|
#define _ANSIDECL_H 1 |
|
|
|
|
|
/* Every source file includes this file, |
|
so they will all get the switch for lint. */ |
|
/* LINTLIBRARY */ |
|
|
|
|
|
#if defined (__STDC__) || defined (_AIX) || (defined (__mips) && defined (_SYSTYPE_SVR4)) || defined(WIN32) |
|
/* All known AIX compilers implement these things (but don't always |
|
define __STDC__). The RISC/OS MIPS compiler defines these things |
|
in SVR4 mode, but does not define __STDC__. */ |
|
|
|
#define PTR void * |
|
#define PTRCONST void *CONST |
|
#define LONG_DOUBLE long double |
|
|
|
#define AND , |
|
#define NOARGS void |
|
#define CONST const |
|
#define VOLATILE volatile |
|
#define SIGNED signed |
|
#define DOTS , ... |
|
|
|
#define EXFUN(name, proto) name proto |
|
#define DEFUN(name, arglist, args) name(args) |
|
#define DEFUN_VOID(name) name(void) |
|
|
|
#define PROTO(type, name, arglist) type name arglist |
|
#define PARAMS(paramlist) paramlist |
|
#define ANSI_PROTOTYPES 1 |
|
|
|
#else /* Not ANSI C. */ |
|
|
|
#define PTR char * |
|
#define PTRCONST PTR |
|
#define LONG_DOUBLE double |
|
|
|
#define AND ; |
|
#define NOARGS |
|
#define CONST |
|
#ifndef const /* some systems define it in header files for non-ansi mode */ |
|
#define const |
|
#endif |
|
#define VOLATILE |
|
#define SIGNED |
|
#define DOTS |
|
|
|
#define EXFUN(name, proto) name() |
|
#define DEFUN(name, arglist, args) name arglist args; |
|
#define DEFUN_VOID(name) name() |
|
#define PROTO(type, name, arglist) type name () |
|
#define PARAMS(paramlist) () |
|
|
|
#endif /* ANSI C. */ |
|
|
|
#endif /* ansidecl.h */
|
|
|