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.