C++ Extern Linkage | '외부 연결' 가이드
이 글의 핵심
C++ Extern Linkage - "외부 연결" 가이드. C++ Extern Linkage의 내부 연결 vs 외부 연결, extern "C" 심화, 실전 라이브러리 설계 팁를 실전 코드와 함께 설명합니다.
들어가며
C++의 extern은 여러 파일에서 전역 변수나 함수를 공유할 때 사용하는 키워드입니다. 링키지(linkage) 개념을 이해하는 데 핵심적입니다.
내부 연결 vs 외부 연결
| 개념 | 의미 | 대표적인 경우 |
|---|---|---|
| 외부 연결(external linkage) | 다른 번역 단위(.cpp)에서 같은 이름이 하나의 엔티티를 가리킴 | 파일 범위의 비-static 함수, extern 전역 변수 선언/정의 |
| 내부 연결(internal linkage) | 이름이 해당 번역 단위 안에서만 보임 | static 파일 범위 변수/함수, const 객체의 기본(구버전 규칙과 주의), 익명 네임스페이스 안의 이름 |
| 연결 없음 | 지역 변수, 클래스 멤버 등 | 링커 수준이 아닌 스코프 규칙으로만 해석 |
실무 포인트: “헤더에 넣으면 ODR 위반인가?”는 대개 연결과 inline 규칙 문제입니다. 함수는 inline 정의를 헤더에 둘 수 있지만, 전역 변수의 정의는 보통 한 .cpp에만 둡니다.
extern "C" 심화
C++는 이름 장식(name mangling)으로 오버로드를 구분합니다. C ABI는 그렇지 않으므로, C 라이브러리 심볼과 링크하려면 extern "C" 블록으로 “C 링키지”를 명시합니다.
- 포인터 타입:
extern "C"함수에 C++에서 만든 콜백을 넘길 때는 콜백도extern "C"로 맞추거나, 바인딩 규칙을 문서화해야 합니다. - 오버로드 불가: C 링키지 함수 이름은 번역 단위당 하나입니다.
- 헤더 관용:
#ifdef __cplusplus로 감싸 공통 헤더를 C와 C++에서 같이 씁니다(아래 예제 3과 동일 패턴).
extern "C" int plugin_init(void* ctx); // 심볼명이 C 규칙으로 노출헤더 가드·#pragma once와의 관계
헤더 가드(#ifndef / #define)나 #pragma once는 전처리 단계에서 같은 헤더가 같은 번역 단위에 두 번 포함되는 것을 막습니다. 링키지와는 층이 다릅니다: 가드는 “중복 파싱 방지”, 링키지는 “링커가 심볼을 어떻게 합치나”입니다.
다만 실무에서는 다음을 한 세트로 생각합니다.
- 선언은 헤더에 여러 번 포함돼도 안전해야 함 →
#pragma once+ 선언만. - 정의는 한 번만 →
.cpp에 두거나inline/constexpr등 규칙 준수. extern전역 변수: 헤더에는extern int x;, 소스 한 곳에int x = 0;.
즉 “가드가 링키지를 바꾼다”가 아니라, 가드 덕분에 헤더를 안전하게 여러 곳에서 include할 수 있어 ODR을 지키기 쉬워집니다.
실전 라이브러리 설계 팁
- 공개 API는 네임스페이스로 감싸으며, 전역
extern남발을 피합니다. - 구현 세부는 내부 연결(
static, 익명 네임스페이스) 또는detail네임스페이스에 둡니다. - C API 노출이 필요하면
extern "C"+ 안정적인 ABI 문서(호출 규약, 스레드 안전성)를 제공합니다. - 모듈(C++20) 또는 명확한 include 계층으로 “헤더에서 무엇이 노출되는지”를 줄입니다.
1. extern 기본
개념
C/C++ 예제 코드입니다.
// file1.cpp
int globalVar = 10;
// file2.cpp
extern int globalVar;
int x = globalVar;기본 사용법
// globals.h
extern int counter;
extern void increment();
// globals.cpp
#include "globals.h"
#include <iostream>
int counter = 0;
void increment() {
counter++;
}
// main.cpp
#include "globals.h"
#include <iostream>
int main() {
increment();
std::cout << counter << std::endl; // 1
}2. 실전 예제
예제 1: 전역 설정
// config.h
#ifndef CONFIG_H
#define CONFIG_H
#include <string>
extern int maxConnections;
extern std::string serverName;
#endif
// config.cpp
#include "config.h"
int maxConnections = 100;
std::string serverName = "MyServer";
// main.cpp
#include "config.h"
#include <iostream>
int main() {
std::cout << "Max: " << maxConnections << std::endl;
std::cout << "Server: " << serverName << std::endl;
}예제 2: 함수 선언
// utils.h
#ifndef UTILS_H
#define UTILS_H
#include <string>
extern void printMessage(const std::string& msg);
extern int calculate(int a, int b);
#endif
// utils.cpp
#include "utils.h"
#include <iostream>
void printMessage(const std::string& msg) {
std::cout << msg << std::endl;
}
int calculate(int a, int b) {
return a + b;
}
// main.cpp
#include "utils.h"
int main() {
printMessage("Hello");
int result = calculate(5, 3);
printMessage(std::to_string(result));
}예제 3: extern “C”
// c_library.h
#ifdef __cplusplus
extern "C" {
#endif
void c_function();
int c_calculate(int a, int b);
#ifdef __cplusplus
}
#endif
// c_library.c
#include "c_library.h"
#include <stdio.h>
void c_function() {
printf("C function\n");
}
int c_calculate(int a, int b) {
return a + b;
}
// main.cpp
#include "c_library.h"
#include <iostream>
int main() {
c_function();
int result = c_calculate(5, 3);
std::cout << result << std::endl;
}3. extern vs static
비교
// extern (외부 연결)
extern int globalVar;
// static (내부 연결)
static int localVar;예제
main 함수의 구현 예제입니다.
// file1.cpp
int externVar = 10;
static int staticVar = 20;
// file2.cpp
extern int externVar;
// extern int staticVar; // 에러: 접근 불가
int main() {
std::cout << externVar << std::endl; // 10
}4. 자주 발생하는 문제
문제 1: 중복 정의
C/C++ 예제 코드입니다.
// ❌ 헤더에 정의
// header.h
int globalVar = 10;
// ✅ 헤더에 선언, 소스에 정의
// header.h
extern int globalVar;
// source.cpp
int globalVar = 10;문제 2: 초기화 순서
C/C++ 예제 코드입니다.
// file1.cpp
int a = 10;
// file2.cpp
extern int a;
int b = a * 2;
// ✅ 함수 내 static
int& getA() {
static int a = 10;
return a;
}
int b = getA() * 2;문제 3: const와 extern
C/C++ 예제 코드입니다.
// ❌ const는 기본 internal linkage
// header.h
const int MAX = 100;
// ✅ extern 명시
// header.h
extern const int MAX;
// source.cpp
const int MAX = 100;문제 4: 네임스페이스
C/C++ 예제 코드입니다.
// ❌ 전역 네임스페이스 오염
extern int counter;
// ✅ 네임스페이스 사용
namespace MyApp {
extern int counter;
}5. extern template
명시적 인스턴스화
// header.h
template<typename T>
class MyClass {
public:
void print(T value);
};
extern template class MyClass<int>;
// source.cpp
template class MyClass<int>;
// main.cpp
#include "header.h"
int main() {
MyClass<int> obj;
}6. 실전 예제
예제 1: 로거 시스템
// logger.h
#ifndef LOGGER_H
#define LOGGER_H
#include <string>
extern int logLevel;
extern void log(const std::string& message);
#endif
// logger.cpp
#include "logger.h"
#include <iostream>
int logLevel = 1;
void log(const std::string& message) {
if (logLevel > 0) {
std::cout << "[LOG] " << message << std::endl;
}
}
// main.cpp
#include "logger.h"
int main() {
logLevel = 2;
log("Application started");
}정리
핵심 요약
- extern: 외부 연결
- 선언 vs 정의: 헤더에 선언, 소스에 정의
- extern “C”: C 링키지
- const: extern 명시 필요
- static: 내부 연결
extern vs static 비교
| 특성 | extern | static |
|---|---|---|
| 연결 | 외부 | 내부 |
| 다른 파일 접근 | O | X |
| 중복 정의 | X | O |
| 용도 | 전역 공유 | 파일 내부 |
실전 팁
- 헤더에는 선언만 (
extern) - 소스에는 정의 (초기화)
const는extern명시- 네임스페이스 사용 권장
extern "C"로 C 연동
다음 단계
관련 글
- C++ Linkage와 Storage
- C++ Zero Initialization
- 배열과 리스트 | 코딩 테스트 필수 자료구조 완벽 정리
- C++ Adapter Pattern 완벽 가이드 | 인터페이스 변환과 호환성
- C++ ADL
자주 묻는 질문 (FAQ)
Q. 이 내용을 실무에서 언제 쓰나요?
A. Everything about C++ Extern Linkage : from basic concepts to practical applications.
Q. 선행으로 읽으면 좋은 글은?
A. 각 글 하단의 이전 글 또는 관련 글 링크를 따라가면 순서대로 배울 수 있습니다. C++ 시리즈 목차에서 전체 흐름을 확인할 수 있습니다.
Q. 더 깊이 공부하려면?
A. cppreference와 해당 라이브러리 공식 문서를 참고하세요. 글 말미의 참고 자료 링크도 활용하면 좋습니다.
같이 보면 좋은 글 (내부 링크)
이 주제와 연결되는 다른 글입니다.
- C++ Linkage와 Storage | ‘연결과 저장 기간’ 가이드
- C++ One Definition Rule | ‘단일 정의 규칙’ 가이드
- C++ static 멤버 | ‘Static Members’ 가이드
이 글에서 다루는 키워드 (관련 검색어)
C++, extern, linkage, global, 연결 등으로 검색하시면 이 글이 도움이 됩니다.