[C/C++ Tip] 16. Extern 중복 문제 해결 (Include Guard)

C언어 extern (중급)

C언어에서 헤더 파일의 중복 포함은 다양한 문제를 일으킬 수 있다. 예를 들어, 프로젝트 단위가 커져 같은 헤더 파일이 여러 번 포함되면 변수나 함수 선언이 중복되어 컴파일 오류가 발생할 수 있다. 이를 방지하기 위해 "Include Guard"라는 기법이 널리 사용된다. Include Guard는 전처리기(preprocessor) 지시문을 사용하여 헤더 파일이 한 번만 포함되도록 보장한다. 가장 일반적인 방법은 #ifndef, #define, #endif 지시문을 사용하는 것이다.

• 중복 포함 방지: 헤더 파일이 여러 번 포함되는 것을 방지하여, 중복 선언으로 인한 컴파일 오류를 예방한다.
• 프로그램 구조 개선: 코드의 모듈화와 재사용성을 높이며, 프로그램의 구조를 명확하게 한다.
• 컴파일 시간 단축: 불필요한 헤더 파일의 재처리를 방지함으로써, 전체 컴파일 시간을 단축할 수 있다.

⭐코드

다음은 Include Guard를 사용한 헤더 파일의 예시이다.

myheader.h

#ifndef MYHEADER_H // MYHEADER_H가 정의되지 않았다면
#define MYHEADER_H // MYHEADER_H를 정의

// 여기에 함수 선언, 타입 정의, 매크로 정의 등을 포함
extern int sharedVariable;

void myFunction();

#endif // MYHEADER_H의 끝

main.c

#include "myheader.h" // 첫 번째 포함
#include "myheader.h" // 두 번째 포함 - Include Guard에 의해 실제로는 무시됨

int main() {
    sharedVariable = 5;
    myFunction();
    return 0;
}

이 예시에서 myheader.h 헤더 파일은 Include Guard에 의해 한 번만 포함된다. 만약 main.c 또는 다른 파일에서 myheader.h를 여러 번 포함하더라도, MYHEADER_H 매크로가 이미 정의되어 있기 때문에 헤더 파일의 내용이 중복으로 처리되지 않는다.

• 헤더 파일 이름을 기반으로 한 고유한 매크로 사용: Include Guard를 위한 매크로 이름으로 파일 이름을 기반으로 한 고유한 이름을 사용하면 이름 충돌을 방지할 수 있다.
• 프로젝트 전체에서 일관된 규칙 적용: 모든 헤더 파일에 대해 일관된 Include Guard 규칙을 적용하여 코드의 일관성을 유지해야 한다.
• 모던 C++에서는 #pragma once 고려: C++에서는 #pragma once 지시문을 사용하는 것도 하나의 옵션이다. 이 지시문은 헤더 파일이 한 번만 포함되도록 하는 간단하고 효율적인 방법을 제공하지만, C에서는 표준이 아니며, 모든 컴파일러에서 지원되는 것은 아니다.

Include Guard는 C 프로그래밍에서 코드를 안정적으로 관리하는 데 필수적인 기법이다. 이를 통해 프로그램의 안정성을 높이고 컴파일 오류를 방지할 수 있다.