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)

 

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