Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

ABI i PImpl: skrivanje implementacije bez obećanja potpune binarne kompatibilnosti

PImpl premješta podatke klase u skriveni implementacijski objekt. Smanjuje ovisnosti o zaglavljima i pomaže očuvati raspored javne klase, ali sam po sebi ne jamči kompatibilnost ABI-ja. Ključni su nepotpun ugniježđeni tip i destruktor definiran izvan klase.

Verzija: C++23; repository compiler flag, production runtime not attested

Sintaksa

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) skup je pravila prema kojima surađuju prevedene komponente, a obuhvaća raspored objekata, nazive simbola i konvencije pozivanja. PImpl (pointer to implementation) skriva podatke iza pokazivača na zaseban objekt. Promjene polja u Impl ne dodaju polja u Widget, što pomaže očuvati binarnu granicu i smanjiti ovisnosti o zaglavljima. To ipak nije prenosivo jamstvo kompatibilnosti među prevoditeljima, standardnim bibliotekama ili postavkama izgradnje.

struct Impl; unutar Widget deklarira nepotpun ugniježđeni tip. Zaglavlje može sadržavati std::unique_ptr<Impl> bez definicije Impl, ali njegov zadani brisač pri brisanju objekta zahtijeva potpun tip. Zato deklariraj ~Widget(); u zaglavlju i definiraj Widget::~Widget() = default; nakon definicije Impl u implementacijskoj datoteci. Tako je destruktor definiran izvan klase. I konstruktor se nalazi ondje gdje je tip potpun.

extern "C" određuje jezično povezivanje C za odgovarajuće nazive funkcija i varijabli te tipove funkcija; ne skriva podatke niti klasi daje raspored kompatibilan s C-om. Nije zamjena za PImpl ni univerzalni prekidač za kompatibilnost ABI-ja. Granica namijenjena jeziku C treba i odgovarajuće tipove parametara, pravila vlasništva i obradu pogrešaka; iznimke C++-a ne bi trebale prelaziti tu granicu.

Primjer objedinjuje dijelove zaglavlja, implementacije i klijenta u jednoj datoteci. U biblioteci ih razdvoji kako klijenti ne bi vidjeli Impl. Kopiranje je izričito onemogućeno, a premještanje nije omogućeno. Ako dodaš operacije premještanja, definiraj ih izvan klase nakon definicije Impl i odredi kako se smiju upotrebljavati objekti nakon premještanja. Troškovi uključuju alokaciju i dodatnu indirekciju. Primjer koristi opciju C++23; ponašanje pri izvođenju u produkciji nije potvrđeno. Pravila potječu iz radnog nacrta koji se razvija, a ne iz zamrznutog izdanja C++23.

Primjeri

#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';
}

Rezultat

42

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori