[헤더파일(.h)] 헤더가드

📌 헤더가드

#ifndef, #define, #endif는 헤더 가드(header guard)라고 부른다.

C 언어에서 중복 포함 방지를 위해 사용하는 매크로이다.

같은 헤더 파일이 여러 번 포함될 때 발생하는 오류를 방지하기 위해서 사용한다.

헤더 가드가 없는 경우

ft.h라는 헤더 파일이 있고, 두 개의 C 파일에서 이를 포함했다고 가정해보자.

 

ft.h

void ft_putchar(char c);

a.c

#include "ft.h"

b.c

#include "ft.h"

 

만약 main.c에서 #include "a.c"와 #include "b.c"를 한다면, ft.h가 두 번 포함된다.

C 컴파일러는 동일한 함수 선언을 두 번 읽어들이게 되어서 오류가 발생할 수 있다.

#ifndef, #define, #endif는 이런 중복 문제를 방지해준다.

 

 

헤더 가드의 구조

#ifndef FT_H   // FT_H가 정의되어 있지 않으면
# define FT_H  // FT_H를 정의하고 아래 내용을 포함
    void ft_putchar(char c);
    void ft_swap(int *a, int *b);
    // ... 나머지 함수 선언
#endif          // 여기서 끝

1. #ifndef FT_H: FT_H라는 매크로가 정의되어 있는지 확인한다.
   • 정의되어 있지 않으면 #define FT_H를 실행하고 그 아래 내용을 읽어들인다.
   • 정의되어 있다면 중복 포함을 방지하고 넘어간다.
2. #define FT_H: FT_H라는 이름을 정의한다.
   • 이렇게 하면 이후 이 파일이 다시 포함되더라도 FT_H가 이미 정의되어 있으니 중복되지 않는다.
3. #endif: 조건문을 끝낸다.

 

헤더 가드 없이 #pragma once 사용

더 간단하게 #pragma once로도 중복 포함을 방지할 수 있다. (오래된 컴파일러에서는 지원이 안 될 수도 있다.)

#pragma once
void ft_putchar(char c);
void ft_swap(int *a, int *b);

 

📌 #define에서 괄호 작성

괄호 없이 썼을 때 발생할 수 있는 문제

#define EVEN(n) n % 2 == 0  // 괄호 없음

이렇게 정의하고 나서 아래와 같은 코드를 작성한다고 가정해보자.

if (EVEN(a + 1)) {
    ft_putstr("Even\n");
}

이 코드는 EVEN(a + 1)을 매크로 확장할 때 이렇게 변한다.

if (a + 1 % 2 == 0) {
    ft_putstr("Even\n");
}

🚨 문제점

• 산술 연산자 우선순위 때문에 1 % 2가 먼저 계산돼서 a + 1 % 2가 된다.
• 즉, (a + 1) % 2과 다른 결과값이 나온다.

 

괄호를 썼을 때

#define EVEN(n) ((n) % 2 == 0)

이렇게 괄호를 사용하면 우선순위가 명확해진다.

(a + 1) 전체가 % 2로 나눠진 후 == 0 비교가 이루어진다.

이렇듯, 매크로는 함수처럼 보이지만 단순 치환이다.

그래서 우선순위 헷갈리는 실수를 막기 위해 모든 변수와 표현식을 괄호로 감싸야한다.