__attribute__((deprecated))

Specifies that the compiler must issue a warning when a program refers to an object.

Syntax

  variable-declaration  __attribute__((deprecated));

  variable-definition  __attribute__((deprecated));

  function-declaration  __attribute__((deprecated));

  function-definition  __attribute__((deprecated));

Remarks

This attribute instructs the compiler to issue a warning when a program refers to a function or variable. Use this attribute to discourage programmers from using functions and variables that are obsolete or will soon be obsolete.

Listing 1. Example of deprecated attribute

int velocipede(int speed) __attribute__((deprecated));
int bicycle(int speed);

int f(int speed)
{
  return velocipede(speed); /* Warning. */
}

int g(int speed)
{
  return bicycle(speed * 2); /* OK */
}