C++ Universal Reference | "유니버설 레퍼런스" 가이드
이 글의 핵심
C++ Universal Reference에 대한 실전 가이드입니다.
Universal Reference란?
Universal Reference (유니버설 참조) 또는 Forwarding Reference (포워딩 참조) 는 템플릿에서 T&& 형태로 선언된 매개변수로, 좌측값과 우측값 모두 받을 수 있습니다. C++11의 완벽 전달(Perfect Forwarding)을 가능하게 하는 핵심 기능입니다.
template<typename T>
void func(T&& arg) { // Universal Reference
// arg는 좌측값 또는 우측값
}
int main() {
int x = 10;
func(x); // T = int&, arg는 int&
func(10); // T = int, arg는 int&&
func(std::move(x)); // T = int, arg는 int&&
}
왜 필요한가?:
- 완벽 전달: 인자를 원래 타입 그대로 전달
- 성능: 불필요한 복사 제거
- 일반성: 좌측값/우측값 모두 처리
- 유연성: 팩토리 함수, 래퍼 함수에서 필수
// ❌ 좌측값/우측값 별도 구현
void func(int& x) { // 좌측값
process(x);
}
void func(int&& x) { // 우측값
process(std::move(x));
}
// ✅ Universal Reference: 하나로 통합
template<typename T>
void func(T&& x) {
process(std::forward<T>(x));
}
Universal Reference 조건:
Universal Reference가 되려면 타입 추론이 필요합니다.
// ✅ Universal Reference (타입 추론)
template<typename T>
void func1(T&& arg); // OK
auto&& x = getValue(); // OK
// ❌ 우측값 참조 (타입 추론 없음)
void func2(int&& arg); // 타입 명시
template<typename T>
class Widget {
void func(T&& arg); // 클래스 템플릿 T (타입 추론 없음)
};
Universal Reference vs Rvalue Reference
// Rvalue Reference (타입 명시)
void func1(int&& x) { // 우측값만
// x는 int&&
}
// Universal Reference (타입 추론)
template<typename T>
void func2(T&& x) { // 좌측값/우측값 모두
// x는 T&&
}
// auto도 Universal Reference
auto&& x = getValue(); // 좌측값/우측값 모두
타입 추론 규칙
template<typename T>
void func(T&& arg) {
// ...
}
int x = 10;
// 좌측값 전달
func(x); // T = int&
// T&& = int& && = int& (레퍼런스 축약)
// 우측값 전달
func(10); // T = int
// T&& = int&&
실전 예시
예시 1: Perfect Forwarding
#include <utility>
#include <iostream>
void process(int& x) {
std::cout << "좌측값: " << x << std::endl;
}
void process(int&& x) {
std::cout << "우측값: " << x << std::endl;
}
// Universal Reference + Perfect Forwarding
template<typename T>
void wrapper(T&& arg) {
process(std::forward<T>(arg));
}
int main() {
int x = 10;
wrapper(x); // 좌측값 전달
wrapper(20); // 우측값 전달
wrapper(std::move(x)); // 우측값 전달
}
예시 2: 팩토리 함수
#include <memory>
#include <utility>
template<typename T, typename... Args>
std::unique_ptr<T> make_unique(Args&&... args) {
return std::unique_ptr<T>(new T(std::forward<Args>(args)...));
}
class Widget {
public:
Widget(int x, const std::string& s) {
std::cout << "Widget(" << x << ", " << s << ")" << std::endl;
}
Widget(const Widget&) {
std::cout << "복사 생성자" << std::endl;
}
Widget(Widget&&) noexcept {
std::cout << "이동 생성자" << std::endl;
}
};
int main() {
auto w1 = make_unique<Widget>(10, "Hello");
std::string s = "World";
auto w2 = make_unique<Widget>(20, s); // 좌측값
auto w3 = make_unique<Widget>(30, std::move(s)); // 우측값
}
예시 3: 컨테이너 emplace
#include <vector>
#include <string>
template<typename T>
class MyVector {
private:
std::vector<T> data;
public:
template<typename... Args>
void emplace_back(Args&&... args) {
data.emplace_back(std::forward<Args>(args)...);
}
size_t size() const {
return data.size();
}
};
int main() {
MyVector<std::string> vec;
std::string s = "Hello";
vec.emplace_back(s); // 좌측값 (복사)
vec.emplace_back("World"); // 우측값 (이동)
vec.emplace_back(std::move(s)); // 우측값 (이동)
std::cout << vec.size() << std::endl;
}
예시 4: 함수 래퍼
#include <functional>
#include <chrono>
template<typename Func, typename... Args>
auto measureTime(Func&& func, Args&&... args) {
auto start = std::chrono::high_resolution_clock::now();
std::forward<Func>(func)(std::forward<Args>(args)...);
auto end = std::chrono::high_resolution_clock::now();
auto duration = std::chrono::duration_cast<std::chrono::milliseconds>(end - start);
return duration.count();
}
void heavyTask(int n) {
int sum = 0;
for (int i = 0; i < n; i++) {
sum += i;
}
std::cout << "작업 완료: " << sum << std::endl;
}
int main() {
auto time = measureTime(heavyTask, 10000000);
std::cout << "실행 시간: " << time << "ms" << std::endl;
// 람다도 전달 가능
auto time2 = measureTime( {
std::cout << "람다: " << x << std::endl;
}, 42);
}
std::forward
template<typename T>
void func(T&& arg) {
// ❌ arg는 항상 좌측값
process(arg);
// ✅ std::forward로 원래 타입 유지
process(std::forward<T>(arg));
}
auto&&
// auto&&도 Universal Reference
int x = 10;
auto&& a = x; // int&
auto&& b = 10; // int&&
auto&& c = std::move(x); // int&&
// 범위 기반 for
std::vector<std::string> vec = {"a", "b", "c"};
for (auto&& item : vec) {
// item은 좌측값 레퍼런스
}
자주 발생하는 문제
문제 1: const와 Universal Reference
// ❌ const T&&는 Universal Reference 아님
template<typename T>
void func(const T&& arg) { // 우측값만
// ...
}
// ✅ T&&만 Universal Reference
template<typename T>
void func(T&& arg) {
// ...
}
문제 2: 타입 명시
template<typename T>
void func(T&& arg) {
// ...
}
// ❌ 타입 명시하면 Universal Reference 아님
func<int>(10); // T = int, arg는 int&& (우측값만)
// ✅ 타입 추론
func(10); // Universal Reference
문제 3: std::forward 누락
template<typename T>
void wrapper(T&& arg) {
// ❌ arg는 좌측값
process(arg);
// ✅ std::forward 사용
process(std::forward<T>(arg));
}
문제 4: 멤버 함수
class Widget {
public:
// ❌ 멤버 함수는 Universal Reference 아님
template<typename T>
void func(T&& arg) {
// T는 클래스 템플릿 매개변수가 아님
// Universal Reference 작동
}
};
// 클래스 템플릿
template<typename T>
class Container {
public:
// ❌ T&&는 우측값 레퍼런스 (타입 추론 없음)
void func(T&& arg) {
// ...
}
};
Universal Reference 판별
// ✅ Universal Reference
template<typename T>
void func1(T&& arg);
auto&& x = getValue();
template<typename T>
void func2(std::vector<T>&& arg); // ❌ 우측값만
// ❌ 우측값 레퍼런스
void func3(int&& arg);
template<typename T>
class Widget {
void func(T&& arg); // ❌ 우측값만
};
실용적인 패턴
// 1. 완벽한 전달
template<typename T>
void forward_to_process(T&& arg) {
process(std::forward<T>(arg));
}
// 2. 팩토리 함수
template<typename T, typename... Args>
T create(Args&&... args) {
return T(std::forward<Args>(args)...);
}
// 3. 콜백 래퍼
template<typename Func, typename... Args>
void async_call(Func&& func, Args&&... args) {
std::thread(std::forward<Func>(func), std::forward<Args>(args)...).detach();
}
// 4. 조건부 처리
template<typename T>
void conditional_process(T&& arg) {
if constexpr (std::is_lvalue_reference_v<T>) {
std::cout << "좌측값" << std::endl;
} else {
std::cout << "우측값" << std::endl;
}
process(std::forward<T>(arg));
}
실무 패턴
패턴 1: 로깅 래퍼
template<typename Func, typename... Args>
auto logAndCall(const std::string& name, Func&& func, Args&&... args) {
std::cout << "[CALL] " << name << '\n';
auto result = std::forward<Func>(func)(std::forward<Args>(args)...);
std::cout << "[DONE] " << name << '\n';
return result;
}
// 사용
int add(int a, int b) { return a + b; }
auto result = logAndCall("add", add, 2, 3);
// [CALL] add
// [DONE] add
// result = 5
패턴 2: 지연 실행
template<typename Func, typename... Args>
class LazyCall {
Func func_;
std::tuple<Args...> args_;
public:
LazyCall(Func&& func, Args&&... args)
: func_(std::forward<Func>(func))
, args_(std::forward<Args>(args)...) {}
auto execute() {
return std::apply(func_, args_);
}
};
// 사용
auto lazy = LazyCall( {
return a + b;
}, 2, 3);
// 나중에 실행
auto result = lazy.execute(); // 5
패턴 3: 조건부 처리
template<typename T>
void process(T&& value) {
if constexpr (std::is_lvalue_reference_v<T>) {
std::cout << "좌측값: 복사\n";
store(value); // 복사
} else {
std::cout << "우측값: 이동\n";
store(std::forward<T>(value)); // 이동
}
}
// 사용
int x = 10;
process(x); // 좌측값: 복사
process(20); // 우측값: 이동
process(std::move(x)); // 우측값: 이동
FAQ
Q1: Universal Reference는 언제 사용하나요?
A:
- 템플릿
T&&: 타입 추론이 필요할 때 auto&&: 변수 선언 시- 완벽 전달: 인자를 다른 함수로 전달
template<typename T>
void func(T&& arg) { // Universal Reference
process(std::forward<T>(arg));
}
auto&& x = getValue(); // Universal Reference
Q2: 왜 필요한가요?
A:
- Perfect Forwarding: 인자를 원래 타입 그대로 전달
- 성능 최적화: 불필요한 복사 제거
- 일반성: 좌측값/우측값 모두 처리
template<typename T, typename... Args>
std::unique_ptr<T> make_unique(Args&&... args) {
return std::unique_ptr<T>(new T(std::forward<Args>(args)...));
}
Q3: std::forward는 무엇인가요?
A: 원래 값 범주를 유지하는 함수입니다. Universal Reference와 함께 사용해야 합니다.
template<typename T>
void wrapper(T&& arg) {
// ❌ arg는 항상 좌측값
process(arg);
// ✅ std::forward로 원래 타입 유지
process(std::forward<T>(arg));
}
Q4: const T&&는 Universal Reference인가요?
A: 아니요. const T&&는 우측값 참조입니다. Universal Reference는 T&& 형태만 가능합니다.
// ❌ const T&&: 우측값만
template<typename T>
void func(const T&& arg) {
// 우측값만 받음
}
// ✅ T&&: Universal Reference
template<typename T>
void func(T&& arg) {
// 좌측값/우측값 모두
}
Q5: 멤버 함수에서는 어떻게 되나요?
A:
- 멤버 함수 템플릿: Universal Reference
- 클래스 템플릿 T: 우측값 참조
class Widget {
public:
// ✅ Universal Reference
template<typename T>
void func1(T&& arg) {
// 타입 추론
}
};
template<typename T>
class Container {
public:
// ❌ 우측값 참조 (타입 추론 없음)
void func2(T&& arg) {
// T는 클래스 템플릿 매개변수
}
};
Q6: auto&&는 언제 사용하나요?
A: 범위 기반 for 루프와 변수 선언에서 사용합니다.
// 범위 기반 for
std::vector<std::string> vec = {"a", "b", "c"};
for (auto&& item : vec) {
// item은 좌측값 참조
}
// 변수 선언
auto&& x = getValue(); // 좌측값/우측값 모두
Q7: Universal Reference 판별 방법은?
A:
T&&형태: 템플릿 매개변수 T에 대해- 타입 추론: 함수 호출 시 타입 추론 발생
- cv 한정자 없음:
const,volatile없음
// ✅ Universal Reference
template<typename T> void func1(T&& arg);
auto&& x = getValue();
// ❌ 우측값 참조
void func2(int&& arg); // 타입 명시
template<typename T> void func3(const T&& arg); // const
template<typename T> void func4(std::vector<T>&& arg); // 타입 추론 없음
Q8: Universal Reference 학습 리소스는?
A:
- “Effective Modern C++” by Scott Meyers (Item 24)
- “C++ Move Semantics - The Complete Guide” by Nicolai Josuttis
- cppreference.com - Forwarding references
관련 글: perfect-forwarding, move-semantics, reference-collapsing.
한 줄 요약: Universal Reference는 템플릿에서 T&& 형태로 좌측값과 우측값을 모두 받을 수 있는 참조입니다.
같이 보면 좋은 글 (내부 링크)
이 주제와 연결되는 다른 글입니다.
- C++ 완벽 전달 | “Perfect Forwarding” 가이드
- C++ auto 타입 추론 | 복잡한 타입을 컴파일러에 맡기기
- C++ Reference Collapsing | “레퍼런스 축약” 가이드
관련 글
- C++ auto 타입 추론 | 복잡한 타입을 컴파일러에 맡기기
- C++ async & launch |
- C++ Atomic Operations |
- C++ Attributes |
- C++ auto 키워드 |