C++ Universal Reference | "유니버설 레퍼런스" 가이드

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:

  1. T&& 형태: 템플릿 매개변수 T에 대해
  2. 타입 추론: 함수 호출 시 타입 추론 발생
  3. 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:

관련 글: 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 키워드 |