ソースファイルのインクルード

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

技術仕様書

 

C++言語

一般的なトピック
プリプロセッサ コメント	キーワード エスケープシーケンス
フロー制御
条件付き実行文
if	switch
繰り返し文 (ループ)
for range-for (C++11)	while do-while
ジャンプ文
continue - break	goto - return
関数
関数宣言
ラムダ関数宣言
inline 指定子
例外指定 (C++20未満)
noexcept 指定子 (C++11)
例外
throw 式	try-catch ブロック
名前空間
名前空間宣言	名前空間エイリアス
åž‹
基本型 列挙型 関数型	複合型 共用体型
指定子
decltype (C++11) auto (C++11) alignas (C++11)	const/volatile constexpr (C++11)
記憶域期間指定子
初期化
デフォルト初期化 値初期化 ゼロ初期化 コピー初期化 直接初期化	集成体初期化 リスト初期化 (C++11) 定数初期化 参照初期化

式
値カテゴリ 評価順序	演算子 演算子の優先順位
代替表現
リテラル
ブーリアン - 整数 - 浮動小数点
文字 - 文字列 - nullptr (C++11)
ユーザ定義 (C++11)
ユーティリティ
属性 (C++11)
åž‹
typedef 宣言
型エイリアス宣言 (C++11)
キャスト
暗黙の変換 - 明示的な変換
static_cast - dynamic_cast
const_cast - reinterpret_cast
メモリ確保
new 式	delete 式
クラス
クラス宣言 コンストラクタ this ポインタ	アクセス指定子 friend 指定子
クラス固有の関数特性
仮想関数 override 指定子 (C++11) final 指定子 (C++11)	explicit (C++11) static
特別なメンバ関数
デフォルトコンストラクタ コピーコンストラクタ ムーブコンストラクタ (C++11)	コピー代入 ムーブ代入 (C++11) デストラクタ
テンプレート
クラステンプレート 関数テンプレート	テンプレートの特殊化 パラメータパック (C++11)
その他
インラインアセンブリ	C++ の歴史

 

プリプロセッサ

#if#ifdef#ifndef#else#elif#endif

#define#undef#,## 演算子

#include__has_include(C++17)

#error

#pragma_Pragma(C++11)

#line

 

現在のソースファイルの指令の直後の行に他のソースファイルをインクルードします。

構文

#include <filename>	(1)
#include "filename"	(2)
__has_include ( " filename " ) __has_include ( < filename > )	(3)	(C++17以上)

任意のプリプロセッサトークン (マクロ定数または式) は、 < > または " " によって囲まれた文字の並びに展開される限り、 #include および __has_include (C++17以上) への引数として認められます。

説明

1,2) 現在のソースファイルの指令の直後の行に filename によって表されるソースファイルをインクルードします。 ファイルが見つからない場合、プログラムは ill-formed です。

1) ファイルを処理系定義の方法で検索します。 この構文の意図は処理系の制御下にあるファイルを検索することです。 一般的な処理系は標準のインクルードディレクトリのみを検索します。 標準 C++ ライブラリおよび標準 C ライブラリはこれら標準のインクルードディレクトリに暗黙に含まれます。 標準のインクルードディレクトリは、通常、コンパイラオプションを通してユーザが制御できます。

2) ファイルを処理系定義の方法で検索します。 この構文の意図は処理系の制御下にないファイルを検索することです。 一般的な処理系は現在のファイルが存在するディレクトリをまず検索し、見つからなかった場合にのみ、 (1) と同様に標準のインクルードディレクトリを検索します。

3) ファイル名が見つかった場合は 1、そうでなければ ​0​ に評価されるプリプロセッサ定数式。 引数が #include 指令に対する有効な引数でなければ、プログラムは ill-formed です。

ノート

ファイルがインクルードされるとき、それは翻訳フェーズ1〜4で処理されます。 ネストした #include の展開を再帰的に含むこともあります。 同じファイルのインクルードの繰り返しや自分自身をインクルードしたときの無限再帰を回避するため、ヘッダガードがよく使用されます。 ヘッダ全体が以下のようにラップされます。

#ifndef FOO_H_INCLUDED /* ファイル名に対応する任意の一意な名前 */
#define FOO_H_INCLUDED
// ここにファイルの内容を書きます
#endif

多くのコンパイラは同様の効果を持つ非標準のプラグマ #pragma once も実装しています。 これは、同じファイル (ファイルの同一性は OS 固有の方法で決定されます) がすでにインクルードされている場合に、ファイルの処理を無効化します。

__has_include の結果が 1 であることは、指定された名前のヘッダまたはソースファイルが存在することを意味するだけです。 インクルードしたときにエラーが発生しないとか、何か役に立つものを含んでいるといったことは意味しません。 例えば、 C++14 と C++17 の両方のモードをサポートする (そして準拠した拡張として C++14 モードで __has_include を提供する) 処理系において、 C++14 モードで __has_include(<optional>) は 1 になるかもしれませんが、実際には #include <optional> はエラーを発生するかもしれません。

例

Run this code

#if __has_include(<optional>)
#  include <optional>
#  define have_optional 1
#elif __has_include(<experimental/optional>)
#  include <experimental/optional>
#  define have_optional 1
#  define experimental_optional 1
#else
#  define have_optional 0
#endif
 
#include <iostream>
 
int main()
{
    if (have_optional)
        std::cout << "<optional> is present.\n";
 
    int x = 42;
#if have_optional == 1
    std::optional<int> i = x;
#else
    int* i = &x;
#endif
    std::cout << "i = " << *i << '\n';
}

出力例:

<optional> is present.
i = 42

関連項目

cpp/header	C++ 標準ライブラリのヘッダファイルの一覧
ソースファイルのインクルード の C言語リファレンス