База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

ABI и PImpl: скриване на реализацията без обещание за пълна бинарна съвместимост

PImpl премества данните на класа в скрит обект за реализация. Това намалява зависимостите от заглавни файлове и помага да се запази разположението на публичния клас, но само по себе си не гарантира ABI съвместимост. Ключови са непълен вложен тип и деструктор, дефиниран извън класа.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

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) е наборът от правила, по които взаимодействат компилираните компоненти, включително разположението на обектите, имената на символите и конвенциите за извикване. PImpl (pointer to implementation) скрива данните зад указател към отделен обект. Промените в полетата на Impl не добавят полета към Widget, което помага да се запази бинарната граница и да се намалят зависимостите от заглавни файлове. Това обаче не е преносима гаранция за съвместимост между компилатори, стандартни библиотеки или настройки за компилация.

struct Impl; вътре в Widget декларира непълен вложен тип. Заглавният файл може да съдържа std::unique_ptr<Impl> без дефиниция на Impl, но при изтриване на обекта механизмът за изтриване по подразбиране (std::default_delete<Impl>) изисква типът Impl да е пълен. Затова декларирай ~Widget(); в заглавния файл и дефинирай Widget::~Widget() = default; след дефиницията на Impl във файла за реализация. Така деструкторът е дефиниран извън класа. Конструкторът също е поставен там, където типът е пълен.

extern "C" задава езиково свързване с C за съответните имена на функции и променливи и за типовете на функциите; то нито скрива данни, нито придава на класа разположение, съвместимо с C. Не е заместител на PImpl или универсален превключвател за ABI съвместимост. Граница, предназначена за C, изисква също подходящи типове на параметрите, правила за собственост и обработка на грешки; изключенията на C++ не бива да преминават през тази граница.

Примерът обединява частите за заглавен файл, реализация и клиент в един файл. В библиотека ги раздели, така че клиентите да не виждат Impl. Копирането е изрично забранено, а преместване не е предоставено. Ако добавиш операции за преместване, дефинирай ги извън класа след дефиницията на Impl и определи как могат да се използват преместените обекти. Разходите включват заделяне на памет и допълнително ниво на косвен достъп. Примерът използва опцията C++23; поведението при изпълнение в производствена среда не е удостоверено. Правилата са от развиващ се работен проект, а не от замразено издание на C++23.

Примери

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

Резултат

42

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници