Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje