6.4.5 Атрибуты перечислителей

GCC позволяет задавать атрибуты для перечислителей. Подробное описание точного синтаксиса атрибутов см. в разделе Синтаксис атрибутов. Другие атрибуты доступны для функций (см. Объявление атрибутов функций), переменных (см. Задание атрибутов переменных), меток (см. Атрибуты меток), операторов (см. Атрибуты операторов) и типов (см. Задание атрибутов типов).

В этом примере атрибут перечислителя deprecated указывает, что перечислитель oldval устарел:

enum E {
  oldval __attribute__((deprecated)),
  newval
};

int
fn (void)
{
  return oldval;
}

deprecated

Атрибут deprecated вызывает предупреждение, если перечислитель используется в исходном файле. Это полезно при выявлении перечислителей, которые планируется удалить в будущей версии программы. Предупреждение также содержит местоположение объявления устаревшего перечислителя, чтобы пользователи могли легко найти дополнительную информацию о том, почему перечислитель устарел и что следует использовать вместо него. Обратите внимание, что предупреждения возникают только при использовании перечислителя.

unavailable

Атрибут unavailable вызывает ошибку, если перечислитель используется в исходном файле. В остальном он работает так же, как атрибут deprecated.