# ヘッダーガード

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

[ヘッダーガード(英語)](https://en.wikipedia.org/wiki/Include_guard)は、ヘッダーが複数回インクルードされるのを防ぐプリプロセッサーディレクティブのパターンです。 ヘッダーガードは、コードの内容全体を  `#ifndef`  （  `#if !defined`  などの）ブロックにラップします。

```CPLUSPLUS
#ifndef MY_HEADER_H
#define MY_HEADER_H
    //...
#endif

```

Procedure: ヘッダーファイルテンプレートを編集する

デフォルトで、ヘッダーガードは新しいヘッダーの初期内容を指定する [ファイルテンプレート](using-file-and-code-templates.html)に含まれています。 たとえば、ヘッダーガードの代わりに [#pragma once(英語)](https://en.wikipedia.org/wiki/Pragma_once) を使用することにした場合は、これらのテンプレートを編集できます。 これについては、  `設定 | エディター | ファイルおよびコードテンプレート`  に移動し、   ファイル   タブを開いてください。 リストから    C ヘッダーファイル    または    C++ クラスヘッダーファイル    を選択し、テンプレートの内容を変更します。

![ファイルテンプレートのヘッダーガード](https://resources.jetbrains.com/help/img/idea/2026.3/cl_headerguard_filetemplate.png)

[リテラル](http://velocity.apache.org/engine/1.7/user-guide.html#literals)構文で  `#pragma once` を折り返していることに注意してください。 ファイルテンプレートには、CLionが [Apache Velocity](http://velocity.apache.org/engine/devel/user-guide.html#Velocity_Template_Language_VTL:_An_Introduction)言語を使用しており、これによりC/C++のプリプロセッサディレクティブを正しく解析するためにエスケープが必要です。

Procedure: ヘッダーガードシンボルを設定する

1. ヘッダーガードシンボル（上の例の  `MY_HEADER_H`  ）は一意である必要があるため、通常はファイル名に関連しています。 ヘッダーガードシンボルのパターンを設定するには、  `設定 | エディター | コードスタイル | C/C++` の [命名規則](naming-conventions.html)タブを開き、   ヘッダーガード  フィールドにテンプレートを指定してください：

![命名規則設定のヘッダー保護フィールド](https://resources.jetbrains.com/help/img/idea/2026.3/header.h` の場合、 `${PROJECT_REL_PATH}` は `src/dir` と等しくなります。

* `${FILE_NAME}` - 拡張子のないターゲットファイル名

* `${EXT}` - ターゲットファイルの拡張子。

* [ファイルテンプレート](file-template-variables.html#predefined_template_variables)で使用できる他の変数には、 `${USER}` や `${DATE}` などがあります。

有効なヘッダーガードシンボル   次の文字を含めることができます  ：大文字の  `'A-Z'`  小文字の  `'a-z'`  の各文字、アンダースコア記号  `_` 、数字（ただし数字で始めることはできません）、およびドル記号  `$` が利用できます。 CLion は、数字で始まるシンボルに  `INC_`  接頭辞を追加し、  `INC_${UUID}`  パターンを使用して無効なシンボルを置き換えます。

3. 構成されたシンボルは、ヘッダーテンプレートの  `${INCLUDE_GUARD}`  変数を置き換えます。 CLion は、新しい C/C++ クラスとヘッダーファイルを   作成中   ときにパターンを適用します。 また、クラスやファイルの [名前を変更](rename-refactorings.html)すると、現在設定されているスタイルに一致するヘッダーガードが新しい名前で更新されます。

![automatic changes in header guard template for file rename](https://resources.jetbrains.com/help/img/idea/2026.3/cl_headerguard_rename.animated.gif)

