Skip to main content

Conditional Compilation

Introduction to Conditional Compilation in C

C programming language provides several techniques to optimize your code. One of these techniques is Conditional Compilation. It is a feature of the C preprocessor that allows you to include or exclude part of the source code if a certain condition is met. It is a very powerful tool that can be used for debugging, testing, and setting up different build configurations.

The C Preprocessor and Directives​

Before we dive into conditional compilation, let's briefly understand what a preprocessor is. The C preprocessor is a part of the C compiler that handles certain statements before the actual compilation of the program begins. These statements are called preprocessor directives and they begin with a hash symbol (#).

For example, the #include directive tells the preprocessor to include a file in the source code.

#include <stdio.h>

Conditional Compilation Directives​

The preprocessor directives used for conditional compilation are: #if, #elif, #else, and #endif.

The #if Directive​

The #if directive is used to check if a certain condition is true. If the condition is true, the code between the #if and the corresponding #endif is compiled. Otherwise, it is skipped.

#if CONDITION
    // This code is compiled if CONDITION is true
#endif

The #elif Directive​

The #elif (else if) directive is used after an #if or another #elif directive. It checks another condition if the previous conditions were false.

#if CONDITION1
    // This code is compiled if CONDITION1 is true
#elif CONDITION2
    // This code is compiled if CONDITION1 is false and CONDITION2 is true
#endif

The #else Directive​

The #else directive is used after an #if or #elif directive. It defines a block of code that is compiled if all the previous conditions were false.

#if CONDITION
    // This code is compiled if CONDITION is true
#else
    // This code is compiled if CONDITION is false
#endif

Example of Conditional Compilation​

Let's look at a simple example of conditional compilation.

#define DEBUG 1

int main() {
    #if DEBUG
        printf("Debug mode is on\n");
    #else
        printf("Debug mode is off\n");
    #endif

    return 0;
}

In this example, the DEBUG macro is defined with a value of 1. The #if directive checks if DEBUG is true (non-zero). If it is, it prints "Debug mode is on". Otherwise, it prints "Debug mode is off".

If you change the value of DEBUG to 0 and run the program again, it will print "Debug mode is off".

Conclusion​

Conditional compilation is a powerful feature of the C preprocessor that allows you to control which parts of your code are compiled based on certain conditions. This can be very useful for setting up different build configurations, enabling or disabling debug code, and writing platform-specific code.