C言語 include【インクルードで起こる変化の正体を解説】

こんにちは、ナナです。

プリプロセッサ３大機能のうちの１つ「include」機能について解説しましょう。

「include」機能を使用することで、他の人が作ったプログラムを利用することができ、皆さんが作ったプログラムを他の人に利用してもらうこともできるようになります。

「include」機能を理解するためには、最低限「関数」に関しての知識は得ておきましょう。これが理解する上での最低ラインの知識です。

本記事では次の疑問点を解消する内容となっています。

では、インクルード機能の使い方を学んでいきましょう。

プリプロセッサが何かわからない方は、こちらの記事を先に見ておくとよいでしょう。

include は「おまじない」…はもう卒業しよう

インクルードと言えば「Hello World」を表示する時にお世話になる「おまじない」ですね。

#include <stdio.h> // おまじない！

int main(void)
{
    printf("Hello World!");

    return 0;
}

多くの書籍やサイトでは、最初に作るプログラミングとして「Hello World」を表示させます。その時「おまじないだから、最初にincludeと書いて！」とされるやつです。

しかし、これは致し方ないのです。includeを理解するための知識の下準備が整っていない状態では説明のしようがないのです。

でも、もう大丈夫です。カリキュラムを順に実施してきた方であれば、理解するための準備が整っています。

includeとは「コピペ職人」である。その真意を解説していきましょう。コピペは皆さん知ってますよね。

includeの意味と役割

includeの書き方の基礎

みなさんはここまでプログラムの先頭に「include」を次のように書いてきましたね。

#include <stdio.h>
#include <string.h>

includeキーワードの後ろに＜ファイル名＞と書かれています。このように、「#include」の後ろには必ずファイル名を付与する必要があります。

インクルードとは結局何なのか？

includeとは和訳すると「含む」です。実はこの「含む」という言葉は「コピー＆ペーストする」という処理を表現したものです。

つまり、includeとは

指定したファイル内容をその箇所にコピー＆ペーストする

という機能なのです。

includeでコピペするファイルって何なの？

「ヘッダファイル」というキーワードが出てきました。includeを理解するためには、ヘッダファイルを理解する必要があります。

ヘッダファイルとソースファイル

includeで指定していたファイル名は「stdio.h」「string.h」といった拡張子が「.h」となっているファイルであるという共通点があります。

このファイルを「ヘッダファイル」と呼びます。皆さんが作るC言語のプログラムとは、次のファイルで構成されます。

ヘッダファイルには何が書かれているのか？

皆さんはここまで、main.cというソースファイルに対して、様々な処理を関数として記述してきました。

では、「ヘッダファイル」とは何が書かれているファイルなのでしょう。

ここで一度、関数の記事内容に立ち返ってみます。関数を呼び出す際に関数定義順によって警告やエラーが発生するという注意事項がありました。

これを解決するために、「プロトタイプ宣言」というものを書くことで解決できるとも解説しました。

でも、不思議な点に気づきませんか？

printf関数も関数ですよね。subfunc関数の中からprintf関数を呼び出せているのはなぜでしょう。printf関数のプロトタイプ宣言なんて皆さん書いてないですよね。

この謎を解くのが「stdio.h」なんです。

printf関数のプロトタイプ宣言は、実は「stdio.h」の中に書かれています。つまり、「stdio.h」ををincludeすることで、プロトタイプ宣言がコピー＆ペーストされていたのです。

incudeでヘッダファイルをコピペする様子を図解してみた

コピペするというと「コピーされるようなイメージってことですよね」と思う方がいますが、違います。本当にファイル内容が、そのままコピペされるんです。

ヘッダファイルがインクルードされる図

では、具体的にヘッダファイルというものが、ソースファイルにコピペされる様子を図示化してお見せしましょう。

実際のヘッダファイルの中身は、ここまでに登場した「マクロ定義」「構造体定義」「プロトタイプ宣言」などいくつかの要素が記述されています。

sub.hにこれらが記載されているとしましょう。このsub.hをmain.cからincludeしてみます。

includeでファイル名を指定することで、対象のファイル内容がincludeした箇所にそっくりそのままコピペされます。

このようにC言語における「ヘッダファイル」とは、

includeによってコピペされるために作られたファイル

なのです。

includeを使う時に知っておくとよいこと

インクルード指定方法の種類

インクルードの指定方法は２種類存在します。次のものです。

#include <ヘッダファイル名>		// ①：標準ライブラリ用ヘッダインクルード
#include "ヘッダファイル名"		// ②：対象システム固有ヘッダインクルード

