C++ One Definition Rule : Multiple Definitions, inline,

Introduction

The One Definition Rule (ODR) states that variables, functions, classes, etc. must have one definition in the program (with well-known exceptions). Understanding ODR prevents link errors and subtle bugs.

1. Basic ODR rules

Variables

// ❌ ODR violation
// file1.cpp
int globalVar = 10;
// file2.cpp
int globalVar = 20;  // multiple definitions

// ✅ Correct pattern
// header.h
extern int globalVar;  // declaration
// file1.cpp
int globalVar = 10;   // single definition
// file2.cpp
#include "header.h"   // declaration only

Functions

// ❌ Two definitions of the same function
// file1.cpp
void func() { std::cout << "file1\n"; }
// file2.cpp
void func() { std::cout << "file2\n"; }

// ✅ Declaration in header, single definition in one .cpp
// header.h
void func();
// file1.cpp
void func() { std::cout << "implementation\n"; }

---

2. ODR exceptions

inline functions

// utils.h
inline int add(int a, int b) {
    return a + b;
}
// file1.cpp
#include "utils.h"
// file2.cpp
#include "utils.h"  // OK if identical

Key point: inline definitions may appear in multiple TUs if token-identical.

Templates

Templates are typically defined in headers and instantiated in multiple TUs—ODR allows this under the usual rules for templates.

constexpr / inline variables (C++17)

inline constexpr int MAX = 100;  // single definition across TUs (C++17 inline variable)

---

3. Practical examples

Example 1: Global configuration

// config.h
#ifndef CONFIG_H
#define CONFIG_H
extern int maxConnections;
extern const char* appName;
inline int maxRetries = 3;
#endif

// config.cpp
#include "config.h"
int maxConnections = 100;
const char* appName = "MyApp";

Example 2: Class in header, members in .cpp

Class definitions in headers must be identical in every TU that sees them—normally one shared header.

Example 3: static data members

Pre-C++17: define non-inline static data members in one .cpp. C++17 allows inline static members in-class.

4. Common problems

Problem 1: Non-inline function definitions in headers

Put non-inline definitions in a single .cpp, or mark small functions inline in the header.

Problem 2: Different definitions of the same type

If two TUs define struct Data differently, ODR is violated and behavior is undefined even if it “compiles.” Fix: define shared types in one header included everywhere.

Problem 3: Anonymous namespaces in headers

Each TU gets its own anonymous namespace—avoid putting headers in headers that should share state.

Problem 4: constexpr variables before C++17

Prefer inline constexpr in C++17+ for header-defined constants with a single-definition guarantee.

5. ODR-friendly patterns

Header / source split

Declarations and inline/template in headers; non-inline function bodies in one .cpp.

Logging helpers as inline in headers

Short inline void log(...) in headers is a common pattern.

6. Library-style example

Singleton or logger patterns: declare static members appropriately; define inline static in-class when possible (C++17).

7. Detecting violations

• Linker: multiple definition of ...
• nm across .o files for duplicate strong symbols
• Warnings: -Wall -Wextra

---

Summary

1. ODR — generally one definition.
2. Variables — one definition; extern in headers for declarations.
3. Functions — one definition unless inline/template rules apply.
4. Classes — identical definitions in every TU.
5. Exceptions — inline, templates, inline variables (C++17).

Quick reference

Item	Header	Source
Variable declaration	extern int var;	int var = 0;
Function declaration	void f();	void f() {}
Class definition	class C {};	—
inline function	inline void f() {}	—
Template	full definition in header	—
Next: Extern linkage, Header files, Function overloading.

---

Related posts

• C++ Compilation Process
• C++ multiple definition error
• C++ header-only library
• C++ Linking
• C++ Name Mangling

---

자주 묻는 질문 (FAQ)

Q. 이 내용을 실무에서 언제 쓰나요?

A. The ODR requires a single definition across the program for variables and functions, with exceptions for inline, templat… 실무에서는 위 본문의 예제와 선택 가이드를 참고해 적용하면 됩니다.

Q. 선행으로 읽으면 좋은 글은?

A. 각 글 하단의 이전 글 또는 관련 글 링크를 따라가면 순서대로 배울 수 있습니다. C++ 시리즈 목차에서 전체 흐름을 확인할 수 있습니다.

Q. 더 깊이 공부하려면?

A. cppreference와 해당 라이브러리 공식 문서를 참고하세요. 글 말미의 참고 자료 링크도 활용하면 좋습니다.

---

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

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

• C++ Extern Linkage | ‘외부 연결’ 가이드
• C++ 함수 오버로딩 | ‘Function Overloading’ 가이드
• C++ Header Files | ‘헤더 파일’ 가이드

---

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

C++, ODR, one definition rule, linking, inline 등으로 검색하시면 이 글이 도움이 됩니다.