Preprocessor directives — #define, #ifdef, #ifndef, #include guards

5.1.27 · Coding › C Programming

WHY preprocessor exist karta hai?

WHY humein yeh chahiye:

Code/text reuse karo bina dobara type kiye → #include.
Magic constants ko naam do taaki changes ek jagah ho → #define.
Alag situations ke liye alag code compile karo (debug vs release, Windows vs Linux) → #ifdef / #ifndef.
Header ko do baar paste hone se roko → include guards.

Build pipeline: $source.c preprocessor translation unit compiler .o linker executable$

`#define` — cheezein name karna text substitution se

HOW yeh kaam karta hai (object-like macro):

#define PI 3.14159
double area = PI * r * r;   // becomes: 3.14159 * r * r

Yeh step kyun? Preprocessor literally text PI ko 3.14159 se swap karta hai compiler run hone se pehle. Jab tak compiler isko dekhta hai, PI ab exist hi nahi karta.

Function-like macro ("arguments" leta hai):

#define SQUARE(x) ((x) * (x))
int y = SQUARE(3 + 1);   // becomes: ((3 + 1) * (3 + 1)) = 16

`#ifdef`, `#ifndef`, `#endif` — conditional compilation

WHY: kabhi kabhi aap chahte ho code jo sirf debugging ke dauran exist kare, ya sirf ek OS par. Preprocessor poore code chunks ko text ki tarah delete kar sakta hai compiler ke dekhne se pehle.

#define DEBUG
 
#ifdef DEBUG
    printf("x = %d\n", x);   // kept, because DEBUG is defined
#endif
 
#ifndef MAX
    #define MAX 100          // define MAX only if nobody defined it yet
#endif

Yeh step kyun? #ifndef MAX double-definition se bachata hai — MAX tabhi set karo agar yeh already nahi hai.

Include Guards — `#ifndef` ka killer use

/* file: types.h */
#ifndef TYPES_H      /* if the unique tag is NOT defined... */
#define TYPES_H      /* ...define it now (so next time we skip) */
 
struct Point { int x, y; };   /* the real header body */
 
#endif /* TYPES_H */

HOW yeh kaam karta hai, step by step:

Pehli baar header paste hota hai: TYPES_H undefined hai → #ifndef true hai → preprocessor TYPES_H define karta hai aur struct rakhta hai.
Doosri baar yeh paste hota hai: TYPES_H ab defined hai → #ifndef false hai → preprocessor sab kuch delete karta hai #endif tak. Struct sirf ek baar aata hai. ✅

Worked examples

Worked example 1. Macro precedence trap

#define HALF(x) x / 2
int z = HALF(6 + 4);

Substitution → 6 + 4 / 2 = 6 + 2 = 8. 5 nahi! Yeh step kyun? / + se tighter bind karta hai, isliye 4/2 pehle hota hai. Fix: #define HALF(x) ((x) / 2) → ((6+4)/2) = 5.

Worked example 2. Debug toggling

#define VERBOSE
#ifdef VERBOSE
    printf("loaded %d items\n", n);
#endif

#define VERBOSE line comment out karo → printf text preprocessor dwara delete ho jaata hai, ek chhota, silent build produce hota hai. Yeh step kyun? Koi runtime if cost nahi — yeh line literally compile hi nahi hoti.

Worked example 3. Default value pattern

#ifndef BUFFER_SIZE
#define BUFFER_SIZE 256
#endif
char buf[BUFFER_SIZE];

Agar ek build script -DBUFFER_SIZE=1024 pass karta hai, toh woh jeetta hai; warna default 256 ho jaata hai. Yeh step kyun? #ifndef bahari configuration ko file edit kiye bina override karne deta hai.

Common mistakes (steel-manned)

Flashcards

C compiler se pehle kaun sa stage run hota hai aur # lines process karta hai?

Preprocessor (textual substitution + conditional inclusion).

Kya ek #define macro ek typed variable hai?

Nahi — yeh pure text substitution hai jisme koi type, koi memory, koi scope nahi hota.

Macro arguments mein parentheses kyun wrap karte hain, jaise ((x)*(x))?

Kyunki andha text pasting precedence ignore karta hai; parens expressions ke liye correct grouping force karte hain.

#ifdef NAME kya karta hai?

Enclosed code tabhi rakhta hai agar NAME currently defined hai; warna delete kar deta hai.

#ifdef aur #ifndef mein kya fark hai?

#ifdef = defined hone par compile karo; #ifndef = NOT defined hone par compile karo.

Include-guard pattern likho.

#ifndef TAG phir #define TAG phir body phir #endif.

Include guards kaunsi problem solve karte hain?

Ek header ki contents ko ek translation unit mein kai baar paste (aur re-define) hone se rokta hai.

Include guards ka non-standard one-line alternative kya hai?

#pragma once.

#define MAX 100; dangerous kyun hai?

; bhi substitute ho jaata hai, arr[MAX] jaisi usage break kar deta hai → arr[100;].

#ifndef BUFFER_SIZE / #define BUFFER_SIZE 256 / #endif kya allow karta hai?

Bahari -DBUFFER_SIZE override kar sake; warna 256 ka safe default milta hai.

Recall Feynman: 12-saal ke bacche ko samjhao

Socho tum ek essay likhte ho lekin chhote stickers jaise "PI" aur "BIG_NUMBER" chhodte ho. Teacher ke padhne se pehle, ek helper aata hai aur har sticker ko woh asli words se replace karta hai jo tumne use bataye the. Helper yeh bhi follow kar sakta hai notes jaise "yeh paragraph sirf tab rakho agar hum test mode mein hain" aur "agar tum yeh page ek baar already chipka chuke ho, dubara mat chipkao." Woh helper preprocessor hai. Yeh bas text copy, replace, aur remove karta hai — yeh essay ko actually samajhta nahi. Helper ke baad, asli teacher (compiler) cleaned-up version padhta hai.

Connections

Header files and translation units
const vs #define vs enum
Compilation pipeline — preprocess, compile, assemble, link
Macros vs inline functions
Conditional compilation for cross-platform code
Build flags -D and the command line