C++
헤더 파일

비고

기본 예제

다음 예는 // filename 주석으로 표시되는 여러 소스 파일로 분할 될 코드 블록을 포함합니다.

소스 파일

// my_function.h

/* Note how this header contains only a declaration of a function.
 * Header functions usually do not define implementations for declarations
 * unless code must be further processed at compile time, as in templates.
 */

/* Also, usually header files include preprocessor guards so that every header
 * is never included twice.
 *
 * The guard is implemented by checking if a header-file unique preprocessor
 * token is defined, and only including the header if it hasn't been included
 * once before.
 */
#ifndef MY_FUNCTION_H
#define MY_FUNCTION_H

// global_value and my_function() will be
// recognized as the same constructs if this header is included by different files.
const int global_value = 42;
int my_function();

#endif // MY_FUNCTION_H

// my_function.cpp

/* Note how the corresponding source file for the header includes the interface  
 * defined in the header so that the compiler is aware of what the source file is 
 * implementing.
 *
 * In this case, the source file requires knowledge of the global constant
 * global_value only defined in my_function.h. Without inclusion of the header
 * file, this source file would not compile.
 */
#include "my_function.h" // or #include "my_function.hpp"
int my_function() {
  return global_value; // return 42;
}

헤더 파일은 헤더 인터페이스에 의해 정의 된 기능을 사용하고자하는 다른 소스 파일에 포함되지만 구현에 대한 지식이 필요하지 않습니다 (따라서 코드 결합을 줄임). 다음 프로그램은 위에 정의 된대로 my_function.h 헤더를 사용합니다.

// main.cpp

#include <iostream>       // A C++ Standard Library header.
#include "my_function.h"  // A personal header

int main(int argc, char** argv) {
  std::cout << my_function() << std::endl;
  return 0;
}

컴파일 과정

헤더 파일은 종종 컴파일 프로세스 워크 플로의 일부이므로 헤더 / 소스 파일 규칙을 사용하는 일반적인 컴파일 프로세스는 일반적으로 다음을 수행합니다.

헤더 파일과 소스 코드 파일이 이미 같은 디렉토리에 있다고 가정하면 프로그래머는 다음 명령을 실행합니다.

g++ -c my_function.cpp       # Compiles the source file my_function.cpp
                             # --> object file my_function.o

g++ main.cpp my_function.o   # Links the object file containing the 
                             # implementation of int my_function()
                             # to the compiled, object version of main.cpp
                             # and then produces the final executable a.out

또는 main.cpp 를 먼저 오브젝트 파일로 컴파일 한 다음 오브젝트 파일 만 링크하여 최종 단계로 만들려면 다음을 수행하십시오.

g++ -c my_function.cpp
g++ -c main.cpp

g++ main.o my_function.o

헤더 파일의 템플릿

템플릿은 컴파일 타임에 코드를 생성해야합니다. 예를 들어 템플릿 기능은 소스 코드에서 사용하여 템플릿 기능이 매개 변수화되면 효과적으로 여러 개의 고유 한 기능으로 변환됩니다.

이는 템플리트 함수, 구성원 함수 및 클래스 정의를 별도의 소스 코드 파일에 위임 할 수 없음을 의미합니다. 템플릿 화 된 구문을 사용하는 코드는 일반적으로 파생 코드를 생성하기 위해 해당 정의에 대한 지식이 필요합니다.

따라서 헤더에 삽입 된 템플릿 코드는 정의를 포함해야합니다. 예를 들면 다음과 같습니다.

// templated_function.h

template <typename T>
T* null_T_pointer() {
  T* type_point = NULL; // or, alternatively, nullptr instead of NULL
                        // for C++11 or later
  return type_point;
}