Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

ABI in PImpl: skrivanje implementacije brez obljube popolne binarne združljivosti

PImpl premakne podatke razreda v skrit implementacijski objekt. Zmanjša odvisnosti od glav in pomaga ohraniti postavitev javnega razreda, vendar sam po sebi ne zagotavlja združljivosti ABI. Ključna sta nepopoln ugnezdeni tip in destruktor, definiran zunaj razreda.

Različica: 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) je nabor pravil, po katerih sodelujejo prevedene komponente; vključuje postavitev objektov, imena simbolov in klicne konvencije. PImpl (pointer to implementation) skrije podatke za kazalcem na ločen objekt. Spremembe polj v Impl ne dodajo polj v Widget, kar pomaga ohraniti binarno mejo in zmanjšati odvisnosti od glav. Vendar to ni prenosljivo zagotovilo združljivosti med prevajalniki, standardnimi knjižnicami ali nastavitvami gradnje.

struct Impl; znotraj Widget deklarira nepopoln ugnezdeni tip. Glava lahko vsebuje std::unique_ptr<Impl>, ne da bi definirala Impl, vendar privzeti brisalnik pri brisanju objekta zahteva popoln tip. Zato v glavi deklariraj ~Widget(); in definiraj Widget::~Widget() = default; po definiciji Impl v implementacijski datoteki. Destruktor je tako definiran zunaj razreda. Tudi konstruktor je postavljen tam, kjer je tip popoln.

extern "C" določa jezikovno vezavo C za ustrezna imena funkcij in spremenljivk ter tipe funkcij; ne skriva podatkov in razredu ne daje postavitve, združljive s C. Ni nadomestilo za PImpl ali univerzalno stikalo za združljivost ABI. Meja, namenjena jeziku C, potrebuje tudi ustrezne tipe parametrov, pravila lastništva in obravnavo napak; izjeme C++ te meje ne bi smele prestopiti.

Primer združuje dele glave, implementacije in odjemalca v eni datoteki. V knjižnici jih loči, da odjemalci ne vidijo Impl. Kopiranje je izrecno onemogočeno, premikanje pa ni omogočeno. Če dodaš operacije premikanja, jih definiraj zunaj razreda po definiciji Impl in določi, kako je dovoljeno uporabljati premaknjene objekte. Stroški vključujejo alokacijo in dodatno posredno dostopanje. Primer uporablja možnost C++23; izvajanje v produkciji ni potrjeno. Pravila izhajajo iz razvijajočega se delovnega osnutka, ne iz nespremenjene izdaje C++23.

Primeri

#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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri