Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje