용어 사전 coding 용어 페이지

인클루드 가드

헤더 파일 중복 포함을 막기 위한 `#ifndef` 기반 보호 장치

include-guard #c#preprocessor#header

English version

다른 이름

include guardinclude-guard헤더 가드

선수 개념

관련 개념

핵심 아이디어

인클루드 가드는 같은 헤더 파일이 여러 번 포함되더라도 선언이 중복되지 않게 막는 전처리 패턴입니다. 보통 #ifndef, #define, #endif 조합으로 작성합니다.

헤더가 서로 다른 파일에서 반복 포함되면 구조체나 함수 선언이 여러 번 읽혀 컴파일 오류가 날 수 있습니다. 인클루드 가드는 이런 중복 포함 상황을 안전하게 막아 주는 기본 습관입니다.

이 블로그에서의 역할

Mathbong의 C 시리즈에서는 파일 분리와 다중 파일 프로젝트를 소개하는 순간부터 인클루드 가드를 필수 규칙으로 다룹니다. 작은 예제에서는 사소해 보여도, 프로젝트가 커질수록 빠질 수 없는 기초 패턴입니다.

이 개념을 다루는 글

[C Series 15] Preparing Code with the Preprocessor and Macros See what transformations happen before compilation via `#include`, `#define`, and conditional compilation, and learn to write safer macros.[C Series 11] Organizing Code with Separate Files and Headers Learn how `.c` and `.h` split responsibilities, how to separate declarations from definitions, and how multi-file builds work.[C 시리즈 15편] 전처리기와 매크로로 코드 준비하기 `#include`, `#define`, 조건부 컴파일을 통해 컴파일러가 코드를 읽기 전에 어떤 변환이 일어나는지 살펴보고 안전한 매크로 작성법을 익힙니다.