CKTIS / C++
ABI en PImpl: implementatie verbergen zonder volledige binaire compatibiliteit te beloven
PImpl verplaatst de gegevens van een klasse naar een verborgen implementatieobject. Het vermindert afhankelijkheden van headers en helpt de indeling van de publieke klasse te behouden, maar garandeert op zichzelf geen ABI-compatibiliteit. De belangrijkste onderdelen zijn een onvolledig genest type en een destructor die buiten de klasse wordt gedefinieerd.
Versie: 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.Een ABI (Application Binary Interface) is het geheel van regels waarmee gecompileerde componenten samenwerken, waaronder objectindeling, symboolnamen en aanroepconventies. PImpl (pointer to implementation) verbergt gegevens achter een pointer naar een afzonderlijk object. Wijzigingen aan velden van Impl voegen geen velden toe aan Widget; dit helpt een binaire grens te behouden en headerafhankelijkheden te verminderen. Het is echter geen draagbare compatibiliteitsgarantie voor verschillende compilers, standaardbibliotheken of buildinstellingen.
Binnen Widget declareert struct Impl; een onvolledig genest type. Een header kan std::unique_ptr<Impl> bevatten zonder Impl te definiëren, maar de standaarddeleter vereist een compleet type wanneer het object wordt verwijderd. Declareer daarom ~Widget(); in de header en definieer Widget::~Widget() = default; na de definitie van Impl in het implementatiebestand. Zo staat de destructor buiten de klasse gedefinieerd. Ook de constructor staat op een plek waar het type compleet is.
extern "C" specificeert C-taalkoppeling voor toepasselijke functie- en variabelenamen en functietypen; het verbergt geen gegevens en geeft een klasse geen C-compatibele indeling. Het is geen vervanging voor PImpl en geen universele schakelaar voor ABI-compatibiliteit. Een grens die voor C is bedoeld, vereist ook geschikte parametertypen, eigendomsregels en foutafhandeling; C++-uitzonderingen horen die grens niet over te steken.
Het voorbeeld combineert de header-, implementatie- en clientgedeelten in één bestand. Splits deze in een bibliotheek, zodat clients Impl niet kunnen zien. Kopiëren is expliciet uitgeschakeld en verplaatsen is niet beschikbaar. Voeg je verplaatsingsbewerkingen toe, definieer ze dan buiten de klasse, na Impl, en leg vast hoe objecten na het verplaatsen mogen worden gebruikt. De kosten zijn onder meer een allocatie en een extra indirectie. Het voorbeeld gebruikt de C++23-optie; gedrag in een productieomgeving wordt niet bevestigd. De regels zijn afkomstig uit een evoluerend werkconcept, niet uit een bevroren C++23-editie.
Voorbeelden
#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';
}
Resultaat
42
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.