As you have studied in C preprocessor before, C++ preprocessor also has the same exact concept of it with a change in coding.
As the “pre” means beforehand, similarly it means processing something before passing it on further. The preprocessor is a program that processes the source program before it is passed to the compiler. So we can say that it is a separate process in the compilation.
Preprocessor gives specific features called directives. All preprocessor directive begins with “#
“ symbol and do not need to be end with senicolon (;). We have seen the use of #include in the program till now.
The following are preprocessor directives:
- Macro expansion
- File inclusion
- Conditional Compilation
- Miscellaneous directives
Macro Definition
macro is defined by #define
in a program. It is used to define some constant in a program that can be used anywhere during the entire program. This constant becomes global value.
#define PI 3.1415
This statement is called ‘macro definition’ or more commonly, just a ‘macro’.
Its purpose: during preprocessing, the preprocessor replaces every occurrence of PI in the program with a 3.1415 value.
You may try this program:
1 2 3 4 5 6 7 8 9 10 11 12 | #include <iostream> using namespace std; #define PI 3.14159 //macro int main () { float radius = 2.5; cout << "Area of a circle :" << PI * radius *radius << endl; return 0; } |
Area of a circle :19.6349
File inclusion
#include
is used to include some files into the program. These are usually header files, but sometimes maybe any text file. The command looks something like this:
#include <iostream>
iostream
is the header file that contains the library function useful to the program.
Conditional Compilation
The C++ preprocessor provides a series of directives for conditional compilation: #if, #elif, #else, #ifdef, #ifndef, and #endif. These commands cause the preprocessor to include or exclude sections of the source code from compilation depending on certain conditions.
Conditional compilation is used for three main purposes:
- Optionally include debugging code
- Enclose non-portable code
- Guard against multiple inclusion of header files.
Syntax:
#ifdef, #endif, #if, #else, #ifndef
#ifndef
1 2 3 | #ifndef TEXT #define TEXT "Hello World" #endif |
It tells the C Preprocessor to define TEXT only if TEXT isn’t already defined.
#ifdef Directive
1 2 3 | #ifdef MACRO // conditional codes #endif |
1 2 3 4 5 | #if expression conditional codes if expression is non-zero #else conditional if expression is 0 #endif |
You can also add nested conditional to your #if...#else
using #elif
1 2 3 4 5 6 7 8 9 | #if expression // conditional codes if expression is non-zero #elif expression1 // conditional codes if expression is non-zero #elif expression2 // conditional codes if expression is non-zero #else // conditional if all expressions are 0 #endif |
Other directives
#undef is used to undefine a defined macro variable.
1 2 | #undef FILE_SIZE #define FILE_SIZE 38 |
It tells the C Preprocessor to undefine existing FILE_SIZE and define it as 38.
#pragma startup and #pragma exit: These are used to call a function before and after the main function in a C++ program.
#undef, #pragma startup, #pragma exit
Predefined Macros
Macro | Value |
---|---|
__DATE__ | A string containing the current date |
__FILE__ | A string containing the file name |
__LINE__ | An integer representing the current line number |
__TIME__ | A string containing the current date. |