Linking multiple files in C - Mini Project: Build & Apply

Linking Multiple Files in C

📖 Scenario: You are creating a simple C program split into two files: one file will contain a function to greet a user, and the other will call this function and print the greeting.

🎯 Goal: Build a C program with two files: greet.c containing a function greet that returns a greeting string, and main.c that calls greet and prints the greeting.

📋 What You'll Learn

Create a function greet in greet.c that returns a greeting string.

Declare the function greet in a header file greet.h.

Include greet.h in main.c and call greet.

Print the greeting returned by greet in main.c.

Compile and link both files to produce the final executable.

💡 Why This Matters

🌍 Real World

Large C programs are split into multiple files to organize code better and allow multiple programmers to work together.

💼 Career

Understanding how to link multiple files is essential for software development in C, especially in systems programming and embedded development.

1

Create the greeting function in greet.c

Create a file called greet.c and write a function called greet that returns the string "Hello from greet.c!". Use const char* as the return type.

C

# Write the function greet in greet.c
// Your code here

Hint

Define a function named greet that returns a constant string.

2

Create the header file greet.h

Create a header file called greet.h that declares the function greet with the signature const char* greet();. Add include guards to prevent multiple inclusion.

C

// Write the header file greet.h with include guards and declare greet
// Your code here

Hint

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

3

Write main.c to call greet

Create a file called main.c. Include stdio.h and greet.h. In main, call greet and store the result in a variable called message. Then, print message using printf.

C

#include 
#include "greet.h"

int main() {
    // Call greet and print the message
    // Your code here
}

Hint

Include the header greet.h and use printf to display the greeting.

4

Compile and run the program

Compile greet.c and main.c together using a command like gcc main.c greet.c -o greet_program. Then run the program with ./greet_program and print the output.

C

// Compile and run the program, then print the output below
// Your code here

Hint

Use the terminal to compile and run. The output should be exactly Hello from greet.c!

Practice

1. What is the main purpose of linking multiple files in a C program?

easy

A. To organize code into separate files and combine them into one program

B. To run multiple programs at the same time

C. To convert C code into machine language

D. To write comments in different files

Solution

1. Step 1: Understand code organization

   Linking multiple files allows splitting code into parts for better organization and reuse.

2. Step 2: Understand linking process

   After compiling separately, linking combines these parts into one executable program.

3. Final Answer:

   To organize code into separate files and combine them into one program -> Option A

4. Quick Check:

   Linking = Combining files [OK]

Hint: Linking combines separate code files into one program [OK]

Common Mistakes:

• Confusing linking with running multiple programs
• Thinking linking converts code to machine language
• Believing linking is for writing comments

2. Which command correctly compiles two C files main.c and utils.c together using GCC?

easy

A. gcc main.c -o program

B. gcc -o program -c main.c utils.c

C. gcc main.c utils.c -o program

D. gcc program -o main.c utils.c

Solution

1. Step 1: Understand GCC command structure

   The correct syntax is: gcc [source files] -o [output file].

2. Step 2: Check options order

   The standard GCC syntax is gcc [source files] -o [output], as in gcc main.c utils.c -o program.

3. Final Answer:

   gcc main.c utils.c -o program -> Option C

4. Quick Check:

   gcc source files -o output [OK]

Hint: Put source files first, then -o output [OK]

Common Mistakes:

• Placing -o before source files
• Mixing order of files and output option
• Using output file name as source file

3. Given two files:

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

// file2.c
void greet();
int main() { greet(); return 0; }

What is the output after compiling and linking both files?

medium

A. Compilation error: greet not declared

B. Hello from file1

C. Runtime error: undefined reference to greet

D. No output

Solution

1. Step 1: Check function declaration and definition

   file1.c defines greet() printing "Hello from file1"; file2.c declares greet() and calls it in main.

2. Step 2: Linking files

   Compiling and linking both files connects the call to greet() with its definition, so it prints the message.

3. Final Answer:

   Hello from file1 -> Option B

4. Quick Check:

   Function call linked correctly = prints message [OK]

Hint: Declare functions in headers or files to link correctly [OK]

Common Mistakes:

• Forgetting to link both files
• Missing function declaration causing errors
• Expecting runtime errors without linking

4. What is wrong with this setup?

// file1.c
void greet() { printf("Hi\n"); }

// file2.c
int main() { greet(); return 0; }

When compiling separately and linking, it gives an error. Why?

medium

A. Cannot compile multiple files separately

B. Missing #include in file1.c

C. main() should be in file1.c

D. greet() is not declared before use in file2.c

Solution

1. Step 1: Check function declaration in file2.c

   file2.c calls greet() but does not declare it or include a header with its prototype.

2. Step 2: Understand compiler error

   Without declaration, compiler errors occur because it doesn't know greet() signature.

3. Final Answer:

   greet() is not declared before use in file2.c -> Option D

4. Quick Check:

   Declare functions before use [OK]

Hint: Always declare functions before calling them [OK]

Common Mistakes:

• Assuming definition is enough without declaration
• Ignoring missing #include (not cause here)
• Thinking main() must be in same file as greet()

5. You have three files:

// math_ops.c
int add(int a, int b) { return a + b; }

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

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

Which is the correct way to compile and link these files to produce an executable named calc?

hard

A. gcc main.c -c; gcc math_ops.c -c; gcc main.o math_ops.o -o calc

B. gcc main.c -o calc; gcc math_ops.c -o calc

C. gcc main.c math_ops.h -o calc

D. gcc main.c math_ops.c -c

Solution

1. Step 1: Compile source files separately

   Use gcc -c to compile main.c and math_ops.c into object files main.o and math_ops.o.

2. Step 2: Link object files

   Link main.o and math_ops.o together with gcc to create executable calc.

3. Final Answer:

   gcc main.c -c; gcc math_ops.c -c; gcc main.o math_ops.o -o calc -> Option A

4. Quick Check:

   Compile separately, then link object files [OK]

Hint: Compile with -c, then link object files [OK]

Common Mistakes:

• Compiling header files directly
• Overwriting executable by compiling twice
• Not linking object files after compiling