Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

Zmienna `inline`: jeden obiekt w wielu jednostkach translacji

Zmienną `inline` o wiązaniu zewnętrznym można zdefiniować w nagłówku dołączanym do kilku jednostek translacji. Zgodne definicje oznaczają jeden obiekt, podczas gdy zwykłe `const` z przykładu tworzy osobny obiekt w każdej jednostce.

Wersja: ISO C++23; implementation support may vary

Składnia

namespace config {
    inline const int shared_limit = 42;
    const int local_limit = 42;
}

Od C++17 specyfikator inline deklaruje zmienną inline. Nie jest obietnicą rozwijania kodu ani przyspieszenia programu. Jednostka translacji to w typowym przypadku plik .cpp wraz z tekstem dołączonych nagłówków po przetworzeniu przez preprocesor. Wiązanie zewnętrzne pozwala, by deklaracje w różnych jednostkach translacji oznaczały tę samą zmienną.

Reguła jednej definicji (ODR) nie pozwala zdefiniować tej samej zmiennej dwukrotnie w jednej jednostce translacji. W zwykłych nagłówkach poza modułami nazwanymi zmienna inline o wiązaniu zewnętrznym może jednak mieć zgodne definicje w różnych jednostkach: oznaczają one jeden obiekt o jednym adresie. Definicja musi być osiągalna z końca każdej jednostki, w której zmienna jest użyta w sensie ODR poza odrzuconą instrukcją. Pobranie adresu operatorem & w potencjalnie ewaluowanym wyrażeniu jest takim użyciem.

Zgodność wymaga m.in. tej samej sekwencji tokenów po przetworzeniu przez preprocesor. Odpowiadające sobie nazwy co do zasady muszą też wskazywać te same byty. Jeśli makro zmieni inicjalizator tylko w jednej jednostce, zmieniając tokeny definicji, program jest niepoprawny, a kompilator nie musi tego zgłosić.

W pokazanym nagłówku inline const int shared_limit ma wiązanie zewnętrzne, a zwykłe const int local_limit w zakresie przestrzeni nazw ma wiązanie wewnętrzne: każda jednostka dołączająca nagłówek ma własny local_limit. Obie zmienne mają statyczny czas przechowywania. Samo inline nie wymusza wiązania zewnętrznego: static inline w zakresie przestrzeni nazw ma wiązanie wewnętrzne.

Przykłady

// limits.hpp
#ifndef CKTIS_LIMITS_HPP_INCLUDED
#define CKTIS_LIMITS_HPP_INCLUDED

namespace config {
    inline const int shared_limit = 42;
    const int local_limit = 42;
}

#endif

// other.cpp
#include "limits.hpp"

const int* shared_from_other() {
    return &config::shared_limit;
}

const int* local_from_other() {
    return &config::local_limit;
}

// main.cpp
#include "limits.hpp"
#include <iostream>

const int* shared_from_other();
const int* local_from_other();

int main() {
    std::cout << std::boolalpha
              << "shared: " << (&config::shared_limit == shared_from_other()) << '\n'
              << "local: " << (&config::local_limit == local_from_other()) << '\n';
}

Wynik

shared: true
local: false

Oba pliki `.cpp` dołączają ten sam nagłówek. Operator `==` porównuje wskaźniki, nie wartości `42`: dla `shared_limit` wynik to `true`, a dla dwóch osobnych obiektów `local_limit` — `false`.

Powiązane lekcje

  • C++ · Lekcja 7 · Zaawansowany · Wersja: 3

Źródła