Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

ABI e PImpl: ocultar a implementação sem prometer compatibilidade binária completa

PImpl transfere os dados de uma classe para um objeto de implementação oculto. Reduz as dependências dos cabeçalhos e ajuda a preservar o layout da classe pública, mas, por si só, não garante compatibilidade ABI. Os mecanismos essenciais são um tipo aninhado incompleto e um destrutor definido fora da classe.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

class Widget { struct Impl; std::unique_ptr<Impl> impl_; public: Widget(); ~Widget(); }; // Define Impl, constructor, and destructor in the implementation file.

Uma ABI (Application Binary Interface) é o conjunto de regras que permite a interação entre componentes compilados, incluindo o layout dos objetos, os nomes dos símbolos e as convenções de chamada. PImpl (pointer to implementation) oculta os dados por trás de um ponteiro para um objeto separado. Alterar os campos de Impl não acrescenta campos a Widget, o que ajuda a preservar uma fronteira binária e a reduzir as dependências dos cabeçalhos. No entanto, isto não constitui uma garantia de compatibilidade portável entre compiladores, bibliotecas padrão ou definições de compilação.

Dentro de Widget, struct Impl; declara um tipo aninhado incompleto. Um cabeçalho pode conter std::unique_ptr<Impl> sem definir Impl, mas o seu eliminador predefinido exige um tipo completo quando elimina o objeto. Por isso, declara ~Widget(); no cabeçalho e define Widget::~Widget() = default; depois da definição de Impl no ficheiro de implementação: assim, o destrutor fica definido fora da classe. O construtor também é colocado onde o tipo está completo.

extern "C" especifica a ligação da linguagem C para os nomes aplicáveis de funções e variáveis e para os tipos de função; não oculta dados nem confere a uma classe um layout compatível com C. Não substitui PImpl nem é um interruptor universal de compatibilidade ABI. Uma fronteira destinada a C também requer tipos de parâmetros adequados, regras de propriedade e tratamento de erros; as exceções de C++ não devem atravessar essa fronteira.

O exemplo reúne as secções do cabeçalho, da implementação e do cliente num único ficheiro. Numa biblioteca, separa-as para que os clientes não vejam Impl. A cópia é explicitamente desativada e a classe não disponibiliza operações de movimento em C++ (construtor de movimento e operador de atribuição por movimento). Se as adicionares, define-as fora da classe, depois da definição de Impl, e especifica como pode ser usado o objeto de origem após a operação de movimento. Os custos incluem uma alocação e uma indireção adicional. O exemplo usa a opção C++23; o comportamento em execução num ambiente de produção não é atestado. As regras provêm de um projeto de norma em evolução, não de uma edição C++23 congelada.

Exemplos

#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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes