WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

ABI und PImpl: Implementierung verbergen, ohne vollständige Binärkompatibilität zu versprechen

PImpl verschiebt die Daten einer Klasse in ein verborgenes Implementierungsobjekt. Das reduziert Header-Abhängigkeiten und hilft, das Layout der öffentlichen Klasse zu erhalten, garantiert aber für sich allein keine ABI-Kompatibilität. Entscheidend sind ein unvollständiger verschachtelter Typ und ein außerhalb der Klasse definierter Destruktor.

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

Syntax

class Widget { struct Impl; std::unique_ptr<Impl> impl_; public: Widget(); ~Widget(); }; // Define Impl, constructor, and destructor in the implementation file.

Eine ABI (Application Binary Interface) umfasst die Regeln, nach denen kompilierte Komponenten zusammenarbeiten, darunter Objektlayouts, Symbolnamen und Aufrufkonventionen. PImpl (pointer to implementation) verbirgt Daten hinter einem Zeiger auf ein separates Objekt. Änderungen an den Feldern von Impl fügen Widget keine Felder hinzu und helfen so, eine Binärschnittstelle zu erhalten und Header-Abhängigkeiten zu reduzieren. Das ist jedoch keine portable Kompatibilitätsgarantie über Compiler, Standardbibliotheken oder Build-Einstellungen hinweg.

struct Impl; innerhalb von Widget deklariert einen unvollständigen verschachtelten Typ. Ein Header kann std::unique_ptr<Impl> enthalten, ohne Impl zu definieren; der Standard-Deleter benötigt beim Löschen des Objekts jedoch einen vollständigen Typ. Deklariere daher ~Widget(); im Header und definiere Widget::~Widget() = default; nach der Definition von Impl in der Implementierungsdatei. Auch der Konstruktor steht dort, wo der Typ vollständig ist.

extern "C" legt für entsprechende Funktions- und Variablennamen sowie Funktionstypen die C-Sprachbindung fest; es verbirgt weder Daten noch verleiht es einer Klasse ein C-kompatibles Layout. Es ist kein Ersatz für PImpl und kein universeller Schalter für ABI-Kompatibilität. Eine für C vorgesehene Schnittstelle benötigt außerdem geeignete Parametertypen, Regeln zur Besitzverwaltung und Fehlerbehandlung; C++-Ausnahmen sollten diese Schnittstelle nicht überschreiten.

Das Beispiel vereint Header-, Implementierungs- und Clientabschnitte in einer Datei. Teile sie in einer Bibliothek auf, damit Clients Impl nicht sehen. Kopieren ist ausdrücklich deaktiviert; Verschieben ist nicht vorgesehen. Falls du Verschiebeoperationen hinzufügst, definiere sie nach Impl außerhalb der Klasse und lege fest, wie Objekte nach dem Verschieben verwendet werden dürfen. Zu den Kosten zählen eine Allokation und ein zusätzlicher Indirektionsschritt. Das Beispiel verwendet den C++23-Compiler-Schalter; das Laufzeitverhalten in einer Produktionsumgebung wird nicht bestätigt. Die Regeln stammen aus einem fortlaufend weiterentwickelten Arbeitsentwurf, nicht aus einer eingefrorenen C++23-Ausgabe.

Beispiele

#include <iostream>
#include <memory>

// Public header section
class Widget {
public:
    Widget();
    ~Widget();
    Widget(const Widget&) = delete;
    Widget& operator=(const Widget&) = delete;
    int value() const;
private:
    struct Impl;
    std::unique_ptr<Impl> impl_;
};

// Implementation section
struct Widget::Impl {
    int value = 42;
};

Widget::Widget() : impl_(std::make_unique<Impl>()) {}
Widget::~Widget() = default;
int Widget::value() const { return impl_->value; }

int main() {
    Widget widget;
    std::cout << widget.value() << '\n';
}

Ergebnis

42

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