Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

ABI i PImpl: ukrywanie implementacji bez obietnicy pełnej zgodności binarnej

PImpl przenosi dane klasy do ukrytego obiektu implementacji. Ogranicza zależności nagłówków i pomaga zachować układ publicznej klasy, ale nie zapewnia samodzielnie zgodności ABI. Kluczowe są niekompletny typ zagnieżdżony i destruktor zdefiniowany poza klasą.

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

Składnia

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) to reguły współpracy skompilowanych komponentów, obejmujące m.in. układ obiektów, nazwy symboli i konwencje wywołań. PImpl (pointer to implementation) ukrywa dane za wskaźnikiem do osobnego obiektu. Zmiana pól Impl nie dodaje pól do Widget, co pomaga utrzymać granicę binarną i ogranicza zależności nagłówków. Nie jest to jednak przenośna gwarancja zgodności między kompilatorami, bibliotekami standardowymi ani ustawieniami kompilacji.

Deklaracja struct Impl; w Widget wprowadza niekompletny typ zagnieżdżony. Nagłówek może zawierać std::unique_ptr<Impl> bez definicji Impl, lecz domyślny deleter wymaga kompletnego typu przy usuwaniu obiektu. Dlatego deklaruj ~Widget(); w nagłówku, a Widget::~Widget() = default; definiuj po definicji Impl w pliku implementacji. Także konstruktor umieszczono tam, gdzie typ jest kompletny.

extern "C" określa wiązanie językowe C dla odpowiednich nazw funkcji i zmiennych oraz typów funkcji; nie ukrywa danych i nie nadaje klasie układu zgodnego z C. Nie jest zamiennikiem PImpl ani uniwersalnym przełącznikiem zgodności ABI. Granica przeznaczona dla C wymaga również odpowiednich typów parametrów, zasad własności i obsługi błędów; wyjątki C++ nie powinny przekraczać tej granicy.

Przykład łączy sekcje nagłówka, implementacji i klienta w jednym pliku. W bibliotece należy je rozdzielić, aby klient nie widział Impl. Kopiowanie jest jawnie zabronione, a przenoszenie nie jest udostępnione; jeżeli je dodasz, zdefiniuj operacje przenoszenia poza klasą po definicji Impl i ustal zasady używania obiektu po przeniesieniu. Koszt wzorca obejmuje alokację i dodatkowe odwołanie pośrednie. Przykład używa flagi C++23; nie potwierdza działania w środowisku produkcyjnym. Źródłem reguł jest rozwijany projekt standardu, nie zamrożone wydanie C++23.

Przykłady

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

Wynik

42

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła