컴파일러는 오버로드 중 어떤 함수를 고르나요?

이름 찾기 후 **오버로드 결정**이 일어나며, 인자 개수·타입 변환 순위·템플릿과 비템플릿 규칙 등이 적용됩니다. 모호하면 컴파일 에러가 납니다.

void f(int)와 void f(long)에 f(3)을 넘기면?

정수 리터럴의 정확한 타입과 승격 규칙에 따라 더 나은 변환 후보가 선택됩니다. 혼란스러우면 명시 캐스팅이나 리터럴 접미사를 쓰세요.

기본 인자와 오버로딩을 함께 쓰면 안 되나요?

가능은 하지만 **중복 호출 형태**가 생기기 쉽습니다. 어떤 오버로드가 불리는지 예측이 어려워지면 팀 가이드로 제한합니다.

템플릿 함수와 비템플릿 함수가 경쟁하면?

비템플릿이 동일하게 매칭되면 **비템플릿이 우선**되는 등 특수 규칙이 있습니다. 의도와 다르면 명시적 특수화나 delete로 정리하세요.

C++ 함수 오버로딩 | 'Function Overloading' 가이드

2026년 3월 12일 · 10분 읽기 · 수정 2026년 4월 7일 초급 튜토리얼

이 글의 핵심

int add(int a, int b) { return a + b; }.

함수 오버로딩이란?

같은 이름, 다른 매개변수를 가진 여러 함수

add 함수의 구현 예제입니다.

int add(int a, int b) {
    return a + b;
}

double add(double a, double b) {
    return a + b;
}

int add(int a, int b, int c) {
    return a + b + c;
}

int main() {
    std::cout << add(1, 2) << std::endl;        // 3 (int 버전)
    std::cout << add(1.5, 2.5) << std::endl;    // 4.0 (double 버전)
    std::cout << add(1, 2, 3) << std::endl;     // 6 (3개 인자 버전)
}

오버로딩 규칙

func 함수의 구현 예제입니다.

// ✅ 매개변수 개수 다름
void func(int x);
void func(int x, int y);

// ✅ 매개변수 타입 다름
void func(int x);
void func(double x);

// ✅ const 다름
void func(int* ptr);
void func(const int* ptr);

// ❌ 반환 타입만 다름 (오버로딩 불가)
int func(int x);
// double func(int x);  // 에러

실전 예시

예시 1: 출력 함수

#include <iostream>
#include <vector>

void print(int x) {
    std::cout << "int: " << x << std::endl;
}

void print(double x) {
    std::cout << "double: " << x << std::endl;
}

void print(const std::string& s) {
    std::cout << "string: " << s << std::endl;
}

void print(const std::vector<int>& vec) {
    std::cout << "vector: ";
    for (int x : vec) {
        std::cout << x << " ";
    }
    std::cout << std::endl;
}

int main() {
    print(42);
    print(3.14);
    print(std::string("Hello"));
    print(std::vector<int>{1, 2, 3});
}

예시 2: 최대값 함수

int max(int a, int b) {
    return a > b ? a : b;
}

double max(double a, double b) {
    return a > b ? a : b;
}

int max(int a, int b, int c) {
    return max(max(a, b), c);
}

template<typename T>
T max(const std::vector<T>& vec) {
    if (vec.empty()) {
        throw std::invalid_argument("빈 벡터");
    }
    
    T maxVal = vec[0];
    for (const auto& val : vec) {
        if (val > maxVal) {
            maxVal = val;
        }
    }
    return maxVal;
}

int main() {
    std::cout << max(10, 20) << std::endl;
    std::cout << max(1.5, 2.5) << std::endl;
    std::cout << max(1, 2, 3) << std::endl;
    
    std::vector<int> nums = {5, 2, 8, 1, 9};
    std::cout << max(nums) << std::endl;
}

예시 3: 생성자 오버로딩

class String {
private:
    char* data;
    size_t length;
    
public:
    // 기본 생성자
    String() : data(nullptr), length(0) {}
    
