C++ 템플릿 인자 추론 | template argument deduction 가이드
이 글의 핵심
C++ 템플릿 인자 추론에 대한 실전 가이드입니다. template argument deduction 가이드 등을 예제와 함께 상세히 설명합니다.
템플릿 인자 추론이란?
함수 템플릿 호출 시 타입 인자를 생략하면, 컴파일러가 인자식으로부터 타입을 추론합니다. 이를 템플릿 인자 추론(template argument deduction)이라고 합니다. 실무에서는 std::make_pair, std::make_unique처럼 타입을 적지 않고 쓰는 경우가 이 추론에 의존합니다.
기본 예시
template<typename T>
T add(T a, T b) {
return a + b;
}
int main() {
add(1, 2); // T = int
add(1.0, 2.0); // T = double
// add(1, 2.0); // 오류: T가 int와 double로 모호
add<double>(1, 2.0); // 명시적 지정
return 0;
}추론 과정:
- 컴파일러는 각 인자의 타입을 분석합니다.
- 템플릿 인자
T를 각 인자 타입과 매칭합니다. - 모든 인자에서 일관된
T를 찾으면 성공, 아니면 에러.
왜 add(1, 2.0)은 실패하나?: 첫 번째 인자는 T = int, 두 번째는 T = double을 요구합니다. 두 추론이 충돌하므로 컴파일 에러가 발생합니다.
추론 규칙 상세
규칙 1: 값 전달 시 decay
값으로 받으면 const, volatile, 참조가 제거되고, 배열과 함수는 포인터로 decay 됩니다.
template<typename T>
void by_value(T x) { (void)x; }
int i = 0;
const int ci = 10;
int& ref = i;
int arr[5];
by_value(i); // T = int
by_value(ci); // T = int (const 제거)
by_value(ref); // T = int (참조 제거)
by_value(arr); // T = int* (배열 decay)실무 의미: 값 전달은 복사본을 만들므로, const나 참조 속성이 의미 없어집니다. 배열은 크기 정보를 잃고 포인터가 됩니다.
규칙 2: 참조 전달 시 타입 유지
참조로 받으면 const와 참조가 유지됩니다.
template<typename T>
void by_ref(T& x) { (void)x; }
int i = 0;
const int ci = 10;
by_ref(i); // T = int
by_ref(ci); // T = const int (const 유지)
// by_ref(5); // 에러: 임시 객체는 비const 참조로 받을 수 없음실무 팁:
- 수정 필요:
T&(비const 참조) - 읽기만:
const T&(const 참조, 임시 객체도 받을 수 있음) - 완벽한 전달:
T&&(universal reference)
규칙 3: 포인터 전달
포인터는 const 포인터와 포인터 to const를 구분합니다.
template<typename T>
void by_ptr(T* p) { (void)p; }
int x = 10;
const int cx = 20;
by_ptr(&x); // T = int
by_ptr(&cx); // T = const int (포인터가 가리키는 대상이 const)실무 예시
예시 1: 타입 불일치 해결
문제: 서로 다른 타입을 하나의 템플릿 인자로 받을 수 없습니다.
template<typename T>
T add(T a, T b) { return a + b; }
// ❌ 에러
// add(1, 2.0); // T = int? double?해결 1: 명시적 지정
add<double>(1, 2.0); // T = double, 1이 double로 변환됨해결 2: 두 개의 템플릿 인자
template<typename T1, typename T2>
auto add(T1 a, T2 b) {
return a + b; // 반환 타입은 자동 추론
}
add(1, 2.0); // T1 = int, T2 = double, 반환 = double해결 3: std::common_type 사용
template<typename T1, typename T2>
std::common_type_t<T1, T2> add(T1 a, T2 b) {
return a + b;
}
add(1, 2.0); // 반환 = double (공통 타입)실무 권장: 두 개의 템플릿 인자를 받고 auto 반환 타입을 사용하는 것이 가장 유연합니다.
예시 2: 완벽한 전달 (Perfect Forwarding)
template<typename T>
void wrapper(T&& arg) { // universal reference
process(std::forward<T>(arg));
}
int x = 10;
wrapper(x); // T = int&, lvalue 전달
wrapper(10); // T = int, rvalue 전달
wrapper(std::move(x)); // T = int, rvalue 전달추론 규칙: T&&는 universal reference로, lvalue가 오면 T = int&, rvalue가 오면 T = int로 추론됩니다. 이를 reference collapsing이라고 합니다.
실무 활용: 팩토리 함수, 래퍼 함수, 이벤트 핸들러 등에서 인자를 완벽하게 전달할 때 사용합니다.
// 실무 예시: make_unique 구현
template<typename T, typename... Args>
std::unique_ptr<T> make_unique(Args&&... args) {
return std::unique_ptr<T>(new T(std::forward<Args>(args)...));
}
auto ptr = make_unique<Widget>(10, "hello");
// Args = int, const char* 추론참조·const와 추론
값으로 받으면 복사가 되고 T는 참조/const가 제거된 타입으로 추론됩니다. 참조로 받으면 T가 참조 타입으로 추론될 수 있어, 의도에 따라 다르게 동작합니다.
template<typename T>
void by_value(T x) { (void)x; }
template<typename T>
void by_ref(T& x) { (void)x; }
int i = 0;
const int ci = 0;
by_value(i); // T = int
by_value(ci); // T = int (const 제거)
by_ref(i); // T = int
by_ref(ci); // T = const int실무 팁: “읽기만 하는” 제네릭 함수는 const T&로 받으면 복사를 피하면서도 상수 객체를 넘길 수 있습니다. T만 쓰면 항상 복사가 발생합니다.
배열·함수와 decay
배열이나 함수를 값으로 넘기면 decay가 적용되어 포인터로 추론됩니다. 크기 정보가 필요하면 참조로 받아 T (&)[N] 형태로 추론되게 할 수 있습니다.
template<typename T>
void f(T x) { (void)x; }
template<typename T, size_t N>
void g(T (&a)[N]) {
std::cout << "Array size: " << N << '\n';
}
int arr[3] = {1, 2, 3};
f(arr); // T = int* (크기 정보 손실)
g(arr); // T = int, N = 3 (크기 정보 유지)실무 활용: 컴파일 타임에 배열 크기를 알아야 할 때 유용합니다.
// 실무 예시: 배열 크기 자동 추론
template<typename T, size_t N>
constexpr size_t array_size(T (&)[N]) {
return N;
}
int arr[] = {1, 2, 3, 4, 5};
std::cout << array_size(arr) << '\n'; // 5
// C++17 이후는 std::size 사용
std::cout << std::size(arr) << '\n'; // 5클래스 템플릿: CTAD (C++17)
생성자 인자로부터 클래스 템플릿 인자를 추론할 수 있습니다. 표준 라이브러리의 std::pair, std::vector, std::optional 등이 이렇게 쓸 수 있습니다.
std::pair p(1, 2.0); // std::pair<int, double>
std::vector v = {1, 2, 3}; // std::vector<int>
std::optional opt(42); // std::optional<int>
std::tuple t(1, "hello", 3.14); // std::tuple<int, const char*, double>추론 과정: 생성자의 인자 타입을 보고 템플릿 인자를 역추론합니다. std::pair(1, 2.0)은 std::pair<int, double>(1, 2.0) 생성자를 호출하는 것과 같습니다.
실무 팁: 사용자 정의 클래스 템플릿에서도 deduction guide를 정의하면 CTAD를 지원할 수 있습니다. 생성자만으로는 추론이 애매할 때 유용합니다.
// 사용자 정의 클래스
template<typename T>
class Container {
T value_;
public:
Container(T v) : value_(v) {}
};
// ✅ CTAD 사용
Container c(42); // Container<int>
// Deduction guide 예시
template<typename T>
Container(T) -> Container<T>; // 명시적 가이드 (보통 자동 생성됨)복잡한 예시: 반복자로부터 추론
std::vector<int> v = {1, 2, 3};
// 반복자 범위로 vector 생성 (CTAD)
std::vector v2(v.begin(), v.end()); // std::vector<int>
// deduction guide가 이를 가능하게 함:
// template<typename It>
// vector(It, It) -> vector<typename std::iterator_traits<It>::value_type>;자주 발생하는 문제
- 여러 인자 타입 불일치: 한 타입으로 통일하거나
add<double>(1, 2.0)처럼 명시적으로 지정하세요. - 참조로 받을 때 const: 상수 객체를 넘기면 T가
const T로 추론되므로, 내부에서 수정하지 않을 것이라면const T&로 받는 것이 안전합니다. - CTAD와 생성자: 생성자 템플릿이 많으면 의도치 않은 타입이 추론될 수 있으므로, 필요 시 deduction guide로 고정하세요.
추론 실패 시 디버깅
에러 메시지 읽기
템플릿 추론 실패 시 컴파일러는 긴 에러 메시지를 출력합니다. 핵심을 찾는 방법:
template<typename T>
void process(T& x) { x.foo(); }
int main() {
int x = 10;
process(x); // 에러: int에는 foo() 없음
}에러 메시지 예시:
error: no member named 'foo' in 'int'
note: in instantiation of function template specialization 'process<int>' requested here
process(x);디버깅 팁:
- “in instantiation of” 라인에서 어떤 타입으로 추론되었는지 확인
- 원본 템플릿 정의로 돌아가 해당 타입이 요구사항을 만족하는지 확인
- 필요하면
static_assert나concept(C++20)으로 제약 추가
static_assert로 타입 검증
template<typename T>
void process(T& x) {
static_assert(std::is_class_v<T>, "T must be a class type");
x.foo();
}C++20 Concepts로 제약
template<typename T>
concept HasFoo = requires(T t) {
{ t.foo() } -> std::same_as<void>;
};
template<HasFoo T>
void process(T& x) {
x.foo();
}
// 추론 실패 시 명확한 에러 메시지정리
| 항목 | 설명 |
|---|---|
| 함수 템플릿 | 호출 인자로 T 추론, 불일치 시 명시 지정 필요 |
| 참조/const | 값 전달 시 decay·const 제거, 참조 전달 시 그대로 반영 |
| 배열/함수 | 값 전달 시 포인터로 decay, 참조로 받으면 크기 유지 |
| CTAD | C++17에서 생성자 인자로 클래스 템플릿 인자 추론, deduction guide로 제어 가능 |
| 디버깅 | 에러 메시지에서 추론된 타입 확인, static_assert/concept로 제약 |
FAQ
Q1: 템플릿 인자 추론은 언제 사용하나요?
A: 함수 템플릿 호출 시 타입을 생략하고 싶을 때 자동으로 적용됩니다. std::make_pair, std::make_unique 등이 대표적입니다.
Q2: 추론이 실패하면 어떻게 하나요?
A:
- 명시적으로 타입 지정:
func<int>(arg) - 인자 타입 변환:
func(static_cast<int>(arg)) - 템플릿 인자 추가:
template<typename T1, typename T2>
Q3: 참조로 받을 때 주의사항은?
A: const 객체를 넘기면 T = const int로 추론되므로, 함수 내부에서 수정하려면 에러가 납니다. 읽기 전용이면 const T&로 받으세요.
Q4: CTAD는 언제 사용하나요?
A: C++17 이후 클래스 템플릿 생성 시 타입을 생략하고 싶을 때 사용합니다. std::vector v = {1, 2, 3}; 같은 간결한 코드를 작성할 수 있습니다.
Q5: universal reference는 무엇인가요?
A: T&& 형태로, lvalue는 T&, rvalue는 T로 추론됩니다. 완벽한 전달(perfect forwarding)에 사용됩니다.
Q6: 학습 리소스는?
A:
- “Effective Modern C++” by Scott Meyers (Item 1, 2)
- “C++ Templates: The Complete Guide” by Vandevoorde
- cppreference - Template argument deduction
관련 글: 템플릿 기초, 클래스 템플릿 인자 추론, auto 타입 추론.
한 줄 요약: 템플릿 인자 추론으로 타입을 생략해 호출을 짧게 쓸 수 있고, 참조·배열·CTAD 규칙을 알면 실무에서 헷갈림을 줄일 수 있습니다.
같이 보면 좋은 글 (내부 링크)
이 주제와 연결되는 다른 글입니다.
- C++ 템플릿 | “제네릭 프로그래밍” 초보자 가이드
- C++ CTAD | “클래스 템플릿 인자 추론” 가이드
- C++ 템플릿 입문 | template
와 템플릿 컴파일 에러 해결법
관련 글
- C++ CTAD |
- C++ Deduction Guides |
- C++ auto 타입 추론 | 복잡한 타입을 컴파일러에 맡기기
- C++20 Concepts 완벽 가이드 | 템플릿 제약의 새 시대
- C++ constexpr if |