У мене є метод в інтерфейсі, який я хочу застаріти за допомогою портативного C ++. Коли я погукався за це, все, що було, було специфічним для Microsoft рішенням; #pragma застарілий і __declspec (застарілий) .
Другим призовим рішенням було б вирішити MSVC та рішення GCC.
Дякую
Відповіді:
У C ++ 14 ви можете позначити функцію як застарілу за допомогою [[deprecated]]атрибута (див. Розділ 7.6.5 [dcl.attr.deprecated]).
Атрибут-маркер
deprecatedможна використовувати для імен міток і юридичних осіб, використання яких по- , як і раніше допускається, але не рекомендується для якої - то причини.
Наприклад, ця функція fooзастаріла:
[[deprecated]]
void foo(int);Можна надати повідомлення, яке описує, чому назву чи сутність застаріли:
[[deprecated("Replaced by bar, which has an improved interface")]]
void foo(int);Повідомлення повинно бути літеральним рядком.
Детальнішу інформацію див. У розділі "Позначення як застаріле в C ++ 14" .
Для цього слід зробити фокус:
#ifdef __GNUC__
#define DEPRECATED(func) func __attribute__ ((deprecated))
#elif defined(_MSC_VER)
#define DEPRECATED(func) __declspec(deprecated) func
#else
#pragma message("WARNING: You need to implement DEPRECATED for this compiler")
#define DEPRECATED(func) func
#endif
...
//don't use me any more
DEPRECATED(void OldFunc(int a, float b));
//use me instead
void NewFunc(int a, double b);Однак у вас виникнуть проблеми, якщо тип повернення функції має коми у своєму імені, наприклад, std::pair<int, int>тому що препроцесор інтерпретується як передача 2-х аргументів на ЗАМЕЧАНИЙ макрос. У такому випадку вам доведеться ввести тип повернення.
Edit: простий (але , можливо , менш широко сумісний) версія тут .
__declspec(deprecated)зараз, тому макрос можна спростити.
Ось спрощена версія моєї відповіді 2008 року :
#if defined(__GNUC__) || defined(__clang__)
#define DEPRECATED __attribute__((deprecated))
#elif defined(_MSC_VER)
#define DEPRECATED __declspec(deprecated)
#else
#pragma message("WARNING: You need to implement DEPRECATED for this compiler")
#define DEPRECATED
#endif
//...
//don't use me any more
DEPRECATED void OldFunc(int a, float b);
//use me instead
void NewFunc(int a, double b);Дивитися також:
[[deprecate]]застарілі макроси? :-)
DEPRECATED void foo(...);замістьDEPRECATED(void foo(...));
У GCC ви можете оголосити свою функцію з атрибутом, який застарів так:
void myfunc() __attribute__ ((deprecated));Це призведе до попередження часу компіляції, коли ця функція використовується у файлі .c.
Додаткову інформацію можна знайти в розділі "Діагностичні прагми" на веб- сайті http://gcc.gnu.org/onlinedocs/gcc/Pragmas.html
Ось більш повна відповідь на 2018 рік.
У наші дні дуже багато інструментів дозволяють не просто позначати щось як застаріле, але й надавати повідомлення. Це дозволяє вам повідомити людям, коли щось застаріло, і, можливо, вказати на заміну.
У підтримці компілятора все ще багато:
[[deprecated]]/ [[deprecated(message)]].__attribute__((deprecated)) підтримується GCC 4.0+ та ARM 4.1+__attribute__((deprecated))і __attribute__((deprecated(message)))підтримується для:
__GNUC__/ __GNUC_MINOR__/ __GNUC_PATCHLEVEL__)__GNUC__/ __GNUC_MINOR__вони просто встановлюють його до будь-якої версії GCC встановлена)__declspec(deprecated)з 13.10 (Visual Studio 2003)__declspec(deprecated(message))з 14.0 (Visual Studio 2005)Ви також можете використовувати [[gnu::deprecated]]в останніх версіях clang в C ++ 11 на основі __has_cpp_attribute(gnu::deprecated).
У Хедлі у мене є кілька макросів, які автоматично обробляють все це, що я постійно оновлюю, але поточна версія (v2) виглядає приблизно так:
#if defined(__cplusplus) && (__cplusplus >= 201402L)
# define HEDLEY_DEPRECATED(since) [[deprecated("Since " #since)]]
# define HEDLEY_DEPRECATED_FOR(since, replacement) [[deprecated("Since " #since "; use " #replacement)]]
#elif \
HEDLEY_GCC_HAS_EXTENSION(attribute_deprecated_with_message,4,5,0) || \
HEDLEY_INTEL_VERSION_CHECK(16,0,0) || \
HEDLEY_ARM_VERSION_CHECK(5,6,0)
# define HEDLEY_DEPRECATED(since) __attribute__((__deprecated__("Since " #since)))
# define HEDLEY_DEPRECATED_FOR(since, replacement) __attribute__((__deprecated__("Since " #since "; use " #replacement)))
#elif \
HEDLEY_GCC_HAS_ATTRIBUTE(deprcated,4,0,0) || \
HEDLEY_ARM_VERSION_CHECK(4,1,0)
# define HEDLEY_DEPRECATED(since) __attribute__((__deprecated__))
# define HEDLEY_DEPRECATED_FOR(since, replacement) __attribute__((__deprecated__))
#elif HEDLEY_MSVC_VERSION_CHECK(14,0,0)
# define HEDLEY_DEPRECATED(since) __declspec(deprecated("Since " # since))
# define HEDLEY_DEPRECATED_FOR(since, replacement) __declspec(deprecated("Since " #since "; use " #replacement))
#elif HEDLEY_MSVC_VERSION_CHECK(13,10,0)
# define HEDLEY_DEPRECATED(since) _declspec(deprecated)
# define HEDLEY_DEPRECATED_FOR(since, replacement) __declspec(deprecated)
#else
# define HEDLEY_DEPRECATED(since)
# define HEDLEY_DEPRECATED_FOR(since, replacement)
#endifЯ залишу це як вправу, щоб зрозуміти, як позбутися макросів *_VERSION_CHECKі, *_HAS_ATTRIBUTEякщо ви не хочете користуватися Хедлі (я писав Хедлі в основному, тому мені не доведеться думати про це регулярно).
Якщо ви використовуєте GLib, ви можете використовувати макроси G_DEPRECATEDта G_DEPRECATED_FOR. Вони не такі надійні, як у Hedley, але якщо ви вже використовуєте GLib, нічого додати.
Для роботи з портативними проектами майже неминуче, що вам в якийсь момент потрібен розділ попередньо оброблених альтернатив для різних платформ. #ifdef це #ifdef це тощо.
У такому розділі ви могли б дуже умовно визначити спосіб знецінення символів. Як правило, я вважаю, щоб визначити макрос "попередження", оскільки більшість ланцюжків інструментів підтримують застереження компілятора. Тоді ви можете продовжувати використання конкретного макросу попередження про депрекацію тощо. Для платформ, що підтримують спеціальні методи депрекації, ви можете використовувати це замість попереджень.
Для Intel Compiler v19.0 використовуйте це як __INTEL_COMPILERоцінку для 1900:
# if defined(__INTEL_COMPILER)
# define DEPRECATED [[deprecated]]
# endifПрацює на наступних мовних рівнях:
У Intel Compiler є помилка, яка не підтримує [[deprecated]]атрибут певних мовних елементів, які роблять усі інші компілятори. Наприклад, компілюйте v6.0.0 (помітно чудовий) {fmtlib / fmt} бібліотеки на GitHub з Intel Compiler v19.0. Це зламається. Потім перегляньте виправлення в GitHub .