【C言語中級編】プログラムをファイル分割する基本!ヘッダーファイルの作り方と分割コンパイル

プログラムの規模が大きくなってくると、全てのコードを一つのファイル(例えば main.c)に書き続けるのは大変です。コードは長くなり、目的の関数を探すのも一苦労、修正による影響範囲も分かりにくくなります。

そこで重要になるのが、機能ごとにプログラムを複数のファイルに分割するという考え方です。この記事では、その中核を担う**「ヘッダーファイル」の作り方と役割**、そして分割したファイルを一つにまとめる**「分割コンパイル」**の仕組みを、初心者の方にも分かりやすく解説します。


目次

そもそも#includeとは?ヘッダーファイルの役割

私たちはC言語を学ぶ最初の段階で、#include <stdio.h> というおまじないを学びます。この #include が、ファイル分割の鍵を握っています。

#include は非常に単純な命令で、指定されたファイルの中身を、その場所にまるごとコピー&ペーストするという働きをします。stdio.h には printf 関数などを使うための「宣言」が書かれており、それをソースコードの先頭に展開することで、私たちは printf をエラーなく呼び出すことができるのです。

< >" " の違い

インクルードには2種類の書き方があり、コンパイラがファイルを探す場所の優先順位が異なります。

  • #include <system_header.h>: 主にOSやコンパイラが提供するシステム標準のヘッダーファイルに使います。コンパイラが知っている標準の場所を探しに行きます。
  • #include "my_header.h": 主に自作のヘッダーファイルに使います。まずソースコードと同じディレクトリ(カレントディレクトリ)を探し、見つからなければシステムの標準の場所を探しに行きます。

自作ヘッダーファイルの作り方とルール

では、実際に自分たちのヘッダーファイルを作ってみましょう。ここには、守るべき重要なルールがあります。

ヘッダーファイル(.h)とソースファイル(.c)の役割分担

プログラムを分割する際、「宣言」と「定義」を分離するのが基本です。

  • ヘッダーファイル(.h)に書くもの → 「宣言」
    • 「こういうものがありますよ」という紹介状のようなもの。
    • 関数のプロトタイプ宣言 (double calculate_tax(int price); など)
    • 構造体や共用体の定義 (struct Product { ... }; など)
    • #define による定数の定義 (#define TAX_RATE 0.1 など)
  • ソースファイル(.c)に書くもの → 「定義」
    • 「宣言」されたものの、具体的な中身や実体。
    • 関数の処理本体 (double calculate_tax(int price) { ...処理... } など)

関数の処理本体のような「定義」をヘッダーファイルに書いてしまうと、複数のファイルからインクルードされた際に「同じものが複数定義されている」というコンパイルエラーの原因になるため、絶対に避けましょう。

必須の作法「インクルードガード」

ヘッダーファイルは、プロジェクトが複雑になると、意図せず同じファイルから複数回インクルードされてしまうことがあります。これを防ぐためのおまじないがインクルードガードです。

#ifndef MY_HEADER_H  // もし「MY_HEADER_H」が未定義なら
#define MY_HEADER_H  // 「MY_HEADER_H」を定義する

// ここにヘッダーファイルの中身(宣言など)を書く

#endif // MY_HEADER_H の終わり

この記述でヘッダーファイル全体を囲むことで、もし2回目以降のインクルードがあっても、#ifndef の条件が満たされず、中身が重複して読み込まれるのを防いでくれます。自作のヘッダーファイルには必ず書く習慣をつけましょう。


実践!消費税計算プログラムを3つに分割する

それでは、簡単な消費税計算プログラムを例に、実際にファイルを分割してみましょう。

  • main.c: プログラムのメイン処理
  • calc.c: 計算処理の本体
  • calc.h: 計算処理に関する宣言をまとめたヘッダー

1. ヘッダーファイル calc.h

calc.h には、他のファイルから使われる定数と、関数のプロトタイプ宣言を記述します。忘れずにインクルードガードも付けましょう。

// calc.h

#ifndef CALC_H
#define CALC_H

// 消費税率の定義
#define SALES_TAX_RATE 0.1

// 税込価格を計算する関数のプロトタイプ宣言
double calc_with_tax(int price);

#endif // CALC_H

2. ソースファイル calc.c

calc.c には、calc.h で宣言した関数の具体的な処理(定義)を記述します。自分自身に関する宣言が書かれている calc.h をインクルードします。

// calc.c

#include "calc.h"

// calc_with_tax 関数の定義(処理本体)
double calc_with_tax(int price) {
    double tax = price * SALES_TAX_RATE;
    return price + tax;
}

3. ソースファイル main.c

main.c は、プログラム全体の司令塔です。計算機能を使いたいので、<stdio.h> に加えて、自作した calc.h をインクルードします。

// main.c

#include <stdio.h>
#include "calc.h" // 自作ヘッダーをインクルード

int main(void) {
    int item_price = 1500;
    
    printf("商品の価格: %d円\n", item_price);
    
    // calc.h で宣言されている関数を呼び出す
    double total_price = calc_with_tax(item_price);
    
    printf("税込価格: %.0f円 (消費税率 %.2f)\n", total_price, SALES_TAX_RATE);
    
    return 0;
}

これで、プログラムを3つのファイルにきれいに分割できました。main.c は計算の詳細を知らなくても、calc.h を見るだけで calc_with_tax 関数を使えるようになっています。


分割コンパイルで1つの実行ファイルに

分割したソースファイルは、分割コンパイルという手順を経て、最終的に1つの実行ファイルになります。

  1. コンパイル: 各ソースファイル(.c)を、それぞれ個別にコンパイルし、オブジェクトファイル(.o.obj)を生成します。
  2. リンク: 生成された全てのオブジェクトファイルと、必要なライブラリを結合(リンク)して、1つの実行ファイルを生成します。

コマンドライン(GCC)で実行する場合、以下のようになります。

# 1. 各ソースファイルをコンパイルしてオブジェクトファイルを作成
gcc -c main.c -o main.o
gcc -c calc.c -o calc.o

# 2. オブジェクトファイルをリンクして実行ファイルを作成
gcc main.o calc.o -o my_program

Visual Studioのような統合開発環境(IDE)を使っている場合は、ビルドボタンを押すだけでこの一連の処理が自動的に行われます。


まとめ

プログラムを複数のファイルに分割することで、コードの可読性保守性、そして再利用性が飛躍的に向上します。

  • **ヘッダーファイル(.h)には、外部に公開する関数の「宣言」**や構造体の定義などを書く。
  • **ソースファイル(.c)には、関数の具体的な処理である「定義」**を書く。
  • ヘッダーファイルには、二重インクルードを防ぐ**「インクルードガード」**を必ず記述する。

最初は少し難しく感じるかもしれませんが、この「宣言と定義の分離」は、C言語だけでなく多くのプログラミング言語で使われる非常に重要な概念です。ぜひマスターして、より構造化された美しいコードを目指しましょう!

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

私が勉強したこと、実践したこと、してることを書いているブログです。
主に資産運用について書いていたのですが、
最近はプログラミングに興味があるので、今はそればっかりです。

目次