Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

Unità di traduzione, linkage e ODR

Le unità di traduzione permettono di tradurre separatamente parti di un programma. Il linkage determina l’identità dei nomi tra dichiarazioni, mentre l’ODR limita il numero e la forma delle definizioni. Distinguere questi concetti aiuta a suddividere correttamente il codice tra header e file di implementazione.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

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

Unità di traduzione

In un programma tipico senza moduli, un’unità di traduzione è un file sorgente elaborato insieme al contenuto incluso tramite #include, dopo aver applicato la compilazione condizionale. Un header, quindi, non è automaticamente un’unità separata. Le unità possono essere tradotte separatamente e poi collegate.

Linkage e ambito

L’ambito determina dove è possibile trovare un nome; il linkage determina se le dichiarazioni possono indicare la stessa entità. Il linkage esterno permette alle dichiarazioni di corrispondere tra unità. Il linkage interno le limita a una sola unità; tra gli altri casi, lo forniscono static a livello di namespace e i namespace senza nome. Il linkage di modulo riguarda le dichiarazioni associate allo stesso modulo con nome. Una normale variabile locale non ha linkage. Il linkage non determina la durata di vita di un oggetto.

ODR — regola della definizione unica

La dichiarazione extern int counter; non definisce un oggetto; int counter = 0; invece sì. La stessa entità definibile non può essere definita più volte in un’unità. Una funzione o variabile usata in modo da richiedere una definizione (odr-use), al di fuori di un’istruzione scartata, deve avere una definizione. Una normale funzione o variabile che non sia un template né inline non può avere più definizioni nel programma. Tipi di classe, template ed entità inline possono avere definizioni in più unità solo rispettando le condizioni dell’ODR. Tra queste rientrano la corrispondenza dei token e della ricerca dei nomi, e la mancata associazione a un modulo con nome. Non tutte le violazioni richiedono una diagnosi.

Esempio e limiti

counter.cpp e main.cpp formano due unità. Entrambe dichiarano lo stesso counter, ma solo la prima lo definisce; step resta interno. La guardia dell’header impedisce di ripetere il contenuto dell’header all’interno di un’unità, non le definizioni duplicate tra unità. Le fonti sono una bozza dello standard in evoluzione, non un testo C++23 definitivo. L’esempio è destinato a una verifica locale con l’opzione C++23 e non certifica un ambiente di esecuzione di produzione.

Identificatori di riferimento trattati in questa voce: ODR / linkage / translation unit.

Esempi

// 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';
}

Risultato

2
2

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti