파일 분할

주제

• C++에서의 파일 분할 구조와 실전 적용 방식이다.
• 특히 함수 선언과 정의의 분리, 헤더 파일과 소스 파일의 연결 구조, 전역 변수의 extern 키워드 활용, 헤더 중복 방지를 위한 #pragma once 및 include guard, 전방 선언(Forward Declaration), 그리고 컴파일 단계의 전체 흐름을 Visual Studio 환경에서의 실제 실습 흐름과 함께 다룬다.
• C++을 활용한 게임 프로그래밍이나 모듈화 개발에서 반드시 숙지해야 할 기초 아키텍처 설계 패턴을 완전하게 설명하는 데 중점을 둔다.

---

개념

✅ 파일 분할이 필요한 이유

• 가독성과 유지보수성 향상: 하나의 파일에 모든 코드를 작성하면 방대해지고, 디버깅이나 유지보수가 어려워진다.
• 협업 최적화: 여러 개발자가 동시에 다른 기능을 개발하기 위해 각자 파일을 분리해 작업 가능.
• 컴파일 시간 절감: 변경된 파일만 다시 컴파일하면 되므로 전체 빌드 속도 개선.
• 모듈화 기반 설계 가능: 구조를 기능별로 나누어 객체지향으로 확장하기 쉬움.

✅ 선언 vs 정의

• 선언(Declaration): 함수나 변수가 존재함을 컴파일러에게 알리는 행위. 헤더(.h) 파일에 작성.
• 정의(Definition): 함수나 변수의 실제 구현 내용. 소스(.cpp) 파일에 작성.

✅ 헤더 파일 보호

• #pragma once: 해당 헤더가 프로젝트 내에서 한 번만 포함되도록 지시함. 현대적이고 간결한 방식.
• include guard (#ifndef, #define, #endif): 오래된 방식이지만 범용성 있음.

✅ extern 키워드

• 전역 변수 외부 참조 선언: 전역 변수의 메모리를 중복 정의하지 않도록 선언과 정의를 분리함.
  • 선언은 extern int var; (보통 .h)
  • 정의는 int var; (보통 .cpp)

✅ 전방 선언 (Forward Declaration)

• 클래스나 구조체를 정의하지 않고 이름만 알려주는 방식.
• 주 목적은 헤더 파일 간의 의존성 줄이기 및 컴파일 속도 최적화.
• 포인터 또는 참조로만 사용하는 경우 전방 선언이 가능.

✅ 컴파일 흐름 요약

1. 전처리 (Preprocessing): #include, #define 등을 처리하고 파일을 합친다.
2. 컴파일 (Compile): C++ 코드를 어셈블리로 변환.
3. 어셈블 (Assemble): 어셈블리 코드를 목적 파일(.obj/.o)로 변환.
4. 링킹 (Linking): 목적 파일들을 연결하여 하나의 실행 파일을 만든다.

---

용어정리

용어	설명
헤더 파일 (.h)	함수/클래스의 선언이 위치한 파일
소스 파일 (.cpp)	함수/클래스의 실제 정의가 위치한 파일
Declaration	함수나 변수가 존재함을 알림
Definition	실제 구현 내용 (메모리 차지 발생)
#pragma once	헤더 중복 포함 방지를 위한 지시문
include guard	#ifndef, #define, #endif 조합으로 헤더 중복 방지
extern	외부 전역 변수 참조 선언
Forward Declaration	정의 없이 이름만 알려주는 선언
링커(Linker)	목적 파일을 결합하여 실행파일 생성
컴파일러	소스 코드를 목적 파일로 변환

---

코드 분석

✅ 1. Helper.h – 선언 파일

#pragma once               // 헤더 중복 방지 (현대적 방식)
void Test(int);           // 함수 선언
void Test2();             // 함수 선언
extern int GTest;         // 전역 변수 extern 선언

• #pragma once: 이 파일이 여러 번 포함되어도 한 번만 처리됨.
• extern int GTest: GTest는 정의되지 않았으며, 다른 파일에서 정의될 것임을 의미.

✅ 2. Helper.cpp – 정의 파일

#include "Helper.h"
#include <iostream>
using namespace std;

int GTest;                  // 실제 메모리 공간이 할당되는 정의

void Test(int)
{
    Test2();                // 내부 함수 호출
}

void Test2()
{
    cout << "Hello World" << endl;  // 출력
}

• #include "Helper.h"로 선언 정보를 포함.
• Test()는 Test2()를 호출하는 구조.
• GTest는 정의이므로, 실제 메모리를 차지한다.

✅ 3. GameCoding.cpp – main 파일

#include <iostream>
#include "Helper.h"
using namespace std;

int main()
{
    GTest = 100;         // extern 선언된 전역 변수에 값 할당
    Test2();             // 함수 실행
    return 0;
}

• Helper.h를 통해 extern 변수와 함수 선언을 포함.
• 실제 정의는 Helper.cpp에 존재하므로, 링커가 연결함.

✅ 4. include guard 방식 예시 (전통 방식)

#ifndef __HELPER_H__
#define __HELPER_H__

void Test(int);
void Test2();

#endif

• __HELPER_H__는 중복 포함 방지를 위한 매크로 이름.
• 현재는 #pragma once가 간편하고 추천됨.

✅ 5. 전방 선언 예시

class MyClass;                     // 전방 선언
void doSomething(MyClass* obj);   // 정의 없이 포인터 사용 가능

• MyClass가 아직 정의되지 않았지만, 포인터는 사용 가능.
• MyClass의 내부 멤버를 사용하려면 정의가 필요함 (#include "MyClass.h")

---

핵심

• C++에서의 파일 분할은 유지보수성, 협업, 확장성, 성능 최적화 측면에서 필수적인 개발 기법이다.
• 함수/클래스는 선언을 헤더(.h), 정의는 소스(.cpp)에 나누어 작성해야 다른 파일 간 의존성이 줄어들고 링커 오류를 방지할 수 있다.
• #pragma once 혹은 include guard를 사용하여 헤더 파일 중복 포함으로 인한 컴파일 오류를 예방한다.
• extern을 활용하면 전역 변수나 함수의 참조를 여러 파일에서 안전하게 공유할 수 있으며, 컴파일 타임 충돌을 막고 메모리도 효율적으로 관리된다.
• Visual Studio는 .h/.cpp 짝 생성, 클래스 추가, 새 항목 생성 기능을 통해 구조적인 설계를 수월하게 지원하며, 실습과 함께 설계 개념을 쉽게 익힐 수 있는 환경이다.

---