    // C 문자열
    String(const char* str) {
        length = strlen(str);
        data = new char[length + 1];
        strcpy(data, str);
    }
    
    // 반복 문자
    String(char c, size_t count) {
        length = count;
        data = new char[length + 1];
        memset(data, c, length);
        data[length] = '\0';
    }
    
    // 복사 생성자
    String(const String& other) {
        length = other.length;
        data = new char[length + 1];
        strcpy(data, other.data);
    }
    
    ~String() {
        delete[] data;
    }
};

int main() {
    String s1;               // 기본 생성자
    String s2("Hello");      // C 문자열
    String s3('*', 10);      // 반복 문자
    String s4(s2);           // 복사 생성자
}

예시 4: 검색 함수

#include <vector>
#include <string>

// 정수 검색
int find(const std::vector<int>& vec, int target) {
    for (size_t i = 0; i < vec.size(); i++) {
        if (vec[i] == target) {
            return i;
        }
    }
    return -1;
}

// 문자열 검색
int find(const std::vector<std::string>& vec, const std::string& target) {
    for (size_t i = 0; i < vec.size(); i++) {
        if (vec[i] == target) {
            return i;
        }
    }
    return -1;
}

// 조건 검색
template<typename T, typename Predicate>
int find(const std::vector<T>& vec, Predicate pred) {
    for (size_t i = 0; i < vec.size(); i++) {
        if (pred(vec[i])) {
            return i;
        }
    }
    return -1;
}

int main() {
    std::vector<int> numbers = {1, 2, 3, 4, 5};
    std::cout << find(numbers, 3) << std::endl;  // 2
    
    std::vector<std::string> words = {"apple", "banana", "cherry"};
    std::cout << find(words, std::string("banana")) << std::endl;  // 1
    
    std::cout << find(numbers,  { return x > 3; }) << std::endl;  // 3
}

const 오버로딩

class Array {
private:
    int data[10];
    
public:
    // non-const 버전
    int& operator {
        return data[index];
    }
    
    // const 버전
    const int& operator const {
        return data[index];
    }
};

int main() {
    Array arr;
    arr[0] = 10;  // non-const 버전
    
    const Array& constArr = arr;
    int x = constArr[0];  // const 버전
}

자주 발생하는 문제

문제 1: 모호한 호출

func 함수의 구현 예제입니다.

void func(int x) {
    std::cout << "int" << std::endl;
}

void func(double x) {
    std::cout << "double" << std::endl;
}

int main() {
    func(10);    // int
    func(3.14);  // double
    // func(10.0f);  // 모호함! float -> int? double?
    
    func(static_cast<int>(10.0f));     // int
    func(static_cast<double>(10.0f));  // double
}

문제 2: 기본 인자와 충돌

func 함수의 구현 예제입니다.

// ❌ 모호함
void func(int x) {
    std::cout << "1개 인자" << std::endl;
}

void func(int x, int y = 0) {
    std::cout << "2개 인자" << std::endl;
}

int main() {
    // func(10);  // 에러: 모호함
    func(10, 20);  // OK
}

// ✅ 다른 이름 사용
void func1(int x);
void func2(int x, int y = 0);

문제 3: 포인터 vs 배열

func 함수의 구현 예제입니다.

void func(int* ptr) {
    std::cout << "포인터" << std::endl;
}

void func(int arr[]) {
    std::cout << "배열" << std::endl;
}

// 에러: 같은 시그니처 (배열은 포인터로 decay)

문제 4: 반환 타입

getValue 함수의 구현 예제입니다.

// ❌ 반환 타입만 다름 (오버로딩 불가)
int getValue() {
    return 42;
}

// double getValue() {  // 에러
//     return 3.14;
// }

// ✅ 다른 이름 사용
int getIntValue() {
    return 42;
}

double getDoubleValue() {
    return 3.14;
}

오버로드 해결 규칙

func 함수의 구현 예제입니다.

void func(int x) { std::cout << "int" << std::endl; }
void func(double x) { std::cout << "double" << std::endl; }
void func(const std::string& s) { std::cout << "string" << std::endl; }

