Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes