Conditional compilation

Introduction

Conditional compilation lets you include or skip parts of your code when you build your program. This helps make your program work differently in different situations without changing the code every time.

You want to make your program work on different computers or systems.

You want to turn on or off debugging messages without deleting code.

You want to include special features only when needed.

You want to avoid compiling code that is not ready or not needed.

You want to test different versions of your code easily.

Syntax

C

#ifdef MACRO_NAME
// code here
#endif

#ifndef MACRO_NAME
// code here
#endif

#if EXPRESSION
// code here
#else
// alternative code
#endif

#ifdef checks if a macro is defined.

#ifndef checks if a macro is NOT defined.

Examples

This code prints a message only if DEBUG is defined.

C

#define DEBUG

#ifdef DEBUG
printf("Debugging is ON\n");
#endif

This code runs only if RELEASE is NOT defined.

C

#ifndef RELEASE
printf("Not in release mode\n");
#endif

This code chooses what to print based on the value of VERSION.

C

#if VERSION >= 2
printf("Version 2 or higher\n");
#else
printf("Version less than 2\n");
#endif

Sample Program

This program uses conditional compilation to print messages based on defined macros. It shows how #ifdef, #if, and #ifndef work.

C

#include <stdio.h>

#define DEBUG
#define VERSION 3

int main() {
    #ifdef DEBUG
    printf("Debug mode is active\n");
    #endif

    #if VERSION >= 2
    printf("Version is 2 or higher\n");
    #else
    printf("Version is less than 2\n");
    #endif

    #ifndef RELEASE
    printf("Release mode is OFF\n");
    #endif

    return 0;
}

Important Notes

Macros used in conditional compilation are usually defined with #define or passed as compiler options.

Conditional compilation happens before the program runs, during the build process.

Use conditional compilation to keep your code clean and flexible.

Summary

Conditional compilation lets you include or exclude code when building your program.

Use #ifdef, #ifndef, and #if to check conditions.

This helps make your program adaptable to different needs without changing the source code each time.

Practice

1. What does the #ifdef directive do in C conditional compilation?

easy

A. Includes the code block only if the specified macro is defined.

B. Includes the code block only if the specified macro is not defined.

C. Always includes the code block regardless of any macro.

D. Excludes the code block if the specified macro is defined.

Solution

1. Step 1: Understand #ifdef usage

   The #ifdef directive checks if a macro is defined.

2. Step 2: Effect on code inclusion

   If the macro is defined, the code inside the #ifdef block is included during compilation.

3. Final Answer:

   Includes the code block only if the specified macro is defined. -> Option A

4. Quick Check:

   #ifdef means "if defined" [OK]

Hint: Remember: #ifdef means "if defined" [OK]

Common Mistakes:

• Confusing #ifdef with #ifndef
• Thinking it always includes code
• Assuming it excludes code if macro is defined

2. Which of the following is the correct syntax to check if a macro DEBUG is NOT defined?

easy

A. #ifdef DEBUG

B. #ifndef DEBUG

C. #if DEBUG

D. #if !DEBUG

Solution

1. Step 1: Identify the directive for 'not defined'

   The directive #ifndef means "if not defined".

2. Step 2: Match with macro DEBUG

   Using #ifndef DEBUG checks if DEBUG is not defined.

3. Final Answer:

   #ifndef DEBUG -> Option B

4. Quick Check:

   #ifndef means "if not defined" [OK]

Hint: Use #ifndef to check if macro is NOT defined [OK]

Common Mistakes:

• Using #ifdef instead of #ifndef
• Using #if !DEBUG which is invalid for macro existence
• Confusing #if with #ifndef

3. What will be the output of this code if FEATURE is defined?

#include <stdio.h>
#define FEATURE

int main() {
#ifdef FEATURE
    printf("Feature is enabled\n");
#else
    printf("Feature is disabled\n");
#endif
    return 0;
}

medium

A. Feature is enabled

B. Feature is disabled

C. Compilation error

D. No output

Solution

1. Step 1: Check if FEATURE is defined

   The code has #define FEATURE, so FEATURE is defined.

2. Step 2: Evaluate #ifdef FEATURE block

   Since FEATURE is defined, the code inside #ifdef FEATURE runs, printing "Feature is enabled".

3. Final Answer:

   Feature is enabled -> Option A

4. Quick Check:

   Defined macro triggers #ifdef block [OK]

Hint: If macro defined, #ifdef block runs [OK]

Common Mistakes:

• Ignoring the #define line
• Thinking #else block runs
• Assuming compilation error due to macro

4. Identify the error in this code snippet:

#include <stdio.h>

int main() {
#ifdef DEBUG
    printf("Debug mode\n");
#else
    printf("Release mode\n");
#endif
    return 0;
}

medium

A. printf statements are invalid

B. Incorrect use of #ifdef directive

C. Missing #define DEBUG before #ifdef

D. Missing closing brace for main function

Solution

1. Step 1: Check code structure

   The code opens int main() { but does not have a closing } brace.

2. Step 2: Verify directives and syntax

   The #ifdef and #else directives are correctly used; missing #define DEBUG is not an error, just changes output.

3. Final Answer:

   Missing closing brace for main function -> Option D

4. Quick Check:

   Every function needs matching braces [OK]

Hint: Check all braces match in code blocks [OK]

Common Mistakes:

• Assuming missing #define is an error
• Thinking #ifdef usage is wrong
• Ignoring missing closing brace

5. You want to compile a program that prints "Debug mode" only if the macro DEBUG is defined, otherwise it prints "Normal mode". Which code snippet correctly achieves this using conditional compilation?

hard

A. #if !DEBUG
printf("Debug mode\n");
#else
printf("Normal mode\n");
#endif

B. #ifndef DEBUG
printf("Debug mode\n");
#else
printf("Normal mode\n");
#endif

C. #ifdef DEBUG
printf("Debug mode\n");
#else
printf("Normal mode\n");
#endif

D. #if DEBUG
printf("Debug mode\n");
#else
printf("Normal mode\n");
#endif

Solution

1. Step 1: Understand the requirement

   Print "Debug mode" only if DEBUG is defined, else print "Normal mode".

2. Step 2: Choose correct directive

   #ifdef DEBUG checks if DEBUG is defined and includes the first print statement; #else handles the other case.

3. Final Answer:

   #ifdef DEBUG printf("Debug mode\n"); #else printf("Normal mode\n"); #endif -> Option C

4. Quick Check:

   Use #ifdef for defined macro check [OK]

Hint: Use #ifdef for defined, #else for else [OK]

Common Mistakes:

• Using #ifndef which reverses logic
• Using #if DEBUG without macro value
• Using #if !DEBUG which is invalid