int main() {
    func(10);           // 정확히 일치: int
    func(3.14);         // 정확히 일치: double
    func("hello");      // 변환: const char* -> string
    
    char c = 'A';
    func(c);            // 승격: char -> int
    
    short s = 10;
    func(s);            // 승격: short -> int
}

FAQ

Q1: 함수 오버로딩은 언제 사용?

같은 동작, 다른 타입
매개변수 개수 다름
편의 함수

Q2: 오버로딩 vs 템플릿?

오버로딩: 타입별 다른 구현
템플릿: 같은 로직, 제네릭

Q3: 성능 영향?

A: 없음. 컴파일 타임에 해결.

Q4: 반환 타입으로 오버로딩?

A: 불가. 매개변수로만 구분.

Q5: 모호한 호출은?

A: 명시적 캐스팅 또는 다른 이름 사용.

Q6: 함수 오버로딩 학습 리소스는?

“Effective C++”
cppreference.com
“C++ Primer”

같이 보면 좋은 글 (내부 링크)

이 주제와 연결되는 다른 글입니다.

C++ 이름 은닉 |

심화 부록: 구현·운영 관점

이 부록은 앞선 본문에서 다룬 주제(「C++ 함수 오버로딩 | ‘Function Overloading’ 가이드」)를 구현·런타임·운영 관점에서 다시 압축합니다. 도메인별 세부 구현은 글마다 다르지만, 입력 검증 → 핵심 연산 → 부작용(I/O·네트워크·동시성) → 관측의 흐름으로 장애를 나누면 원인 추적이 빨라집니다.

내부 동작과 핵심 메커니즘

flowchart TD
  A[입력·요청·이벤트] --> B[파싱·검증·디코딩]
  B --> C[핵심 연산·상태 전이]
  C --> D[부작용: I/O·네트워크·동시성]
  D --> E[결과·관측·저장]

sequenceDiagram
  participant C as 클라이언트/호출자
  participant B as 경계(런타임·게이트웨이·프로세스)
  participant D as 의존성(API·DB·큐·파일)
  C->>B: 요청/이벤트
  B->>D: 조회·쓰기·RPC
  D-->>B: 지연·부분 실패·재시도 가능
  B-->>C: 응답 또는 오류(코드·상관 ID)

불변 조건(Invariant): 버퍼 경계, 프로토콜 상태, 트랜잭션 격리, FD 상한 등 단계별로 문장으로 적어 두면 디버깅 비용이 줄어듭니다.
결정성: 순수 층과 시간·네트워크·스케줄에 의존하는 층을 분리해야 테스트와 장애 분석이 쉬워집니다.
경계 비용: 직렬화, 인코딩, syscall 횟수, 락 경합, 할당·GC, 캐시 미스를 의심 목록에 둡니다.
백프레셔: 생산자가 소비자보다 빠를 때 버퍼·큐·스트림에서 속도를 줄이는 신호를 어디에 둘지 정의합니다.

프로덕션 운영 패턴

영역	운영 관점 질문
관측성	요청 단위 상관 ID, 에러율·지연 p95/p99, 의존성 타임아웃·재시도가 대시보드에 보이는가
안전성	입력 검증·권한·비밀·감사 로그가 코드 경로마다 일관적인가
신뢰성	재시도는 멱등 연산에만 적용되는가, 서킷 브레이커·백오프·DLQ가 있는가
성능	캐시·배치 크기·커넥션 풀·인덱스·백프레셔가 데이터 규모에 맞는가
배포	롤백 룬북, 카나리/블루그린, 마이그레이션·피처 플래그가 문서화되어 있는가
용량	피크 트래픽·디스크·FD·스레드 풀 상한을 주기적으로 검증하는가

스테이징은 데이터 양·네트워크 RTT·동시성을 프로덕션에 가깝게 맞출수록 재현율이 올라갑니다.

확장 예시: 엔드투엔드 미니 시나리오

