Splitting code into multiple files - Mini Project: Build & Apply

Splitting code into multiple files

📖 Scenario: You are creating a simple C program that prints a greeting message. To keep your code organized, you want to split it into two files: one for the main program and one for the greeting function.

🎯 Goal: Build a C program with two files: main.c and greet.c. The greet.c file will have a function that prints a greeting. The main.c file will call this function.

📋 What You'll Learn

Create a function called print_greeting in greet.c that prints "Hello from greet.c!"

Declare the function print_greeting in a header file greet.h

Include greet.h in main.c

Call print_greeting from main.c

Compile both files together to run the program

💡 Why This Matters

🌍 Real World

Splitting code into multiple files helps keep programs organized and easier to maintain, especially as they grow larger.

💼 Career

Many software projects require working with multiple files and modules. Understanding how to split and compile code is essential for professional C programming.

1

Create the greeting function in greet.c

Create a file named greet.c and write a function called print_greeting that prints the text "Hello from greet.c!\n" using printf. Include <stdio.h> at the top.

C

# Your code here

Hint

Remember to include <stdio.h> to use printf.

2

Create the header file greet.h

Create a header file named greet.h. Declare the function print_greeting with the signature void print_greeting();. Use include guards to prevent multiple inclusion.

C

// Your code here

Hint

Use #ifndef, #define, and #endif to create include guards.

3

Write main.c to call print_greeting

Create a file named main.c. Include greet.h. Write the main function that calls print_greeting() and returns 0.

C

// Your code here

Hint

Include the header file with quotes: #include "greet.h".

4

Compile and run the program

Compile main.c and greet.c together using gcc main.c greet.c -o greet_program. Then run the program with ./greet_program. The output should be Hello from greet.c!

C

// Your code here

Hint

Use the command gcc main.c greet.c -o greet_program to compile and ./greet_program to run.

Practice

1. What is the main reason to split C code into multiple files?

easy

A. To reduce the number of variables

B. To make the program run faster

C. To organize code and make it reusable

D. To avoid using header files

Solution

1. Step 1: Understand code organization

   Splitting code into multiple files helps keep related code parts separate and easier to manage.

2. Step 2: Recognize code reuse benefit

   It also allows reusing code in different programs without rewriting it.

3. Final Answer:

   To organize code and make it reusable -> Option C

4. Quick Check:

   Splitting code = Organize and reuse [OK]

Hint: Think about code clarity and reuse benefits [OK]

Common Mistakes:

• Assuming splitting files makes code run faster
• Thinking header files are not needed
• Believing it reduces variables automatically

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

easy

A. #include utils.h

B. #include

C. include "utils.h"

D. #include "utils.h"

Solution

1. Step 1: Understand header file inclusion syntax

   To include your own header files, use double quotes around the filename.

2. Step 2: Differentiate system and user headers

   Angle brackets are for system headers, double quotes for user headers like utils.h.

3. Final Answer:

   #include "utils.h" -> Option D

4. Quick Check:

   User header files use "filename" [OK]

Hint: Use quotes for your headers, angle brackets for system [OK]

Common Mistakes:

• Using angle brackets for user headers
• Omitting # in include directive
• Not using quotes or brackets around filename

3. Given two files:

// file1.c
#include 
void greet();
int main() {
    greet();
    return 0;
}

// file2.c
#include 
void greet() {
    printf("Hello from file2!\n");
}

What is the output when compiled and run together?

medium

A. Hello from file2!

B. Compilation error: greet not declared

C. No output

D. Runtime error

Solution

1. Step 1: Check function declaration and definition

   file1.c declares greet() and calls it; file2.c defines greet() printing the message.

2. Step 2: Understand linking multiple files

   Compiling both files together links greet() correctly, so the program prints the message.

3. Final Answer:

   Hello from file2! -> Option A

4. Quick Check:

   Function declared and defined across files prints message [OK]

Hint: Declare before use, define in another file, link both [OK]

Common Mistakes:

• Forgetting to compile both files together
• Missing function declaration in file1.c
• Expecting compilation error due to separate files

4. You have two files:

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

// helper.c
#include 
void print_message() {
    printf("Hi!\n");
}

// helper.h
void print_message();

Compiling with gcc main.c gives an error: undefined reference to 'print_message'. What is the likely cause?

medium

A. Missing semicolon in helper.h

B. helper.c was not compiled or linked properly

C. print_message() is not declared in main.c

D. main.c does not include stdio.h

Solution

1. Step 1: Understand the error message

   "undefined reference" means the linker can't find the function definition.

2. Step 2: Check compilation command

   If helper.c is not compiled or linked, the function print_message() is missing at link time.

3. Final Answer:

   helper.c was not compiled or linked properly -> Option B

4. Quick Check:

   Linker error = missing compiled file [OK]

Hint: Always compile and link all source files together [OK]

Common Mistakes:

• Not compiling helper.c with main.c
• Ignoring linker errors thinking it's a syntax error
• Assuming declaration alone is enough

5. You want to split a program into main.c and math_ops.c. math_ops.c defines int add(int a, int b). How should you organize files and compile to use add in main.c correctly?

hard

A. Declare add in math_ops.h, include it in main.c, compile with gcc main.c math_ops.c

B. Define add in main.c and call it from math_ops.c, compile separately

C. Include math_ops.c directly in main.c with #include, compile main.c only

D. Declare add in main.c only, compile math_ops.c separately

Solution

1. Step 1: Create a header file math_ops.h

   Declare the function prototype int add(int a, int b); in math_ops.h.

2. Step 2: Include math_ops.h in main.c and compile both files

   Include math_ops.h in main.c to use add(), then compile with gcc main.c math_ops.c to link both.

3. Final Answer:

   Declare add in math_ops.h, include it in main.c, compile with gcc main.c math_ops.c -> Option A

4. Quick Check:

   Header declares, source defines, compile both [OK]

Hint: Use header for declarations, compile all sources together [OK]

Common Mistakes:

• Including .c files instead of headers
• Not declaring functions before use
• Compiling only one source file