「stdio.h」といった開発環境に、あらかじめ用意されたヘッダファイルを指定する場合は①。

皆さんが自分で作成したヘッダファイルは②で指定します。

ヘッダファイル以外でもインクルードできる

実は、include機能は拡張子「.h」以外のファイルもインクルードすることが可能です。

例えば「.txt」ファイルや、何だったら「.c」ファイルだろうとインクルードすることができます。

インクルード機能とは指定されたファイルを単にコピペする機能であり、拡張子は実は何でもよいのです。

ただし、C言語ではソースファイルとヘッダファイルの役割が決まっており、その役割に従った上で「ヘッダファイルをインクルードするようにしようね！」という暗黙のルールがあります。

そのため、基本はヘッダファイルをインクルードすることです。ヘッダファイルの役割は、別の記事にて解説しましょう。

「インクルードパス」はファイルを見るけるための検索場所

「プリプロセッサ」はincludeで指定されたファイルを、いったいどこから見つけているのでしょうか？

皆さんの使っているパソコンには、無数のファイルが存在します。

さすがのプリプロセッサも、パソコンの中の全フォルダをいちいち検索していたら、見つけるだけでも時間が掛かってしまいます。

つまり、includeで指定されたヘッダファイルをコピペするためには、そのファイルがどのフォルダにあるかを知らないとできないのです。

そこで登場するのが「インクルードパス」です。

「インクルードパス」とは、プリプロセッサを動かす時に指定するヘッダファイルの存在するフォルダ場所のことです。

つまり、ヘッダファイルのある場所は開発者である皆さんが、本来指定してあげないといけないということです。

VisualStudioではプロジェクトのコンパイラ（C／C++）のプロパティから設定することができます。プリプロセッサはコンパイラツールに内包されているため、設定はコンパイラに対して行います。

「追加のインクルードディレクトリ」の項目が、インクルードパスの設定場所です。

このようにプリプロセッサにヘッダファイルの場所を指定することを「パスを通す」といいます。

パスを指定することで、プリプロセッサはそのフォルダを順に検索し、見つければそのファイルをインクルードします。

パスは複数設定することができますが、先勝ちとなることに注意しましょう。

includeでよく発生するビルドエラー対処法

includeを指定したときにビルドエラーが発生することがあります。

includeの原理や対処方法を身に付けておくと、このような時も冷静に対応することができます。

includeするファイルが見つからないエラー発生時の対処法

ヘッダファイルをインクルードしたときに、次のようなエラーが表示されることがあります。慣れていない方は「うん？何が悪いの？」と戸惑うこともあるでしょう。

fatal error C1083: include ファイルを開けません。'sub.h':No such file or directory

このエラーはinclude指定されたファイルが、見つからない時のエラーメッセージです。次のような観点で疑ってみるとよいでしょう。

疑うべきことその①

includeしようとしているファイルの名前が正しいかを確認しましょう。

ファイル名が間違っているようでは絶対にincludeできません。

疑うべきことその②

インクルードパスが通っていることを確認しましょう。ファイル名が正しくて、このエラーが出ているケースは、ほとんどのケースでインクルードパスが通っていないことが原因です。

統合開発環境を利用している場合は、プロジェクトの中にヘッダファイルが登録されていれば自動でパスが通るはずです。

プロジェクトに対象のヘッダファイルが登録されているかを確認しましょう。

ヘッダファイルは見つかっているが、なぜか目的のヘッダファイルが読み込まれていないような気がする時の対処法

結構稀なのですが、長いこと開発をやっていると、このようなことが起きることがあります。

このような条件が運悪く重なると、「何が起きているんだ？読み込まれているはずなのに、何かがおかしい！」と悩んで時間を浪費することがあります。

こんな時は、ヘッダファイルが正しく読み込まれているかを確認するために、目的のヘッダファイル「sub.h」のファイル名を一時的に「_sub.h」といった別名に変更し、ビルドエラーが発生する細工をします。

この状態でビルドが通るようであれば、意図しない同名ヘッダが読み込まれています。インクルードパスを見直すなどして対処しましょう。

Q&A：includeに関するよくある質問

Q：インクルードの＜ファイル名＞と”ファイル名”は何が違うの？

この２つの違いはヘッダファイルを探しに行く場所が異なります。”ファイル名”の形式の方がより広範囲で検索を掛けてくれます。

よって、次のようにstdio.hを”ファイル名”の形式にしてもビルドは通ります。

#include "stdio.h"

“ファイル名”の形式で指定した場合は、インクルードパスを通したフォルダが検索対象となります。