앞선 본문 주제(「C++ 함수 오버로딩 | ‘Function Overloading’ 가이드」)를 배포·운영 흐름에 맞춰 옮긴 체크리스트입니다. 도메인에 맞게 단계 이름만 바꿔 적용할 수 있습니다.

입력 계약 고정: 스키마·버전·최대 페이로드·타임아웃·에러 코드를 경계에 둔다.
핵심 경로 계측: 요청 ID, 단계별 지연, 외부 호출 결과 코드를 로그·메트릭·트레이스에서 한 흐름으로 본다.
실패 주입: 의존성 타임아웃·5xx·부분 데이터·락 대기를 스테이징에서 재현한다.
호환·롤백: 설정/마이그레이션/클라이언트 버전을 되돌릴 수 있는지 확인한다.
부하 후 검증: 피크 대비 p95/p99, 에러율, 리소스 상한, 알림 임계값을 점검한다.

handle(request):
  ctx = newCorrelationId()
  validated = validateSchema(request)
  authorize(validated, ctx)
  result = domainCore(validated)
  persistOrEmit(result, idempotentKey)
  recordMetrics(ctx, latency, outcome)
  return result

문제 해결(Troubleshooting)

증상	가능 원인	조치
간헐적 실패	레이스, 타임아웃, 외부 의존성, DNS	최소 재현 스크립트, 분산 트레이스·로그 상관관계, 재시도·서킷 설정 점검
성능 저하	N+1, 동기 I/O, 락 경합, 과도한 직렬화, 캐시 미스	프로파일러·APM으로 핫스팟 확인 후 한 가지씩 제거
메모리 증가	캐시 무제한, 구독/리스너 누수, 대용량 버퍼, 커넥션 미반납	상한·TTL·힙/FD 스냅샷 비교
빌드·배포만 실패	환경 변수, 권한, 플랫폼 차이, lockfile	CI 로그와 로컬 diff, 런타임·이미지 버전 핀
설정 불일치	프로필·시크릿·기본값, 리전	스키마 검증된 설정 단일 소스와 배포 매트릭스 표준화
데이터 불일치	비멱등 재시도, 부분 쓰기, 캐시 무효화 누락	멱등 키·아웃박스·트랜잭션 경계 재검토

권장 순서: (1) 최소 재현 (2) 최근 변경 범위 축소 (3) 환경·의존성 차이 (4) 관측으로 가설 검증 (5) 수정 후 회귀·부하 테스트.

배포 전에는 git add → git commit → git push 후 npm run deploy 순서를 권장합니다.

이 글에서 다루는 키워드 (관련 검색어)

C++, overloading, function, 함수, 오버로딩 등으로 검색하시면 이 글이 도움이 됩니다.

이 글이 도움이 되셨나요?

여러분의 피드백은 더 나은 콘텐츠를 만드는 데 도움이 됩니다

문제가 있거나 개선 제안이 있으시면 연락처로 알려주세요.

Keyboard Shortcuts

C++ 함수 오버로딩 | 'Function Overloading' 가이드

이 글의 핵심

함수 오버로딩이란?

오버로딩 규칙

실전 예시

예시 1: 출력 함수

예시 2: 최대값 함수

예시 3: 생성자 오버로딩

예시 4: 검색 함수

const 오버로딩

자주 발생하는 문제

문제 1: 모호한 호출

문제 2: 기본 인자와 충돌

문제 3: 포인터 vs 배열

문제 4: 반환 타입

오버로드 해결 규칙

FAQ

Q1: 함수 오버로딩은 언제 사용?

Q2: 오버로딩 vs 템플릿?

Q3: 성능 영향?

Q4: 반환 타입으로 오버로딩?

Q5: 모호한 호출은?

Q6: 함수 오버로딩 학습 리소스는?

같이 보면 좋은 글 (내부 링크)

관련 글

심화 부록: 구현·운영 관점

내부 동작과 핵심 메커니즘

프로덕션 운영 패턴

확장 예시: 엔드투엔드 미니 시나리오

문제 해결(Troubleshooting)

이 글에서 다루는 키워드 (관련 검색어)

이 글이 도움이 되셨나요?