WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

inline — Funktionen und Variablen in Headern definieren

inline ermöglicht Funktions- und Variablendefinitionen in Headern, wobei die One-Definition-Rule eingehalten wird. Es erzwingt weder das Ersetzen eines Aufrufs durch den Funktionsrumpf noch garantiert es ein schnelleres Programm.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

inline int twice(int x) { return 2 * x; }
inline int counter = 0;
inline constexpr int limit = 10;

inline erzwingt keine Optimierung. Der Compiler kann einen gewöhnlichen Funktionsaufruf beibehalten. Der Spezifizierer darf weder in einer Deklaration mit Block-Scope noch in einer Parameterdeklaration stehen.

In gewöhnlichen Headern außerhalb benannter Module dürfen inline-Funktionen und -Variablen Definitionen in mehreren Translation Units haben. Die One-Definition-Rule (ODR) verlangt jedoch dieselbe Tokenfolge und eine übereinstimmende Namenssuche, vorbehaltlich der im Standard festgelegten Ausnahmen. Innerhalb einer einzelnen Translation Unit ist weiterhin nur eine Definition zulässig. Eine Definition muss dort erreichbar sein, wo die ODR es verlangt; in der Praxis sollte ein gemeinsamer Header eingebunden werden. Makros, die Definitionen zwischen Dateien verändern, können die ODR verletzen, ohne dass eine Diagnose vorgeschrieben ist.

inline-Variablen mit externer Bindung bezeichnen ein einziges Objekt mit einer einzigen Adresse und nicht eine separate Kopie in jeder Datei. inline allein bedeutet weder const noch constexpr: Das counter-Objekt im Beispiel ist veränderbar. Eine constexpr-Funktion ist implizit inline, ebenso ein als constexpr deklariertes statisches Datenelement. Eine gewöhnliche Variable auf Namespace-Ebene wird durch die Deklaration als constexpr nicht implizit zu inline.

Das Beispiel zeigt die Funktion next() und die Variablen counter und step. Aufeinanderfolgende Aufrufe geben 2 und 4 aus. Eine einzelne Datei veranschaulicht Syntax und Zustandsänderungen, weist aber keine gemeinsame Objektidentität über mehrere Translation Units hinweg nach. Der bereitgestellte Quelltext ist ein fortlaufend weiterentwickelter Arbeitsentwurf und keine eingefrorene C++23-Ausgabe.

Beispiele

#include <iostream>

inline int counter = 0;
inline constexpr int step = 2;

inline int next() {
    counter += step;
    return counter;
}

int main() {
    std::cout << next() << '\n';
    std::cout << next() << '\n';
}

Ergebnis

2
4

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen