Когда нужно писать ключевое слово inline для функций и методов в C++?

Краткий ответ: inline — это не про оптимизацию, а про One Definition Rule (ODR)

Самое главное заблуждение, которое нужно развеять: inline не заставляет компилятор встраивать код функции. Современные компиляторы сами принимают решение об инлайнинге на основе эвристик (размер функции, количество вызовов, уровень оптимизации -O2, -O3). Ключевое слово inline — это прежде всего директива линковщику, которая разрешает множественные определения функции в разных единицах трансляции.

Когда inline действительно нужен

Есть три основных случая, когда вы обязаны использовать inline:

• Функции, определённые в заголовочных файлах (кроме шаблонов и функций внутри тела класса). Если вы определяете обычную не-шаблонную функцию в .h файле и включаете этот .h в несколько .cpp, вы получите ошибку линковки "multiple definition". inline решает эту проблему.
• Глобальные переменные и константы с внешней линковкой (inline variables, C++17). Например: inline constexpr double PI = 3.14159; в заголовочном файле.
• Статические функции-члены класса, определённые вне тела класса, если вы хотите определить их в заголовке.

Пример: правильное использование inline

// math_utils.h
#ifndef MATH_UTILS_H
#define MATH_UTILS_H

// Без inline — ошибка линковки, если включить в два .cpp
inline int square(int x) {
    return x * x;
}

// Или для более сложных функций:
inline double hypotenuse(double a, double b) {
    return std::sqrt(a*a + b*b);
}

#endif

Что насчёт функций-членов класса?

Функции, определённые внутри тела класса, автоматически считаются inline (неявно). Вам не нужно писать ключевое слово:

class Calculator {
public:
    // Это неявно inline
    int add(int a, int b) { return a + b; }

    // А это уже нет — нужно писать inline, если хотите в заголовке
    int multiply(int a, int b);
};

// В том же заголовке:
inline int Calculator::multiply(int a, int b) {
    return a * b;
}

Влияние на производительность: мифы и реальность

Добавление inline не гарантирует встраивание. Компилятор может:

• Встроить функцию без inline, если она маленькая и вызывается часто (особенно с LTO — Link Time Optimization).
• Не встроить функцию с inline, если она слишком большая, рекурсивная или содержит сложные конструкции (циклы, виртуальные вызовы).
• Встроить функцию в одной точке вызова, но не в другой — это полностью решение компилятора.

Единственное, что даёт inline компилятору — это подсказку, что функция "предпочтительна для встраивания" (компилятор может учесть это при определённых настройках, но обычно игнорирует).

Когда inline может навредить?

1. Чрезмерное раздувание кода (code bloat). Если вы пометите inline большую функцию (100+ строк), и компилятор решит встроить её везде, размер исполняемого файла может сильно вырасти, что ухудшит кэш инструкций.
2. Замедление сборки. При изменении inline-функции в заголовке нужно перекомпилировать все .cpp файлы, которые его включают.
3. Сложность отладки. Встроенные функции не имеют своего адреса, их сложнее отлаживать (нельзя поставить точку остановы внутри).

Итоговые рекомендации

• Используйте inline только для разрешения ODR-проблем в заголовочных файлах.
• Не пишите inline для функций, определённых в .cpp файлах — это бессмысленно.
• Для маленьких функций (1-5 строк) в заголовках — используйте inline, если они не являются шаблонами или членами класса.
• Для оптимизации производительности полагайтесь на профилировщик, а не на ключевое слово inline.

// vec3d.h — без inline
struct Vec3 { float x, y, z; };
Vec3 add(const Vec3& a, const Vec3& b);  // определена в vec3d.cpp

// vs с inline:
inline Vec3 add_inline(const Vec3& a, const Vec3& b) {
    return {a.x + b.x, a.y + b.y, a.z + b.z};
}