How to Create Header File in C Program | Example and Advantages

If you keep writing all the code in a single file, it will make clutter. It is very difficult to maintain especially if you are working on a big project.

In this tutorial, you will learn how to create header file in c and how to call a function defined in another file by including the header file in your program.

If you have worked on any standard project, there is a high possibility that you might have seen projects having program file util.C. It is not a standard but mostly used practice to store all the essential utility functions and variables in a single file and then call it from any of the project files.

How to do that?

Here is the quick tutorial I am sharing to let you understand. You need to create three program files.

• Writing a C program with a function definition that needs to be called from another program file
• A header file with declarations of all the defined functions
• C program file to call the remote functions

How to Create Header File in C Program?

Here is a step-by-step procedure with complete code and a detailed explanation with examples.

Step 1:

Write a program and define any function that needs to be called from other files.

int sumOfTwoNumbers(int num1, int num2)
{
    return num1 + num2; 
}

Save it (says util.C).

Note: You don’t need to define the function main() as you are not running this code explicitly. You only need to call the function defined in this program file.

Step 2:

Create a header file in C Program and declare all the functions defined in the above util.C program file.

int sumOfTwoNumbers(int num1, int num2);

Save the file with the same name but the extension .h (for you util.h).

Step 3:

Write a program to call the function defined in util.C file.

With all the basic header files required, you have to include util.h.

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

int main()
{
    printf("Sum of two numbers: %d", sumOfTwoNumbers(10, 30));
    return 0; 
}

Save this file (says testProg.C)

You have added stdio.h file to use printf() function.

You might have noticed as I have included util.h file with "---" mark. While compiling code, the header file is searched in the current directory/folder rather than the C program installed repository.

Just like util.h header file we have created, there is stdio.h file already present in the GCC directory. You can use the command to find all header file locations included in your program.

So basically both the functions printf() and sumOfTwoNumbers() are defined in the remote file. To use these functions, you need to add respective header files.

Note: Store all the above three program files in the same directory.

Running & Compiling Program

The syntax for Compiling multiple files into one output file:

gcc <list_of_program_files_to_be_compiled> -0 <output_file>

In your case,

gcc util.c testProg.c -0 pro

Note: You don’t need to mention the header file while compiling the code.

Run it.

On Windows:

pro

On Linux:

You may need executable permission to execute the output file.

chmod 777 pro

Learn more about Linux file permission.

Now execute,

./pro

Output:

Sum of two numbers: 40

Advantages of Header file in C and Calling Functions from Another File

• It preserves modularity by writing all the similar kinds of functions in a single file.
• If you require the same kind of operation to be performed in multiple program files, it is good practice to define the function in a single file and call it from whichever program file you need. So it reduces the line of code.
• For example, you need to sort the elements in multiple program files. You can simply write a sorting program (Selection sort, Bubble sort) in your util program and declare it in the header file. Now you can call this function from any of the program files.
• If you need to update the code for a particular operation, you just need to update the single function definition. So it avoids the possibility of blunders.

I tried my best to make it simple. Hope you understand this tutorial to create a header file in the C program. If you have any doubts regarding the header file, let’s have a discussion in the comment section below.

Aniruddha Chaudhari

I am complete Python Nut, love Linux and vim as an editor. I hold a Master of Computer Science from NIT Trichy. I dabble in C/C++, Java too. I keep sharing my coding knowledge and my own experience on <b>CSEstack.org</b> portal.