C++23新特性_#warning 预处理指令

文章目录

• [第一章 C++23语言特性](#第一章 C++23语言特性)
• • [1.4 #warning 预处理指令](#warning 预处理指令)
  • • [1.4.1 作用和语法格式](#1.4.1 作用和语法格式)
    • [1.4.2 #error 与 #warning 和 \[deprecated]对比](#error 与 #warning 和 [[deprecated]]对比)
    • [1.4.3 使用示例](#1.4.3 使用示例)

本文介绍C++23新特性之#warning 预处理指令。

第一章 C++23语言特性

1.4 #warning 预处理指令

在C++23之前，几乎所有的主流编译器(GCC, Clang, MSVC)都支持#warning指令，用来在编译期间发出自定义警告。

C++ 23 将这一广泛存在的扩展纳入标准，无论使用什么编译器, 都可以使用#warning。

1.4.1 作用和语法格式

语法格式如下：

#warning "Message text"
// 或者不带引号（取决于具体实现，但标准推荐文本形式）
#warning Message text 

作用：当预处理器遇到这行指令时，会向控制台（或输出窗口）打印指定的文本，并将其标记为"警告"（Warning），不会像 #error 那样中断编译。

1.4.2 #error 与 #warning 和 \[deprecated]对比

与#error区别：它们都是在广义的编译期间进行的

#error：致命错误。编译立即停止。用于"如果不解决这个问题，程序绝对无法运行"的场景。

#warning：提示信息。编译继续。用于"这里有个问题你需要注意，但暂时不影响程序构建"的场景。

\[deprecated] 表示这是一个过时的函数，类，变量，在编译期间触发警告。

1.4.3 使用示例

示例1：标记"尚未完成的功能"

    void complex_algorithm() {
#ifdef _DEBUG
        // 开发阶段提醒自己，这个算法还没优化
#warning "Performance: This algorithm is O(n^3), needs optimization before release!"
#endif

    // 未优化的代码
    }

    void test()
    {
        complex_algorithm();
	}

编译输出： warning: Performance: This algorithm is O(n^3), needs optimization before release!

示例2：检验配置或环境风险

检测某些不推荐的设配时，可以使用#warnning提醒。

// 检查是否开启了某些实验性特性
#if defined(ENABLE_EXPERIMENTAL_FEATURES)
    #warning "Experimental features are enabled. API stability is not guaranteed."
#endif

示例3：头文件的移除提醒

假如想告诉使用者某个头文件即将被移除，但又不想破坏它们的建构(使用#error)，也不想等它们调用函数时才发现，可以在头文件顶部写一个警告。

// old_header.h
#ifndef OLD_HEADER_H
#define OLD_HEADER_H

// 只要用户 #include 这个文件，就会看到警告
#warning "这个文件即将被移除，请使用新文件 <new_header.h>"

#include "new_header.h"

#endif