// ?? 危險(xiǎn)操作：直接刪除舊接口
class DataProcessor {
public:
    void process_v2();  // ? 新接口
    // void process_v1(); ?? 直接刪除導(dǎo)致現(xiàn)有用戶崩潰
};

[[deprecated("v2.3 起廢棄，將在 v3.0 移除")]] 
   void legacy_api();  // ?? 給用戶升級時(shí)間軸

// ? 安全做法：保持符號表不變
   [[deprecated]] void draw(int x, int y);  // ?? 保持參數(shù)列表不變

/* 版本歷史：
   * v1.0 - 實(shí)現(xiàn)基礎(chǔ)功能
   * v2.0 - 標(biāo)記廢棄 ??
   * v3.0 - 物理刪除 ??
   */

[[deprecated("改用 process_data() 并傳遞 Config 參數(shù)")]]
   void process() {  // ??? 明確遷移指南
       process_data(Config::default()); 
   }

// ?? 看看這些傳統(tǒng)做法多么混亂...
#if defined(__GNUC__)
#define DEPRECATED __attribute__((deprecated))
#elif defined(_MSC_VER)
#define DEPRECATED __declspec(deprecated)
#else
#define DEPRECATED // ?? 其他編譯器只能干瞪眼！
#endif

DEPRECATED void oldFunction(); // 可憐的跨平臺兼容性

// ?? 看看C++14的魔法！簡單明了！
[[deprecated("請使用newFunction()代替")]] 
void oldFunction() {  // ? 標(biāo)準(zhǔn)化屬性，跨平臺兼容！
    // 函數(shù)實(shí)現(xiàn)
}

oldFunction();  // ?? 編譯器警告：警告：'oldFunction'已被廢棄：請使用newFunction()代替

// ? 舊API - 已不推薦使用
[[deprecated("V2.0起不推薦使用，將在V3.0移除。請使用calculate()替代")]]
double calc(double x, double y) {
    return calculate(x, y);  // 內(nèi)部轉(zhuǎn)發(fā)到新API
}

// ?? 新API - 推薦使用
double calculate(double x, double y) {
    return x * y + std::sqrt(x + y);  // 具體實(shí)現(xiàn)
}

class ModernEngine {
public:
    // ?? 舊方法 - 標(biāo)記為廢棄
    [[deprecated("性能問題，請使用optimizedProcess()")]]
    void process(const Data& data) {
        // 為保證兼容性，調(diào)用新方法
        optimizedProcess(data);
    }
    
    // ? 新方法 - 推薦使用
    void optimizedProcess(const Data& data) {
        // 優(yōu)化的實(shí)現(xiàn)
    }
    
private:
    // ?? 內(nèi)部廢棄成員變量
    [[deprecated]] 
    int m_oldCounter = 0;  // 將在下一版本移除
};

// ?? 即將退休的老類型
[[deprecated("請使用ModernConfig替代，更高效且線程安全")]]
struct LegacyConfig {
    std::string name;
    int value;
};

// ?? 新一代類型
class ModernConfig {
public:
    ModernConfig(std::string n, int v) : name(std::move(n)), value(v) {}
    
    std::string getName() const { return name; }
    int getValue() const { return value; }
    
private:
    std::string name;
    int value;
    std::mutex mtx;  // 線程安全支持
};

// ? 安全版本 - 首選API
void processData(const std::string& data) {
    // 安全實(shí)現(xiàn)
}

// ?? 危險(xiǎn)版本 - 已廢棄
[[deprecated("使用std::string版本代替，避免緩沖區(qū)溢出風(fēng)險(xiǎn)")]]
void processData(const char* data) {
    // 轉(zhuǎn)發(fā)到安全版本
    processData(std::string(data));
}

processData("直接字符串");  // ?? 警告：使用廢棄的重載版本
std::string safe_str = "安全字符串";
processData(safe_str);     // ? 無警告，使用推薦的API

namespace v1 {
    // ?? 舊版命名空間中的API標(biāo)記為廢棄
    [[deprecated("請遷移到v2::Config，支持并發(fā)訪問")]]
    class Config {
    public:
        bool load(const std::string& filename);
        int getValue(const std::string& key);
    };
}

namespace v2 {
    // ??? 新版命名空間中的改進(jìn)API
    class Config {
    public:
        bool load(const std::string& filename);
        int getValue(const std::string& key);
        // 新增功能
        bool setValueThreadSafe(const std::string& key, int value);
    };
}

// ?? 功能開關(guān)標(biāo)志 - 廢棄舊特性
struct FeatureFlags {
    // ?? 標(biāo)記廢棄的功能開關(guān)
    [[deprecated("V3.0將移除此渲染模式，請使用enableModernRenderer()")]]
    static void enableLegacyRenderer() {
        // 內(nèi)部可能仍調(diào)用舊實(shí)現(xiàn)或轉(zhuǎn)發(fā)到新實(shí)現(xiàn)
    }
    
    // ? 推薦使用的新API
    static void enableModernRenderer() {
        // 新的實(shí)現(xiàn)
    }
};

enum class RenderMode {
    Modern = 0,  // ? 推薦使用
    
    [[deprecated("即將移除，請使用Modern代替")]]
    Legacy = 1,  // ?? 即將淘汰
    
    Experimental = 2  // ?? 實(shí)驗(yàn)性功能
};

void setRenderMode(RenderMode mode) {
    // 函數(shù)實(shí)現(xiàn)...
}

// 版本常量定義
constexprint CURRENT_VERSION = 402; // 表示4.2版本
constexprint DEPRECATED_IN_VERSION = 400; // 4.0開始廢棄
constexprint REMOVE_IN_VERSION = 500; // 5.0將移除

// 版本化的廢棄宏
#define DEPRECATED_SINCE(ver, msg) \
    [[deprecated("自" #ver "版本起廢棄: " msg)]]

// 條件性廢棄 - 根據(jù)當(dāng)前版本自動(dòng)應(yīng)用
#if CURRENT_VERSION >= DEPRECATED_IN_VERSION
    #define VERSION_DEPRECATED(msg) DEPRECATED_SINCE(4.0, msg)
#else
    #define VERSION_DEPRECATED(msg)
#endif

// 根據(jù)版本條件決定是否廢棄
VERSION_DEPRECATED("請使用newFunction()替代")
void oldFunction() {
    // 實(shí)現(xiàn)...
}

// 特定平臺廢棄 - 只在Windows平臺標(biāo)記廢棄
#ifdef _WIN32
[[deprecated("Windows平臺已不支持此API，請使用WinAPI原生函數(shù)")]]
#endif
void platformSpecificFunction() {
    // 平臺相關(guān)實(shí)現(xiàn)...
}

# 控制廢棄警告級別
-Wdeprecated-declarations  # 啟用廢棄警告（默認(rèn)開啟）
-Wno-deprecated-declarations  # 禁用廢棄警告
-Werror=deprecated-declarations  # 將廢棄警告視為錯(cuò)誤

# 控制廢棄警告級別
/w14996  # 啟用廢棄警告
/wd4996  # 禁用廢棄警告  
/we4996  # 將廢棄警告視為錯(cuò)誤