CKTIS / C++
Variável `inline`: um objeto em várias unidades de tradução
Uma variável `inline` com ligação externa pode ser definida num cabeçalho partilhado. Ao contrário do `const` comum no âmbito de um espaço de nomes do exemplo, designa o mesmo objeto nas várias unidades de tradução.
Versão: ISO C++23; implementation support may vary
Sintaxe
namespace config {
inline const int shared_limit = 42;
const int local_limit = 42;
}Desde C++17, o especificador inline permite declarar uma variável inline. Não promete a expansão do código nem uma execução mais rápida. Uma unidade de tradução é, normalmente, um ficheiro .cpp com o texto dos cabeçalhos incluídos, após o pré-processamento. A ligação externa permite que declarações em unidades de tradução diferentes designem a mesma variável.
A regra da definição única (ODR) proíbe definir a mesma variável duas vezes na mesma unidade de tradução. Em cabeçalhos comuns, fora de módulos com nome, uma variável inline com ligação externa pode, no entanto, ter definições coincidentes em unidades diferentes: estas designam um único objeto com um único endereço. A definição tem de estar acessível a partir do fim de cada unidade em que a variável é usada no sentido da ODR fora de uma instrução descartada. Obter o seu endereço com & numa expressão potencialmente avaliada constitui um uso desse tipo.
A coincidência exige, entre outras condições, a mesma sequência de tokens após o pré-processamento. Regra geral, os nomes correspondentes também têm de designar as mesmas entidades. Se uma macro alterar o inicializador em apenas uma unidade, tornando diferentes os tokens da definição, o programa está mal formado e não é exigido nenhum diagnóstico.
No cabeçalho apresentado, inline const int shared_limit tem ligação externa, enquanto o const int local_limit comum no âmbito de um espaço de nomes tem ligação interna: cada unidade que inclui o cabeçalho tem o seu próprio local_limit. Ambas as variáveis têm duração de armazenamento estática. inline não impõe ligação externa: static inline no âmbito de um espaço de nomes tem ligação interna.
Exemplos
// 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';
}
Resultado
shared: true local: false
Ambos os ficheiros `.cpp` incluem o mesmo cabeçalho. O operador `==` compara apontadores, não os valores `42`: dá `true` para `shared_limit` e `false` para os dois objetos distintos `local_limit`.
Lições relacionadas
- C++ · Lição 7 · Avançado · Versão: 3
Fontes
- WG21 N4950 — C++23 working draft: [lex.phases], [basic.def.odr], [basic.link], [basic.stc.static], [dcl.inline]
- The inline specifier [dcl.inline] — C++ working draft
- One-definition rule [basic.def.odr] — C++ working draft
- Program and linkage [basic.link] — C++ working draft
- WG21 P0636R0 — Changes between C++14 and C++17