2.1.19. ‑Dname[(parm-list)][=def]
This option defines the macro name.
‑Dname[(parm-list)][=def]
Where:
nameIs the name of the macro to be defined.
parm-listIs an optional list of comma-separated macro parameters. By appending a macro parameter list to the macro name, you can define function-style macros.
The parameter list must be enclosed in parentheses. When specifying multiple parameters, do not include spaces between commas and parameter names in the list.
Note
Parentheses might need escaping on UNIX systems.
=defIs an optional macro definition.
If =def is omitted, the compiler defines name as the value 1.
To include characters recognized as tokens on the command line, enclose the macro definition in double quotes.
Specifying -Dname has the same effect as placing the text #define name at the head of each source file.
The compiler defines and undefines macros in the following order:
compiler predefined macros
macros defined explicitly, using ‑Dname
macros explicitly undefined, using ‑Uname.
Specifying the option:
-DMAX(X,Y)="((X > Y) ? X : Y)"
on the command line is equivalent to defining the macro:
#define MAX(X, Y) ((X > Y) ? X : Y)
at the head of each source file.