C attribute: deprecated (since C23)

Indica que el nombre o entidad declarado con este atributo está obsoleto , es decir, su uso está permitido, pero se desaconseja por alguna razón.

Sintaxis

Explicación

Indica que el uso del nombre o entidad declarado con este atributo está permitido, pero se desaconseja por algún motivo. Los compiladores normalmente emiten advertencias sobre dichos usos. El string-literal , si se especifica, normalmente se incluye en las advertencias.

Este atributo está permitido en declaraciones de los siguientes nombres o entidades:

• struct / union : struct [ [ deprecated ] ] S ; ,
• typedef-name : [ [ deprecated ] ] typedef S * PS ; ,
• objetos: [ [ deprecated ] ] int x ; ,
• miembro de struct/union: union U { [ [ deprecated ] ] int n ; } ; ,
• función : [ [ deprecated ] ] void f ( void ) ; ,
• enumeración : enum [ [ deprecated ] ] E { } ; ,
• enumerador: enum { A [ [ deprecated ] ] , B [ [ deprecated ] ] = 42 } ; .

Un nombre declarado no obsoleto puede ser redeclarado como obsoleto. Un nombre declarado obsoleto no puede dejar de ser obsoleto redeclarándolo sin este atributo.

Ejemplo

#include <stdio.h>
[[deprecated]]
void TriassicPeriod(void)
{
    puts("Triassic Period: [251.9 - 208.5] million years ago.");
}
[[deprecated("Use NeogenePeriod() instead.")]]
void JurassicPeriod(void)
{
    puts("Jurassic Period: [201.3 - 152.1] million years ago.");
}
[[deprecated("Use calcSomethingDifferently(int).")]]
int calcSomething(int x)
{
    return x * 2;
}
int main(void)
{
    TriassicPeriod();
    JurassicPeriod();
}

Triassic Period: [251.9 - 208.5] million years ago.
Jurassic Period: [201.3 - 152.1] million years ago.
prog.c:23:5: warning: 'TriassicPeriod' is deprecated [-Wdeprecated-declarations]
    TriassicPeriod();
    ^
prog.c:3:3: note: 'TriassicPeriod' has been explicitly marked deprecated here
[[deprecated]]
  ^
prog.c:24:5: warning: 'JurassicPeriod' is deprecated: Use NeogenePeriod() instead. [-Wdeprecated-declarations]
    JurassicPeriod();
    ^
prog.c:9:3: note: 'JurassicPeriod' has been explicitly marked deprecated here
[[deprecated("Use NeogenePeriod() instead.")]]
  ^
2 warnings generated.

Véase también