Header files and include directive

Introduction

Header files help organize code by keeping declarations separate from the main code. The include directive lets you reuse code easily by adding these declarations where needed.

When you want to use functions or variables declared in another file.

When you want to share common constants or macros across multiple files.

When you want to keep your code clean and organized by separating declarations from definitions.

When you use standard library functions like printf or scanf.

When you want to avoid rewriting the same code in multiple places.

Syntax

C

#include <header_file>

// or

#include "header_file.h"

Use angle brackets <> for standard library headers.

Use double quotes "" for your own header files in the project.

Examples

This includes the standard input/output library so you can use functions like printf.

C

#include <stdio.h>

This includes a user-defined header file named myheader.h from your project folder.

C

#include "myheader.h"

Sample Program

This program shows how a function can be declared (like in a header) and then defined later. The include directive is used here to bring in the standard input/output functions.

C

#include <stdio.h>

// Function declaration in header style
void greet();

int main() {
    greet();
    return 0;
}

// Function definition
void greet() {
    printf("Hello from the greet function!\n");
}

Important Notes

Header files usually contain declarations, not full function definitions.

Including the same header multiple times can cause errors; use include guards or #pragma once to prevent this.

The include directive literally copies the header file content into your source file before compiling.

Summary

Header files store declarations to share between source files.

#include adds header file content to your code.

Use <> for system headers and "" for your own headers.

Practice

1. What is the main purpose of a header file in C programming?

easy

A. To store declarations and share them between source files

B. To execute the main program logic

C. To compile the program faster

D. To store variable values during runtime

Solution

1. Step 1: Understand what header files contain

   Header files usually contain declarations like function prototypes and macros, not executable code.

2. Step 2: Understand their role in sharing code

   They allow multiple source files to share these declarations, so the compiler knows about functions and variables.

3. Final Answer:

   To store declarations and share them between source files -> Option A

4. Quick Check:

   Header files = declarations shared [OK]

Hint: Header files hold declarations, not code [OK]

Common Mistakes:

• Thinking header files contain executable code
• Confusing header files with source files
• Believing header files speed up compilation
• Assuming header files store variable values

2. Which of the following is the correct syntax to include a system header file named stdio.h?

easy

A. #include "stdio.h"

B. #include

C. include

D. #include stdio.h

Solution

1. Step 1: Recall syntax for system headers

   System headers use angle brackets <> to tell the compiler to look in system directories.

2. Step 2: Check each option

   #include uses #include with <stdio.h>, which is correct syntax. #include "stdio.h" uses quotes which are for user headers. Options C and D miss the # or angle brackets.

3. Final Answer:

   #include <stdio.h> -> Option B

4. Quick Check:

   System headers use <> [OK]

Hint: Use < > for system headers, " " for your own [OK]

Common Mistakes:

• Using quotes for system headers
• Omitting the # in #include
• Not using angle brackets or quotes
• Writing include without #

3. What will be the output of this C program?

#include <stdio.h>
#include "myheader.h"

int main() {
    printMessage();
    return 0;
}

Assuming myheader.h contains:

void printMessage() {
    printf("Hello from header!\n");
}

medium

A. No output

B. Compilation error: function not declared

C. Runtime error

D. Hello from header!

Solution

1. Step 1: Understand #include "myheader.h" effect

   The content of myheader.h is inserted, so printMessage() is defined before main.

2. Step 2: Check function call and output

   printMessage() prints "Hello from header!\n", so the program outputs that line.

3. Final Answer:

   Hello from header! -> Option D

4. Quick Check:

   Included function runs and prints message [OK]

Hint: Including header inserts code, so functions are available [OK]

Common Mistakes:

• Assuming function is undeclared without prototype
• Thinking header files can't contain function definitions
• Confusing compile and runtime errors
• Ignoring the newline in output

4. Identify the error in this code snippet:

#include 
#include 

int main() {
    printHello();
    return 0;
}

Assuming myheader.h is a user-defined header file in the project folder.

medium

A. Function printHello() is not defined

B. Missing semicolon after #include directives

C. Using angle brackets for a user-defined header file

D. Missing main function return type

Solution

1. Step 1: Check #include syntax for user headers

   User headers should be included with quotes "myheader.h" to search local directories first.

2. Step 2: Understand effect of wrong include syntax

   Using angle brackets makes compiler look in system directories, so it may not find myheader.h causing an error.

3. Final Answer:

   Using angle brackets for a user-defined header file -> Option C

4. Quick Check:

   User headers use "" not <> [OK]

Hint: Use "" for your headers, < > for system headers [OK]

Common Mistakes:

• Using < > for user headers
• Thinking #include needs semicolons
• Assuming printHello() is always undefined
• Ignoring main return type

5. You want to create a header file mathutils.h that declares a function int add(int a, int b); and use it in two source files main.c and calc.c. Which is the best practice to avoid multiple definition errors?

hard

A. Put only the function declaration in mathutils.h and define the function in one source file

B. Define the function in both source files and include mathutils.h everywhere

C. Put the function definition in mathutils.h and include it in both source files

D. Include mathutils.h only in main.c and define function in calc.c

Solution

1. Step 1: Understand declarations vs definitions in headers

   Headers should contain declarations (function prototypes), not definitions (function bodies), to avoid multiple definitions.

2. Step 2: Apply to multiple source files

   Define the function in one source file (e.g., calc.c) and declare it in mathutils.h included by both files.

3. Final Answer:

   Put only the function declaration in mathutils.h and define the function in one source file -> Option A

4. Quick Check:

   Declarations in headers, definitions in one source file [OK]

Hint: Declare in header, define once in source file [OK]

Common Mistakes:

• Defining functions in headers causing multiple definitions
• Not including header in all source files needing declaration
• Defining function in multiple source files
• Including header only in one source file