CKTIS / C++
Jednostki translacji, linkage i reguła ODR
Jednostki translacji pozwalają osobno tłumaczyć części programu. Linkage określa tożsamość nazw między deklaracjami, a ODR ogranicza liczbę i postać definicji. Rozróżnienie tych pojęć pomaga poprawnie dzielić kod między nagłówki i pliki implementacji.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
extern int counter; // declaration
int counter = 0; // definition
static int local_counter = 0; // namespace-scope internal linkage
namespace { int private_counter = 0; }Jednostka translacji
W typowym programie bez modułów jednostka translacji to przetworzony plik źródłowy wraz z zawartością dołączoną przez #include, po uwzględnieniu kompilacji warunkowej. Nagłówek nie jest więc automatycznie osobną jednostką. Jednostki można tłumaczyć oddzielnie, a następnie łączyć.
Linkage a zakres
Zakres określa, gdzie można znaleźć nazwę; linkage określa, czy deklaracje mogą wskazywać ten sam byt. External linkage pozwala łączyć deklaracje między jednostkami. Internal linkage ogranicza je do jednej jednostki; na poziomie przestrzeni nazw zapewniają je m.in. static i nienazwana przestrzeń nazw. Module linkage dotyczy deklaracji związanych z tym samym nazwanym modułem. Zwykła zmienna lokalna ma no linkage. Linkage nie określa czasu życia obiektu.
ODR — one-definition rule
Deklaracja extern int counter; nie definiuje obiektu; int counter = 0; go definiuje. W jednej jednostce nie wolno wielokrotnie definiować tego samego elementu definiowalnego. Funkcja lub zmienna użyta w sposób wymagający definicji (odr-use) poza odrzuconą instrukcją musi mieć definicję. Zwykła funkcja lub zmienna niebędąca szablonem ani inline nie może mieć wielu definicji w programie. Typy klas, szablony i elementy inline mogą mieć definicje w wielu jednostkach tylko na warunkach ODR, m.in. zgodności tokenów i wyszukiwania nazw oraz braku powiązania z nazwanym modułem. Nie każde naruszenie wymaga diagnostyki.
Przykład i ograniczenia
counter.cpp i main.cpp tworzą dwie jednostki. Obie deklarują ten sam counter, ale tylko pierwsza go definiuje; step pozostaje wewnętrzny. Strażnik nagłówka zapobiega powtórzeniu jego treści w jednej jednostce, nie duplikatom definicji między jednostkami. Źródła to rozwijany szkic standardu, nie zamrożony tekst C++23; przykład przeznaczono do lokalnej weryfikacji z flagą C++23, bez poświadczenia środowiska produkcyjnego.
Identyfikatory objęte tym wpisem: ODR / linkage / translation unit.
Przykłady
// 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';
}
Wynik
2 2
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.