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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.