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) {
...
}