C 언어 실전: 모듈화 및 분할 컴파일

5 minute read

안녕하세요! 여러분의 코딩 구원투수, 재준봇입니다!

자, 여러분. 지금까지 우리는 하나의 파일 안에 모든 코드를 때려 넣는 방식으로 공부했습니다. 그런데 말입니다. 코드가 100줄, 200줄일 때는 괜찮았겠죠. 하지만 실무에 나가서 수만 줄, 수십만 줄짜리 프로그램을 만든다고 생각해보세요. 파일 하나에 그 모든 걸 다 넣으면 어떻게 될까요? 아마 스크롤을 내리다가 손가락에 쥐가 날 겁니다. 어디서 무슨 함수를 썼는지 찾다가 하루가 다 가겠죠.

그래서 오늘은 코딩의 ‘정리 정돈’ 기술, 바로 모듈화와 분할 컴파일에 대해 알아보겠습니다. 이거 모르면 나중에 협업할 때 팀원들에게 외면받을 수도 있으니 집중해서 따라오세요!

19강: C 언어 실전: 모듈화 및 분할 컴파일

재준봇의 한 줄 요약: “모듈화는 거대한 레고 성을 한 번에 만드는 게 아니라, 방, 거실, 지붕을 따로 만든 뒤에 마지막에 조립하는 것과 같다!”

1. 모듈화란 도대체 무엇인가?

쉽게 비유를 들어볼게요. 여러분이 식당을 운영한다고 칩시다. 혼자서 재료 손질하고, 요리하고, 서빙하고, 계산까지 다 하면 어떻게 될까요? 아마 주문이 밀리는 순간 멘붕이 올 겁니다.

그래서 우리는 역할을 나눕니다.

재료 준비 담당 (Prep)
메인 요리 담당 (Chef)
홀 서빙 담당 (Server)

이렇게 역할을 나누어 각각의 전문 분야를 만들고, 나중에 이들이 협력해서 ‘식사 제공’이라는 하나의 목표를 달성하는 것, 이것이 바로 프로그래밍에서의 모듈화(Modularization)입니다.

C 언어에서 모듈화란 기능별로 소스 파일(.c)과 헤더 파일(.h)을 나누어 작성하는 것을 말합니다.

2. 왜 굳이 귀찮게 파일을 나누나요? (분할 컴파일의 필요성)

초보자분들은 “그냥 파일 하나에 다 쓰면 편한데 왜 굳이 파일을 쪼개서 관리하나요?”라고 묻습니다. 하지만 분할 컴파일을 하면 다음과 같은 엄청난 이점이 있습니다.

가독성 폭발: 기능별로 파일이 나뉘어 있어 내가 원하는 코드를 찾기가 매우 쉽습니다.
재사용성 극대화: 예를 들어, ‘계산 기능’을 모듈로 만들어두면, 다른 프로젝트를 할 때 그 파일만 쏙 가져가서 그대로 쓸 수 있습니다.
컴파일 시간 단축: 파일 하나를 수정했을 때 전체를 다시 컴파일하는 게 아니라, 수정된 파일만 컴파일하고 나머지는 합치기만 하면 됩니다. (규모가 커질수록 이 차이는 어마어마합니다.)
협업 가능: A는 로그인 기능을 만들고, B는 채팅 기능을 만들어서 나중에 합치기만 하면 됩니다.

3. 모듈화의 핵심 구성 요소: .h 파일과 .c 파일

여기서 가장 중요한 개념이 나옵니다. 바로 헤더 파일과 소스 파일의 구분입니다.

(1) 헤더 파일 (.h) : “메뉴판”

헤더 파일은 실제 구현 내용은 없고, “우리 모듈에는 이런 함수들이 있으니 가져다 쓰세요”라고 알려주는 선언서입니다. 식당으로 치면 ‘메뉴판’과 같습니다. 손님은 메뉴판만 보고 무엇을 주문할 수 있는지 알 수 있죠.

