CKTIS / C++
ABI a PImpl: skrytie implementácie bez prísľubu úplnej binárnej kompatibility
PImpl presúva údaje triedy do skrytého implementačného objektu. Obmedzuje závislosti hlavičiek a pomáha zachovať rozloženie verejnej triedy, ale sám osebe nezaručuje kompatibilitu ABI. Kľúčové sú neúplný vnorený typ a deštruktor definovaný mimo triedy.
Verzia: 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.ABI (Application Binary Interface) je súbor pravidiel, podľa ktorých spolupracujú skompilované komponenty; patrí sem rozloženie objektov, názvy symbolov a konvencie volania. PImpl (pointer to implementation) skrýva údaje za ukazovateľom na samostatný objekt. Zmena polí v Impl nepridáva polia do Widget, čo pomáha zachovať binárne rozhranie a obmedziť závislosti hlavičiek. Nejde však o prenosnú záruku kompatibility naprieč kompilátormi, štandardnými knižnicami ani nastaveniami zostavenia.
struct Impl; vnútri Widget deklaruje neúplný vnorený typ. Hlavička môže obsahovať std::unique_ptr<Impl> bez definície Impl, ale jeho predvolený deleter pri odstraňovaní objektu vyžaduje úplný typ. Preto deklaruj ~Widget(); v hlavičke a definuj Widget::~Widget() = default; až po definícii Impl v implementačnom súbore. Deštruktor je tak definovaný mimo triedy. Aj konštruktor je umiestnený tam, kde je typ úplný.
extern "C" určuje jazykovú väzbu C pre príslušné názvy funkcií a premenných, ako aj typy funkcií; neskrýva údaje ani nedáva triede rozloženie kompatibilné s C. Nie je náhradou za PImpl ani univerzálnym prepínačom kompatibility ABI. Rozhranie určené pre C potrebuje aj vhodné typy parametrov, pravidlá vlastníctva a spracovanie chýb; výnimky C++ by toto rozhranie nemali prekračovať.
Príklad spája časti hlavičky, implementácie a klienta do jedného súboru. V knižnici ich rozdeľ, aby klienti nevideli Impl. Kopírovanie je výslovne zakázané a presun nie je poskytnutý. Ak pridáš presúvacie operácie, definuj ich mimo triedy až po definícii Impl a stanov, ako možno používať objekty po presune. Náklady zahŕňajú alokáciu a ďalšiu úroveň nepriameho prístupu. Príklad používa prepínač C++23; správanie za behu v produkcii nie je potvrdené. Pravidlá pochádzajú z priebežne vyvíjaného pracovného návrhu, nie zo zmrazeného vydania C++23.
Príklady
#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';
}
Výsledok
42
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.