Chapter 19: Header Files

As programs grow larger, writing all code inside a single file becomes difficult to manage. Header files help organize programs by separating function declarations, macros, constants, and shared definitions into reusable files.

Header files improve code modularity, readability, and maintainability.

What is a Header File?

A header file is a file containing declarations and definitions that can be shared across multiple source files. They typically use the .h extension.

Header files usually contain:

• Function declarations
• Macros
• Constants
• Structure definitions
• Typedef declarations

#include <header_file>
#include "header_file"

int add(int a, int b); // Function declaration

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

int main()
{
    printf("%d", add(10, 20));

    return 0;
}

#ifndef MYHEADER_H   // 1. checks whether header is already included
#define MYHEADER_H   // 2. marks header as included

int add(int a, int b);

#endif               // 3. closes condition to prevent re-inclusion

Why Header Files Are Used

Integrating dedicated header architecture unlocks fundamental structural advantages:

• • Organizes massive program scopes efficiently
• • Shares crucial declarations globally across codebase
• • Aggressively cuts down code duplication
• • Radically simplifies general project structures
• • Drives total code reusability to production-grade levels

Important Points

• → Header files usually use the .h extension
• → #include inserts header content during compilation
• → Function declarations are commonly placed inside headers
• → Include guards prevent duplicate inclusion problems
• → Standard libraries use angle brackets < >

Embedded Focus

Embedded projects are often divided into multiple modules such as drivers, communication stacks, peripheral control, and hardware abstraction layers. Header files are used extensively to share register definitions, macros, function declarations, and hardware configurations across different source files.

#include "gpio_driver.h"

Proper use of header files helps organize embedded firmware and improves maintainability in large projects.