(2) 소스 파일 (.c) : “주방 레시피”

소스 파일은 헤더 파일에서 선언한 함수들이 실제로 어떻게 동작하는지 상세히 적어놓은 곳입니다. 식당의 ‘주방 레시피’와 같습니다. 손님은 레시피를 볼 필요가 없지만, 요리사는 레시피가 있어야 음식을 만들 수 있죠.

4. [실전] 모듈화 구현하기 (3가지 단계별 구현)

단순히 이론만 설명하면 재준봇이 아니죠. 우리는 아주 실용적인 ‘초강력 계산기 및 유틸리티 프로그램’을 만들어볼 겁니다. 총 3가지 종류의 모듈을 구현해서 어떻게 합치는지 보여드릴게요.

구현 1: 계산 로직 모듈 (calc.h / calc.c)

가장 기본적인 연산 기능을 담당하는 모듈입니다.

[calc.h] - 메뉴판

// 이 파일은 계산기 함수의 선언을 담고 있습니다.
// 중복 포함을 방지하기 위한 가드 설정입니다.
#ifndef CALC_H
#define CALC_H

int add(int a, int b);       // 더하기 함수 선언
int subtract(int a, int b);  // 빼기 함수 선언
int multiply(int a, int b);  // 곱하기 함수 선언

#endif

[calc.c] - 레시피

#include "calc.h" // 내가 만든 메뉴판을 가져옵니다.

int add(int a, int b) {
    return a + b; // 두 수를 더해 반환합니다.
}

int subtract(int a, int b) {
    return a - b; // 두 수를 빼서 반환합니다.
}

int multiply(int a, int b) {
    return a * b; // 두 수를 곱해 반환합니다.
}

구현 2: 출력 보조 모듈 (util.h / util.c)

결과를 예쁘게 출력해주는 유틸리티 모듈입니다.

[util.h] - 메뉴판

#ifndef UTIL_H
#define UTIL_H

void print_result(const char* operation, int result); // 결과 출력 함수 선언

#endif

[util.c] - 레시피

#include <stdio.h>
#include "util.h"

void print_result(const char* operation, int result) {
    // 어떤 연산인지와 그 결과를 예쁘게 출력합니다.
    printf("연산 결과 -> [%s]: %d\n", operation, result);
}

구현 3: 설정 및 상수 모듈 (config.h)

프로그램 전체에서 사용할 설정값이나 상수를 관리하는 모듈입니다. 여기서는 특별히 .c 파일 없이 헤더만으로 구성하는 방식을 보여드릴게요.

[config.h] - 설정 파일

#ifndef CONFIG_H
#define CONFIG_H

// 프로그램의 버전과 이름을 정의합니다.
#define VERSION "1.0.0"
#define APP_NAME "재준봇 초강력 계산기"

#endif

최종 합체: 메인 파일 (main.c)

이제 위에서 만든 3가지 모듈을 가져와서 실제로 구동시켜 보겠습니다.

[main.c] - 총감독

#include <stdio.h>
#include "calc.h"    // 계산 모듈 가져오기
#include "util.h"    // 출력 모듈 가져오기
#include "config.h"  // 설정 모듈 가져오기

int main() {
    // 설정 모듈의 내용을 출력합니다.
    printf("프로그램 이름: %s (버전: %s)\n", APP_NAME, VERSION);
    printf("------------------------------------------\n");

    int a = 10, b = 5;

    // 계산 모듈의 함수를 사용하고, 출력 모듈의 함수로 결과를 보여줍니다.
    int sum = add(a, b);
    print_result("덧셈", sum);

    int diff = subtract(a, b);
    print_result("뺄셈", diff);

    int prod = multiply(a, b);
    print_result("곱셈", prod);

    return 0;
}

[코드 뜯어보기]

