atributo de C++: deprecated (desde C++14)

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos (C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación (C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos (C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos (C++17)

Biblioteca de apoyo de concurrencia (C++11)

Biblioteca de apoyo de ejecución (C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Lenguaje C++

 

Declaraciones

Resumen sintaxis de declaración sec-decl-especificadores declarador Especificadores typedef inline especificador de función virtual especificador de función explicit friend constexpr (C++11) consteval (C++20) constinit (C++20) especificadores de clase de almacenamiento classstruct union enum decltype (C++11) auto (C++11) alignas (C++11) constvolatile especificador de tipo elaborado atributos (C++11)

Declaradores referencia puntero array Declaraciones de bloques declaración simple → declaración de vínculos estructurados (C++17) declaración de alias(C++11) definición de alias de espacio de nombres declaración using directiva using declaración static_assert (C++11) declaración asm declaración de enum opaca(C++11) Otras declaraciones definición de espacio de nombres declaración de función declaración de plantilla de clase declaración de plantilla de función creación de plantilla explícita(C++11) especialización de plantilla explícita especificación de vinculación declaración de atributos (C++11) declaración vacía

 

Atributos

assume (C++23)

carries_dependency (C++11)

deprecated (C++14)

fallthrough (C++17)

indeterminate (C++26)

likely (C++20)

maybe_unused (C++17)

nodiscard (C++17)

noreturn (C++11)

no_unique_address (C++20)

optimize_for_synchronized (TM TS)

unlikely (C++20)

 

See More

Inidica que el nombre o entidad declarado(a) con este atributo se encuentra en desuso u obsoleto. Es decir, se permite su uso, pero se desalienta por alguna razón.

Sintaxis

[[deprecated]]	(1)
[[deprecated( literal-de-cadena )]]	(2)

literal-de-cadena

-

Texto que podría ser usado para explicar el razonamiento para la obsolescencia o sugerir una entidad que la reemplace.

Explicación

Indica que el uso del nombre o entidad declarado(a) con este atributo se permite, pero no se aconseja por alguna razón. Los compiladores típicamente generan advertencias en tales usos. El literal-de-cadena, si se especifica, habitualmente se incluye en las advertencias.

Se permite este atributo en las declaraciones de los siguientes nombres o entidades:

• class/struct/union: struct [[deprecated]] S;,
• nombre-typedef, incluyendo aquellos declarados por una declaración de alias: [[deprecated]] typedef S* PS;, using PS [[deprecated]] = S*;,
• variable, incluyendo datos miembro estáticos: [[deprecated]] int x;,
• datos miembro no-estáticos: union U { [[deprecated]] int n; };,
• función: [[deprecated]] void f();,
• espacio de nombres: namespace [[deprecated]] NS { int x; }
• enumeración: enum [[deprecated]] E {};,
• enumerador: enum { A [[deprecated]], B [[deprecated]] = 42 };.
• especialización de plantilla: template<> struct [[deprecated]] X<int> {};

Un nombre declarado como no obsoleto puede ser redeclarado como obsoleto o en desuso. Un nombre declarado como obsoleto o en desuso no puede revertirse como no obsoleto volviéndolo a declarar sin este atributo.

Ejemplo

Ejecuta este código

#include <iostream>

[[deprecated]]
void PeriodoTriasico() {
    std::clog << "Periodo Triásico: hace [251.9 - 208.5] millones de años.\n";
}

[[deprecated("Use es su lugar PeriodoNeogeno().")]]
void PeriodoJurasico() {
    std::clog << "Periodo Jurásico: hace [201.3 - 152.1] millones de años.\n";
}

[[deprecated("Use calcularAlgoDiferente(int).")]]    
int calcularAlgo(int x) {
    return x * 2;
}

int main()
{
    PeriodoTriasico();
    PeriodoJurasico());
}

Posible salida:

Periodo Triásico: hace [251.9 - 208.5] millones de años.
Periodo Jurásico: hace [201.3 - 152.1] millones de años.

main.cpp:20:5: warning: 'PeriodoTriasico' is deprecated [-Wdeprecated-declarations]
    PeriodoTriasico();
    ^
main.cpp:3:3: note: 'PeriodoJurasico' has been explicitly marked deprecated here
[[deprecated]]
  ^
main.cpp:21:5: warning: 'PeriodoJurasico' is deprecated: Use es su lugar PeriodoNeogeno() [-Wdeprecated-declarations]
    PeriodoJurasico();
    ^
main.cpp:8:3: note: 'PeriodoJurasico' has been explicitly marked deprecated here
[[deprecated("Use es su lugar PeriodoNeogeno()")]]
  ^
2 warnings generated.

Véase también

Documentación de C para deprecated