C/C++の#include と#include "filename"の違いを徹底解説

C/C++プログラミングにおいて、ヘッダーファイルを読み込む際に使われる#includeディレクティブには、#include <filename>と#include "filename"という2つの記述形式があります。一見似ているこの2つですが、その違いはプリプロセッサがインクルード対象のファイルを検索する場所にあります。

#include <filename> の場合

山括弧（< >）で囲んだ形式では、プリプロセッサは実装依存の方法でファイルを検索します。具体的には、コンパイラがあらかじめ設定している標準インクルードディレクトリ（システムのヘッダーファイルが格納されたディレクトリなど）の中から対象ファイルを探します。

この形式は、標準ライブラリのヘッダーファイルをインクルードする際に一般的に使用されます。

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

#include "filename" の場合

ダブルクォーテーション（" "）で囲んだ形式では、プリプロセッサはまずそのディレクティブが記述されているファイルと同じディレクトリ内を検索します。そこでファイルが見つからなかった場合は、#include <filename>形式と同じ動作に切り替わり、コンパイラが指定したディレクトリの検索へと移行します。

この形式は、開発者自身が作成したヘッダーファイルをインクルードする際に一般的に使用されます。

#include "myheader.h"
#include "utils/config.h"

使い分けのポイント

一般的なガイドラインとして、以下のように使い分けるのが推奨されます。

• 標準ライブラリや外部ライブラリのヘッダー → #include <filename>
• プロジェクト内の自作ヘッダー → #include "filename"

この使い分けにより、コードの意図が明確になり、意図しないファイルが読み込まれるリスクも減らせます。また、ビルドの検索パス設定を整理する際にも、どちらの形式を使っているかが重要な手がかりになります。

まとめ

両者の違いを簡単にまとめると、#include <filename>はコンパイラが指定したディレクトリのみを検索するのに対し、#include "filename"はまずカレントディレクトリを検索し、見つからなければ山括弧形式と同じ検索を行う、という点です。適切に使い分けることで、可読性が高く保守しやすいコードになります。