C++注解标签（attributes）

C++注解标签（attributes）#

早在C++98/03时代，不同的编译器用不同的注解伪代码添加一些额外的说明，比如#param, __declspec, __attribute。然而，不同的编译器可能对于同一个功能有不同的注解，这就需要我们为不同的编译器写不同的代码。
好在从C++11开始，我们有了统一制定的注解标签，极大的方便了编程。

enumeration和enumerator#

光看上面两个词就已经让人困惑了，从英语语法角度，是不是一个指物体，一个指人呢。。。举两个例子就很容易理解了

//enumeration的例子
enum Color {
    red,
    green,
    blue
};
int blue = 0xff; //编译不通过

这是因为一旦定义了枚举，在他的作用域内就不能定义同名的变量。
再来一个enumerator的例子：

enum class Color {
    red,
    green,
    blue
};
int blue = 0xff;//编译通过

此时枚举值blue与int变量blue不会冲突，如果想要引用枚举blue，需要用Color::blue的形式引用。

[[noreturn]]#

C++11引入了[[noreturn]]，该注解意思是告诉编译器，该函数没有返回值。比如

[[noreturn]] void func();

[[deprecated]]#

终于不用羡慕Java了，C++14引入了[[deprecated]]表示某个函数已经过时了，当使用这些过时的函数时，编译器会给出警告。

[[deprecated]]void func();

如果要给出提示信息，可以这样写：

[[deprecated("func is deprecated! use funcA instead")]]void func();

[[fallthrough]]#

C++17新加了[[fallthrough]]注解，用于switch-case语句，当某个case没有break时，有的编译器会给出警告。我们可以在这个case后面加上[[fallthrough]]表示我们是故意不加break的。

switch(type) {
case 1:
    ...
    //这里没加break，编译器可能会给警告
case 2:
    ...
    [[fallthrough]];
    //这里加了[[fallthrough]]，告诉编译器这么做是有意为之
case 3:
    ...    
}

[[nodiscard]]#

[[nodiscard]]用于修饰函数，告诉调用者一旦调用了这个函数，必须将返回值赋给一个变量，否则编译器给出警告。在C++20中，operator new() ，std::allocate等库函数都使用了[[nodiscard]]，强调必须是使用这些函数的返回值。

[[maybe_unused]]#

有时候我们使用某个函数时，其中某些变量并没有使用，这时候编译器会给出警告，为了消除警告，可以使用[[maybe_unused]]注释告诉编译器，这些变量可能会没被用到。

int func(int arg1, [[maybe_unused]] int arg2) {
    ...
}