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

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

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

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

int
fn (void)
{
  return oldval;
}

deprecated

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

unavailable

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