CKTIS / C++
ABI a PImpl: skrytí implementace bez příslibu úplné binární kompatibility
PImpl přesouvá data třídy do skrytého implementačního objektu. Omezuje závislosti hlaviček a pomáhá zachovat rozložení veřejné třídy, ale sám o sobě nezaručuje kompatibilitu ABI. Klíčové jsou neúplný vnořený typ a destruktor definovaný mimo třídu.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
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 soubor pravidel, podle kterých spolupracují zkompilované komponenty; zahrnuje například rozložení objektů, názvy symbolů a konvence volání. PImpl (pointer to implementation) skrývá data za ukazatelem na samostatný objekt. Změna polí v Impl nepřidává pole do Widget, což pomáhá zachovat binární rozhraní a omezit závislosti hlaviček. Nejde však o přenosnou záruku kompatibility napříč překladači, standardními knihovnami ani nastaveními sestavení.
struct Impl; uvnitř Widget deklaruje neúplný vnořený typ. Hlavička může obsahovat std::unique_ptr<Impl> bez definice Impl, jeho výchozí deleter ale při mazání objektu vyžaduje úplný typ. Proto deklaruj ~Widget(); v hlavičce a definuj Widget::~Widget() = default; až po definici Impl v implementačním souboru. Destruktor je tak definován mimo třídu. Také konstruktor je umístěn tam, kde je typ úplný.
extern "C" určuje jazykovou vazbu C pro příslušné názvy funkcí a proměnných i typy funkcí; neskrývá data ani nedává třídě rozložení kompatibilní s C. Není náhradou za PImpl ani univerzálním přepínačem kompatibility ABI. Rozhraní určené pro C potřebuje také vhodné typy parametrů, pravidla vlastnictví a zpracování chyb; výjimky C++ by toto rozhraní neměly překračovat.
Příklad spojuje části hlavičky, implementace a klienta do jednoho souboru. V knihovně je rozděl, aby klienti neviděli Impl. Kopírování je výslovně zakázáno a přesun není poskytován. Pokud přidáš přesunovací operace, definuj je mimo třídu až po definici Impl a stanov, jak lze používat objekty po přesunu. Náklady zahrnují alokaci a další úroveň nepřímého přístupu. Příklad používá přepínač C++23; chování za běhu v produkci není ověřeno. Pravidla vycházejí z průběžně upravovaného pracovního návrhu, nikoli z neměnného vydání C++23.
Pří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ýsledek
42
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.