Bir arabirimde, taşınabilir C ++ ile kullanımdan kaldırmak istediğim bir yöntemim var. Bunun için Google'da araştırdığımda sahip olduğum tek şey Microsoft'a özgü bir çözümdü; #pragma kullanımdan kaldırıldı ve __declspec (kullanımdan kaldırıldı) .
İkinci bir ödül çözüm, bir MSVC ve bir GCC çözümünün ifdefidir.
Teşekkürler
Yanıtlar:
C ++ 14'te, [[deprecated]]özniteliği kullanarak bir işlevi kullanımdan kaldırılmış olarak işaretleyebilirsiniz (bkz. Bölüm 7.6.5 [dcl.attr.deprecated]).
Nitelik belirteci
deprecatedişareti adları ve kimin kullanımı hala izin verilir kuruluşlar için kullanılabilir, ama nedense önerilmez.
Örneğin, aşağıdaki işlev fookullanımdan kaldırılmıştır:
[[deprecated]]
void foo(int);
Adın veya varlığın neden kullanımdan kaldırıldığını açıklayan bir mesaj sağlamak mümkündür:
[[deprecated("Replaced by bar, which has an improved interface")]]
void foo(int);
Mesaj bir dizge olmalıdır.
Daha fazla ayrıntı için bkz. "C ++ 14'te kullanımdan kaldırıldı olarak işaretleme" .
Bu hile yapmalı:
#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);
Bununla birlikte, bir işlev dönüş türünün adında virgül varsa sorunlarla karşılaşırsınız, örneğin std::pair<int, int>bu, önişleyici tarafından DEPRECATED makroya 2 bağımsız değişken geçirdiği şeklinde yorumlanacaktır. Bu durumda dönüş türünü yazmanız gerekir.
Düzenleme: daha basit (ancak muhtemelen daha az uyumlu) versiyon burada .
__declspec(deprecated)şimdiki ile aynı yerlerde olmasını sağlar , böylece makro basitleştirilebilir.
İşte 2008 cevabımın basitleştirilmiş bir versiyonu :
#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);
Ayrıca bakınız:
[[deprecate]]kaldırılan makrolarınız nasıl ? :-)
DEPRECATED void foo(...);yerineDEPRECATED(void foo(...));
GCC'de, işlevinizi kullanımdan kaldırılan özniteliğiyle şu şekilde bildirebilirsiniz:
void myfunc() __attribute__ ((deprecated));
Bu işlev bir .c dosyasında kullanıldığında bir derleme zamanı uyarısını tetikleyecektir.
Http://gcc.gnu.org/onlinedocs/gcc/Pragmas.html adresindeki "Teşhis pragmaları" altında daha fazla bilgi bulabilirsiniz.
İşte 2018 için daha eksiksiz bir cevap.
Bugünlerde pek çok araç, bir şeyi sadece kullanımdan kaldırıldı olarak işaretlemenize değil, aynı zamanda bir mesaj vermenize de izin veriyor. Bu, insanlara bir şeyin ne zaman kullanımdan kaldırıldığını söylemenize ve belki onları değiştirmeye yönlendirmenize olanak tanır.
Derleyici desteğinde hala çok fazla çeşitlilik var:
[[deprecated]]/ [[deprecated(message)]].__attribute__((deprecated)) GCC 4.0+ ve ARM 4.1+ tarafından desteklenmektedir__attribute__((deprecated))ve __attribute__((deprecated(message)))şunlar için desteklenir:
__GNUC__/ __GNUC_MINOR__/ ayarlayarak __GNUC_PATCHLEVEL__)__GNUC__/ __GNUC_MINOR__, sadece GCC'nin hangi sürümünün yüklü olduğunu ayarlarlar)__declspec(deprecated)beri desteklemektedir (Visual Studio 2003)__declspec(deprecated(message))beri desteklemektedir (Visual Studio 2005)Ayrıca [[gnu::deprecated]]clang'ın son sürümlerinde C ++ 11'de __has_cpp_attribute(gnu::deprecated).
Hedley'de tüm bunları otomatik olarak işlemek için güncel tuttuğum bazı makrolarım var , ancak mevcut sürüm (v2) şöyle görünüyor:
#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
Hedley'i kullanmak istemiyorsanız , *_VERSION_CHECKve *_HAS_ATTRIBUTEmakrolardan nasıl kurtulacağınızı anlamak için bir egzersiz olarak bırakacağım (büyük ölçüde Hedley'i yazdım, böylece bunu düzenli olarak düşünmek zorunda kalmayayım).
GLib kullanıyorsanız, G_DEPRECATEDve G_DEPRECATED_FORmakrolarını kullanabilirsiniz . Hedley'den olanlar kadar sağlam değiller, ancak GLib'i zaten kullanıyorsanız ekleyecek hiçbir şey yok.
Taşınabilir projelerle uğraşmak, bir noktada çeşitli platformlar için önceden işlenmiş alternatifler bölümüne ihtiyaç duymanız neredeyse kaçınılmazdır. #ifdef bu #ifdef şunun gibi.
Böyle bir bölümde sembolleri kullanımdan kaldırmanın bir yolunu koşullu olarak çok iyi tanımlayabilirsiniz. Çoğu araç zinciri özel derleyici uyarılarını desteklediğinden, tercihim genellikle bir "uyarı" makrosu tanımlamaktır. Daha sonra, kullanımdan kaldırma vb. İçin belirli bir uyarı makrosuyla devam edebilirsiniz. Tahsis edilmiş kullanımdan kaldırma yöntemlerini destekleyen platformlar için, uyarılar yerine bunu kullanabilirsiniz.
Intel Compiler v19.0 için şunu __INTEL_COMPILERdeğerlendirirken bunu kullanın 1900:
# if defined(__INTEL_COMPILER)
# define DEPRECATED [[deprecated]]
# endif
Aşağıdaki dil seviyeleri için çalışır:
Intel Derleyici, [[deprecated]]diğer tüm derleyicilerin yaptığı belirli dil öğelerinin özniteliğini desteklememesi nedeniyle bir hata gibi görünen bir şeye sahiptir . Bir örnek için, GitHub'da (son derece süper) {fmtlib / fmt} kitaplığının v6.0.0'ını Intel Compiler v19.0 ile derleyin. Kırılacak. Ardından GitHub kaydındaki düzeltmeye bakın .