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

CKTIS / C++

Unidades de tradução, linkage e a ODR

As unidades de tradução permitem traduzir separadamente partes de um programa. O linkage determina a identidade dos nomes entre declarações, enquanto a ODR limita o número e a forma das definições. Distinguir estes conceitos ajuda a dividir corretamente o código entre ficheiros de cabeçalho e de implementação.

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

Sintaxe

extern int counter; // declaration
int counter = 0; // definition
static int local_counter = 0; // namespace-scope internal linkage
namespace { int private_counter = 0; }

Unidade de tradução

Num programa típico sem módulos, uma unidade de tradução é um ficheiro-fonte processado juntamente com o conteúdo incluído através de #include, após a compilação condicional. Por isso, um cabeçalho não é automaticamente uma unidade separada. As unidades podem ser traduzidas separadamente e depois ligadas.

Linkage e âmbito

O âmbito determina onde um nome pode ser encontrado; o linkage determina se as declarações podem designar a mesma entidade. O linkage externo permite que as declarações correspondam entre unidades. O linkage interno limita-as a uma unidade; entre outros casos, é fornecido por static ao nível do espaço de nomes e por espaços de nomes sem nome. O linkage de módulo diz respeito a declarações associadas ao mesmo módulo com nome. Uma variável local comum não tem linkage. O linkage não determina o tempo de vida de um objeto.

ODR — regra da definição única

A declaração extern int counter; não define um objeto; int counter = 0; define. A mesma entidade definível não pode ser definida repetidamente numa unidade. Uma função ou variável utilizada de uma forma que exige uma definição (odr-use), fora de uma instrução descartada, tem de ter uma definição. Uma função ou variável comum que não seja um template nem inline não pode ter várias definições no programa. Tipos de classe, templates e entidades inline só podem ter definições em várias unidades se forem respeitadas as condições da ODR. Estas incluem, entre outras, a correspondência dos tokens e da pesquisa de nomes, e a ausência de associação a um módulo com nome. Nem todas as violações exigem um diagnóstico.

Exemplo e limitações

counter.cpp e main.cpp formam duas unidades. Ambas declaram o mesmo counter, mas só a primeira o define; step mantém-se interno. A guarda do cabeçalho impede a repetição do seu conteúdo dentro de uma unidade, mas não as definições duplicadas entre unidades. As fontes são um projeto de norma em evolução, não um texto C++23 definitivo. O exemplo destina-se a verificação local com a opção C++23 e não certifica um ambiente de execução de produção.

Identificadores de referência abrangidos por esta entrada: ODR / linkage / translation unit.

Exemplos

// counter.hpp
#ifndef COUNTER_HPP
#define COUNTER_HPP
extern int counter;
int next();
#endif

// counter.cpp
#include "counter.hpp"
namespace { int step = 2; }
int counter = 0;
int next() { return counter += step; }

// main.cpp
#include "counter.hpp"
#include <iostream>
int main() {
    std::cout << next() << '\n';
    std::cout << counter << '\n';
}

Resultado

2
2

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