C Preprocessor Directives - Complete Guide

Introduction to C Preprocessor

The C preprocessor is a tool that processes your source code before it's compiled. It handles directives (lines starting with #) to perform text manipulation, file inclusion, and conditional compilation.

The #include Directive - Complete Guide

The #include directive tells the preprocessor to insert the contents of another file into the current file. This is essential for including header files that contain function declarations, macros, and type definitions.

Search Order:

Key Characteristics:

• Angle brackets (<>): Search system/include directories only
• Double quotes (""): Search current directory first, then system directories
• No semicolon: Preprocessor directives don't end with semicolons
• Text insertion: File contents are literally inserted at the #include location

#include Directive Examples:

#include <stdio.h>

int main(void) {
    printf("stdio included\n");
    return 0;
}

/* mylib.h */
#ifndef MYLIB_H
#define MYLIB_H
int add(int a, int b);
#endif

/* main.c */
#include "mylib.h"
#include <stdio.h>
int main(void) { printf("%d\n", add(2, 3)); return 0; }

The #define Directive and Macros

The #define directive creates macros - symbolic names that represent values or code fragments. Macros are replaced by their definitions during preprocessing.

Macro Expansion Process:

Key Characteristics:

• Text substitution: Simple replacement, no type checking
• No memory allocation: Macros don't consume memory at runtime
• Scope: From point of definition to end of file or #undef
• Naming convention: Use uppercase for macros (common practice)

#define Directive Examples:

#include <stdio.h>
#define PI 3.14159
#define MAX 100

int main(void) {
    printf("PI=%.5f MAX=%d\n", PI, MAX);
    return 0;
}

#include <stdio.h>
#define SQUARE(x) ((x) * (x))
#define MAX(a,b) ((a) > (b) ? (a) : (b))

int main(void) {
    printf("%d %d\n", SQUARE(5), MAX(3, 7));
    return 0;
}

#include <stdio.h>
#define DOUBLE(x) ((x) + (x))

int main(void) {
    printf("%d\n", DOUBLE(2 + 3));
    return 0;
}

Conditional Compilation Directives

Conditional compilation directives allow you to include or exclude code based on conditions that can be evaluated at compile time. This is essential for platform-specific code, debugging, and feature toggles.

Conditional Compilation Flow:

Conditional Compilation Examples:

#include <stdio.h>
#define DEBUG 1
#if DEBUG
#define LOG(msg) printf("LOG: %s\n", msg)
#else
#define LOG(msg)
#endif

int main(void) {
    LOG("started");
    return 0;
}

#include <stdio.h>
#ifdef _WIN32
#define OS_NAME "Windows"
#else
#define OS_NAME "Unix-like"
#endif

int main(void) {
    printf("OS: %s\n", OS_NAME);
    return 0;
}

#include <stdio.h>
#define FEATURE_X 1

int main(void) {
#if FEATURE_X
    printf("Feature X enabled\n");
#else
    printf("Feature X disabled\n");
#endif
    return 0;
}

Other Preprocessor Directives

Beyond the commonly used directives, C provides several other preprocessor directives for specialized tasks.

#include <stdio.h>
#line 100 "custom.c"

int main(void) {
    printf("Other directives demo\n");
    return 0;
}

Predefined Macros

The C preprocessor provides several predefined macros that give information about the compilation environment.

#include <stdio.h>

int main(void) {
    printf("File: %s\n", __FILE__);
    printf("Line: %d\n", __LINE__);
    return 0;
}

Common Mistakes and Best Practices