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

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

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

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

int
fn (void)
{
  return oldval;
}

deprecated

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

unavailable

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