C Organize Code

Organize Your Code - Modular Programming

In C programming, modular programming means splitting your code into smaller, reusable parts.

This makes your code easier to read, maintain, and debug.

The most common way to organize C programs is by using separate .c files and .h header files.

Even though this approach is not required for small beginner programs, it is very useful for larger projects or more experienced programmers who want to keep their code clean and well-structured.

Why Use Header Files?

• To declare functions that are defined in another file
• To share variables, constants, or macros across files
• To organize your code into logical modules

Example: Creating a Header File

In this example, you will learn how to create your own header file and use it to organize code across multiple files.

Let's create a simple calculator module with a header file and a source file.

1. calc.h

Start by creating a header file named calc.h to declare the functions:

#ifndef CALC_H
#define CALC_H

int add(int x, int y);
int subtract(int x, int y);

#endif

Example Explained

The #ifndef, #define, and #endif lines are called an include guard.

They prevent the file from being included more than once by mistake, which can cause errors during compilation.

The first time the file is included, CALC_H is not defined yet, so #ifndef lets the code in, and #define defines CALC_H. If the file is included again, CALC_H is already defined, so #ifndef skips everything up to #endif (see Macros).

This is a common and recommended practice in all C header files.

This file itself contains declarations of two functions: add() and subtract().

Writing the Function Definitions

2. calc.c

Next, write the function definitions inside your calc.c file:

#include "calc.h"

int add(int x, int y) {
  return x + y;
}

int subtract(int x, int y) {
  return x - y;
}

This file defines the functions declared in calc.h.

Using the Module in main.c

3. main.c

Finally, write the main program in main.c and include the header file to use the calculator functions:

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

int main() {
  printf("5 + 5 = %d\n", add(5, 5));
  printf("6 - 4 = %d\n", subtract(6, 4));
  return 0;
}

How to Compile Multiple Files

When your program is split across multiple files, you need to compile them together. For example:

gcc main.c calc.c -o program

This tells the compiler to build one executable (a program file you can run) named program from both main.c and calc.c.

Here is how the three files work together:

Note: You do not compile calc.h. The #include line copies it into main.c and calc.c.

Tip: If you use an IDE like Code::Blocks, add all the .c and .h files to the same project, and the IDE compiles them together for you.