CKTIS / C++
Variable `inline`: un objeto en varias unidades de traducción
Una variable `inline` con enlace externo puede definirse en una cabecera compartida. A diferencia del `const` ordinario de ámbito de espacio de nombres del ejemplo, designa el mismo objeto en las distintas unidades de traducción.
Versión: ISO C++23; implementation support may vary
Sintaxis
namespace config {
inline const int shared_limit = 42;
const int local_limit = 42;
}Desde C++17, el especificador inline permite declarar una variable inline. No promete que se expanda código ni que la ejecución sea más rápida. Una unidad de traducción suele ser un archivo .cpp junto con el texto de las cabeceras incluidas, tras el preprocesamiento. El enlace externo permite que las declaraciones de distintas unidades de traducción designen la misma variable.
La regla de una sola definición (ODR) prohíbe definir dos veces la misma variable en una unidad de traducción. Sin embargo, en cabeceras ordinarias ajenas a módulos con nombre, una variable inline con enlace externo puede tener definiciones coincidentes en distintas unidades: designan un solo objeto con una sola dirección. Su definición debe ser alcanzable desde el final de cada unidad en la que se use en el sentido de la ODR fuera de una sentencia descartada. Tomar su dirección con & en una expresión potencialmente evaluada es uno de esos usos.
La coincidencia exige, entre otras cosas, la misma secuencia de tokens tras el preprocesamiento. Por regla general, los nombres correspondientes también deben resolverse a las mismas entidades. Si una macro cambia el inicializador en una sola unidad y hace que los tokens de la definición difieran, el programa está mal formado y no se exige un diagnóstico.
En la cabecera del ejemplo, inline const int shared_limit tiene enlace externo, mientras que el const int local_limit ordinario en el ámbito de un espacio de nombres tiene enlace interno: cada unidad que incluye la cabecera tiene su propio local_limit. Ambas variables tienen duración de almacenamiento estática. inline no impone el enlace externo: static inline en el ámbito de un espacio de nombres tiene enlace interno.
Ejemplos
// 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
Los dos archivos `.cpp` incluyen la misma cabecera. El operador `==` compara punteros, no los valores `42`: da `true` para `shared_limit` y `false` para los dos objetos `local_limit` distintos.
Lecciones relacionadas
- C++ · Lección 7 · Avanzado · Versión: 3
Fuentes
- 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