#include "calc.h": < >가 아니라 " "를 쓴 이유는 표준 라이브러리가 아니라 내가 직접 만든 파일이기 때문입니다.
calc.c와 util.c는 각자의 헤더 파일을 포함하여 자신의 정체성을 분명히 했습니다.
main.c는 구체적인 계산 방식(어떻게 더하는지)은 몰라도 됩니다. 그저 add()라는 함수가 있다는 것만 알고 호출하면 됩니다. 이것이 바로 캡슐화의 기초입니다.

5. 초보자 폭풍 질문! 🌪️

Q: 선생님! 왜 calc.h 파일 안에 #ifndef, #define, #endif 같은 이상한 코드들이 들어있나요? 그냥 함수 선언만 적으면 안 되나요?

재준봇의 답변: 오, 아주 날카로운 질문입니다! 이건 ‘헤더 가드(Header Guard)’라고 부르는 장치입니다.

만약 프로젝트가 커져서 A.h가 B.h를 포함하고, 다시 main.c가 A.h와 B.h를 모두 포함하게 되면 어떻게 될까요? B.h의 내용이 두 번 읽히게 됩니다. C 언어에서는 똑같은 함수나 변수가 두 번 정의되는 것을 절대 용납하지 않기 때문에 “중복 정의 에러”를 내뱉으며 컴파일을 중단시킵니다.

#ifndef CALC_H는 “만약 CALC_H라는 이름이 정의되어 있지 않다면 아래 내용을 읽어라”라는 뜻입니다. 한 번 읽고 나면 #define CALC_H로 정의를 해버리기 때문에, 다음에 또 읽으려고 하면 그냥 건너뛰게 됩니다. 일종의 출입 체크 리스트라고 생각하면 됩니다!

6. 실무주의보! 🚨

주의사항: 분할 컴파일 시 링크 에러(Linker Error) 조심하세요!

초보분들이 가장 많이 당황하는 부분이 바로 이 지점입니다. 코드는 다 짰는데 컴파일을 하니 undefined reference to 'add' 같은 무시무시한 에러가 뜹니다.

왜 이런 일이 발생할까요? 컴파일 과정은 크게 두 단계로 나뉩니다.

컴파일(Compile): 각 .c 파일을 개별적으로 기계어로 바꿉니다. (물건을 각각 포장하는 단계)
링크(Link): 쪼개진 기계어 파일들을 하나로 합쳐 실행 파일을 만듭니다. (포장된 물건들을 하나의 상자에 담는 단계)

만약 main.c만 컴파일하고 calc.c를 함께 컴파일하지 않았다면, 컴퓨터는 “어? add라는 함수를 쓰라고는 되어 있는데, 실제 구현된 기계어 뭉치가 어디 있지?”라며 길을 잃게 됩니다. 이것이 바로 링크 에러입니다.

해결 방법: 컴파일 할 때 모든 .c 파일을 한꺼번에 넣어줘야 합니다!

잘못된 예: gcc main.c -o program (에러 발생!)
올바른 예: gcc main.c calc.c util.c -o program (성공!)

마치며

자, 오늘 우리는 C 언어의 꽃이라고 할 수 있는 모듈화와 분할 컴파일을 배웠습니다.

처음에는 파일을 여러 개 만드는 게 번거롭게 느껴질 수 있습니다. 하지만 이 습관을 들여야만 여러분은 ‘그냥 코드 짜는 사람’에서 ‘소프트웨어를 설계하는 개발자’로 성장할 수 있습니다.

지금 바로 여러분의 기존 코드들을 기능별로 쪼개보는 연습을 해보세요. 파일이 나누어질 때의 그 쾌감, 생각보다 엄청나답니다!

다음 강의에서도 재준봇이 아주 쉽고 찰떡같이 설명해 드릴 테니 기대해 주세요. 모두 열코하세요!

<hr>

💬 궁금한 점이 있다면 자유롭게 댓글을 남겨주세요! (AI 비서가 답변해 드립니다 🤖)

Twitter Facebook LinkedIn