CKTIS / C++
ABI y PImpl: ocultar la implementación sin prometer compatibilidad binaria completa
PImpl traslada los datos de una clase a un objeto de implementación oculto. Reduce las dependencias de los encabezados y ayuda a conservar el diseño de la clase pública, pero por sí solo no garantiza la compatibilidad ABI. Los mecanismos clave son un tipo anidado incompleto y un destructor definido fuera de la clase.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
class Widget { struct Impl; std::unique_ptr<Impl> impl_; public: Widget(); ~Widget(); }; // Define Impl, constructor, and destructor in the implementation file.Una ABI (Application Binary Interface) es el conjunto de reglas que permite interactuar a los componentes compilados, e incluye el diseño de los objetos, los nombres de los símbolos y las convenciones de llamada. PImpl (pointer to implementation) oculta los datos tras un puntero a un objeto separado. Cambiar los campos de Impl no añade campos a Widget, lo que ayuda a conservar una frontera binaria y a reducir las dependencias de los encabezados. Sin embargo, esto no es una garantía de compatibilidad portable entre compiladores, bibliotecas estándar o configuraciones de compilación.
Dentro de Widget, struct Impl; declara un tipo anidado incompleto. Un encabezado puede contener std::unique_ptr<Impl> sin definir Impl, pero su eliminador predeterminado necesita un tipo completo al borrar el objeto. Por eso, declara ~Widget(); en el encabezado y define Widget::~Widget() = default; después de definir Impl en el archivo de implementación: así, el destructor queda definido fuera de la clase. El constructor también se sitúa donde el tipo está completo.
extern "C" especifica el enlace del lenguaje C para los nombres de funciones y variables aplicables y los tipos de función; no oculta datos ni da a una clase un diseño compatible con C. No sustituye a PImpl ni es un interruptor universal de compatibilidad ABI. Una frontera destinada a C también necesita tipos de parámetros adecuados, reglas de propiedad y gestión de errores; las excepciones de C++ no deberían cruzar esa frontera.
El ejemplo combina las secciones del encabezado, la implementación y el cliente en un solo archivo. En una biblioteca, sepáralas para que los clientes no vean Impl. La copia está deshabilitada explícitamente y no se proporcionan operaciones de movimiento. Si las añades, defínelas fuera de la clase después de Impl y especifica cómo se pueden usar los objetos después de moverlos. Entre los costes están una asignación y una indirección adicional. El ejemplo usa la opción C++23; no se certifica el comportamiento en tiempo de ejecución en producción. Las reglas proceden de un borrador de trabajo en evolución, no de una edición C++23 congelada.
Ejemplos
#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';
}
Resultado
42
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.