Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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