Namespaces
Variants

C attribute: deprecated (since C23)

From cppreference.net
C
C language
Declarations
Attributes
deprecated
(C23)
(C23)
(C23)
(C23)
(C23) (C23) (deprecated)
(C23)
(C23)

이 속성으로 선언된 이름 또는 엔티티가 deprecated 되었음을 나타냅니다. 즉, 사용은 허용되지만 어떤 이유로 권장되지 않음을 의미합니다.

목차

구문

[[ deprecated ]]
[[ __deprecated__ ]] 		(1)
[[ deprecated ( string-literal ) ]]
[[ __deprecated__ ( string-literal ) ]] 		(2)
string-literal - 폐지의 근거를 설명하거나 대체 개체를 제안하는 데 사용될 수 있는 텍스트

설명

이 속성으로 선언된 이름이나 개체의 사용이 허용되지만 어떤 이유로 권장되지 않음을 나타냅니다. 컴파일러는 일반적으로 이러한 사용에 대해 경고를 발생시킵니다. string-literal 이 지정된 경우, 일반적으로 경고 메시지에 포함됩니다.

이 속성은 다음 이름 또는 엔티티의 선언에서 허용됩니다:

  • 구조체 / 공용체 : struct [ [ deprecated ] ] S ; ,
  • typedef-이름 : [ [ deprecated ] ] typedef S * PS ; ,
  • 객체: [ [ deprecated ] ] int x ; ,
  • 구조체/공용체 멤버: union U { [ [ deprecated ] ] int n ; } ; ,
  • 함수 : [ [ deprecated ] ] void f ( void ) ; ,
  • 열거형 : enum [ [ deprecated ] ] E { } ; ,
  • 열거자: enum { A [ [ deprecated ] ] , B [ [ deprecated ] ] = 42 } ; .

비사용 권고로 선언되지 않은 이름은 나중에 비사용 권고로 재선언될 수 있습니다. 비사용 권고로 선언된 이름은 이 속성 없이 재선언하더라도 비사용 권고 상태가 해제되지 않습니다.

예제

이 코드 실행 
#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.

참고 항목

C++ 문서 for deprecated