Header and source file organization - Cheat Sheet & Quick Revision

Recall & Review

beginner

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

A header file (.h) declares functions, macros, and variables so they can be shared between multiple source files (.c). It helps organize code and avoid repetition.

beginner

Why should function definitions be placed in source files (.c) instead of header files (.h)?

Function definitions in source files avoid multiple definition errors during linking. Header files should only have declarations to allow sharing without duplication.

intermediate

What is an include guard and why is it important?

An include guard is a set of preprocessor commands (#ifndef, #define, #endif) in a header file that prevents it from being included multiple times, avoiding redefinition errors.

beginner

How do you include a header file in a source file?

Use the #include directive with quotes for your own headers, like #include "myheader.h". This tells the compiler to insert the header's content.

intermediate

What is the benefit of separating declarations and definitions into header and source files?

Separating declarations and definitions improves code readability, allows multiple source files to share declarations, and helps manage large projects by modularizing code.

Which file should contain the function implementation in C?

A Header file (.h)

B Source file (.c)

C Makefile

D Executable file

Function implementations belong in source files (.c) to avoid multiple definitions and keep code organized.

What does an include guard prevent?

A Compilation errors from syntax mistakes

B Runtime errors

C Linker errors from missing functions

D Multiple inclusions of the same header file

Include guards prevent the same header file from being included more than once, avoiding redefinition errors.

How do you include a standard library header in C?

A #include <stdio.h>

B #include "stdio.h"

C #include (stdio.h)

D import stdio.h

Standard library headers are included with angle brackets, like #include .

Which of these is NOT typically found in a header file?

A Function declarations

B Macro definitions

C Function implementations

D Type definitions

Function implementations should be in source files, not header files.

Why use header files in a C project?

A To share declarations between source files

B To execute code

C To store compiled binaries

D To write comments

Header files share declarations so multiple source files can use the same functions and types.

Explain how header and source files work together in a C program.

Think about how you tell the compiler about functions before using them.

Describe the role and structure of an include guard in a header file.

It's like a safety check to avoid repeating the same code.

Practice

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

easy

A. To execute the program's main logic

B. To declare functions and variables for sharing between source files

C. To contain the actual implementation code of functions

D. To store compiled machine code

Solution

1. Step 1: Understand header file role

   Header files declare functions and variables so multiple source files can use them.

2. Step 2: Differentiate from source files

   Source files contain the actual code, not declarations.

3. Final Answer:

   To declare functions and variables for sharing between source files -> Option B

4. Quick Check:

   Header files declare, source files define [OK]

Hint: Headers declare, sources define code [OK]

Common Mistakes:

• Confusing header files as containing code
• Thinking header files execute code
• Mixing compiled code with header files

2. Which of the following is the correct way to include a header file named math_utils.h in a C source file?

easy

A. #include

B. import math_utils.h

C. #include "math_utils.h"

D. include math_utils.h

Solution

1. Step 1: Identify correct include syntax for user headers

   User-defined headers use double quotes: #include "filename".

2. Step 2: Differentiate from system headers

   System headers use angle brackets, but user headers like math_utils.h use quotes.

3. Final Answer:

   #include "math_utils.h" -> Option C

4. Quick Check:

   User headers use quotes [OK]

Hint: Use quotes for your own headers [OK]

Common Mistakes:

• Using angle brackets for user headers
• Using import instead of #include
• Omitting # in include directive

3. Given these files:

// math_utils.h
int add(int a, int b);

// math_utils.c
#include "math_utils.h"
int add(int a, int b) { return a + b; }

// main.c
#include 
#include "math_utils.h"
int main() {
    printf("%d\n", add(3, 4));
    return 0;
}

What will be the output when running the compiled program?

medium

A. 7

B. 34

C. 0

D. Compilation error

Solution

1. Step 1: Understand function declaration and definition

   math_utils.h declares add(), math_utils.c defines it to return sum of a and b.

2. Step 2: Trace main function call

   main.c calls add(3, 4), which returns 7, then prints it.

3. Final Answer:

   7 -> Option A

4. Quick Check:

   3 + 4 = 7 [OK]

Hint: Function returns sum, so output is 7 [OK]

Common Mistakes:

• Thinking add concatenates numbers
• Expecting compilation error due to missing code
• Confusing printf format

4. Consider this code snippet:

// utils.h
void print_message();

// utils.c
#include "utils.h"
void print_message() {
    printf("Hello!\n");
}

// main.c
#include "utils.h"
int main() {
    print_message();
    return 0;
}

When compiling, an error says implicit declaration of function 'printf'. What is the fix?

medium

A. Add #include <stdio.h> in utils.c

B. Add #include <stdio.h> in utils.h

C. Add #include <stdio.h> in main.c

D. Remove print_message function

Solution

1. Step 1: Identify cause of error

   printf is declared in stdio.h; utils.c uses printf but lacks this include.

2. Step 2: Fix by including stdio.h in utils.c

   Adding #include <stdio.h> in utils.c provides printf declaration, fixing error.

3. Final Answer:

   Add #include <stdio.h> in utils.c -> Option A

4. Quick Check:

   Include stdio.h where printf is used [OK]

Hint: Include stdio.h in files using printf [OK]

Common Mistakes:

• Including stdio.h only in header file
• Including stdio.h only in main.c
• Ignoring missing printf declaration

5. You want to organize a C project with multiple source files sharing utility functions. Which is the best practice for header and source file organization?

hard

A. Put function definitions in header files and include them everywhere

B. Put function declarations and definitions together in each source file without headers

C. Put all code in a single source file without headers

D. Put all function declarations in one header file and definitions in one source file, then include the header where needed

Solution

1. Step 1: Understand modular organization

   Separating declarations in headers and definitions in source files allows sharing and reuse.

2. Step 2: Avoid putting definitions in headers

   Definitions in headers cause multiple definition errors when included in many files.

3. Final Answer:

   Put all function declarations in one header file and definitions in one source file, then include the header where needed -> Option D

4. Quick Check:

   Headers declare, sources define, include headers [OK]

Hint: Declare in headers, define in sources, include headers [OK]

Common Mistakes:

• Defining functions in headers causing linker errors
• Not using headers causing duplicate declarations
• Putting all code in one file reducing modularity