C 언어 전처리기와 매크로 완벽 가이드

C 전처리기(Preprocessor)는 컴파일러의 일부가 아니라, 컴파일 과정에서 별도의 단계로 수행되는 도구입니다. 쉽게 말해 C 전처리기는 단순한 텍스트 치환 도구로서, 실제 컴파일이 시작되기 전에 필요한 사전 처리 작업을 컴파일러에 지시하는 역할을 합니다. 이 문서에서는 편의상 C 전처리기를 CPP라고 부르겠습니다.

전처리기 지시문의 기본 규칙

모든 전처리기 명령어는 해시 기호(#)로 시작합니다. #은 반드시 해당 줄에서 공백이 아닌 첫 번째 문자여야 하며, 가독성을 위해 전처리기 지시문은 가능하면 줄의 맨 앞 열에서 시작하는 것이 좋습니다.

아래 표는 자주 사용되는 중요한 전처리기 지시문들을 정리한 것입니다.

전처리기 지시문 활용 예제

다음 예제들을 통해 각 지시문이 실제로 어떻게 동작하는지 살펴보겠습니다.

#define — 상수 매크로 정의

#define MAX_ARRAY_LENGTH 20

이 지시문은 CPP에게 코드 내 모든 MAX_ARRAY_LENGTH를 20으로 치환하도록 지시합니다. 상수를 #define으로 정의하면 코드의 가독성과 유지보수성이 크게 향상됩니다.

#include — 헤더 파일 포함

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

첫 번째 줄은 CPP에게 시스템 라이브러리(System Libraries)에서 stdio.h를 찾아 그 내용을 현재 소스 파일에 추가하도록 합니다. 두 번째 줄은 myheader.h를 로컬 디렉터리에서 찾아 그 내용을 현재 소스 파일에 포함하라는 의미입니다.

#undef와 #define — 매크로 재정의

#undef FILE_SIZE
#define FILE_SIZE 42

이 코드는 기존에 정의된 FILE_SIZE를 먼저 해제한 후, 새롭게 42로 정의합니다.

#ifndef — 조건부 매크로 정의

#ifndef MESSAGE
#define MESSAGE "You wish!"
#endif

이 지시문은 MESSAGE가 아직 정의되어 있지 않은 경우에만 MESSAGE를 정의하도록 합니다. 헤더 파일의 중복 포함을 방지할 때 매우 유용하게 사용됩니다.

#ifdef — 디버깅 코드 제어

#ifdef DEBUG
/* 여기에 디버깅용 코드를 작성합니다 */
#endif

이 지시문은 DEBUG가 정의되어 있을 때만 감싸진 문장들을 처리합니다. gcc 컴파일 시 -DDEBUG 플래그를 전달하면 DEBUG가 정의되므로, 컴파일 단계에서 디버깅 코드를 손쉽게 켜고 끌 수 있습니다.

사전 정의된 매크로(Predefined Macros)

ANSI C는 프로그래밍에서 바로 사용할 수 있는 여러 개의 매크로를 미리 정의해 두고 있습니다. 다만 이 매크로들은 직접 수정해서는 안 됩니다.

예제 코드

다음 예제는 위에서 소개한 사전 정의 매크로들을 실제로 출력하는 프로그램입니다.

#include <stdio.h>
int main() {
    printf("File :%s\n", __FILE__ );
    printf("Date :%s\n", __DATE__ );
    printf("Time :%s\n", __TIME__ );
    printf("Line :%d\n", __LINE__ );
    printf("ANSI :%d\n", __STDC__ );
}

실행 결과

File :test.c
Date :Jun 2 2012
Time :03:36:24
Line :8
ANSI :1

이처럼 C 전처리기는 매크로 정의, 헤더 포함, 조건부 컴파일 등을 통해 코드의 유연성과 관리 효율을 높여주는 강력한 도구입니다. 각 지시문의 특성을 잘 이해하고 활용하면 더 깔끔하고 유지보수하기 쉬운 C 코드를 작성할 수 있습니다.