查看“︁cpp/language/attributes”︁的源代码

因为以下原因，您没有权限编辑该页面：

您请求的操作仅限属于这些用户组的用户执行：用户、管理员

您可以查看和复制此页面的源代码。

{{title|属性说明符序列 {{mark since c++11}}}}
{{cpp/language/attributes/navbar}}

为类型、对象、代码等引入由实现定义的属性。

===语法===
{{sdsc begin}}
{{sdsc|notes={{mark since c++11}}|1=
{{ttb|[<!---->[}} {{spar|属性列表}} {{ttb|]<!---->]}}
}}
{{sdsc|notes={{mark since c++17}}|1=
{{ttb|[<!---->[}} {{ttb|using}} {{spar|属性命名空间}} {{ttb|:}} {{spar|属性列表}} {{ttb|]<!---->]}}
}}
{{sdsc end}}
其中{{spar sep|属性列表}}是由逗号分隔的零或更多个{{spar sep|属性}}的序列（可以以指示{{rlp|parameter pack|包展开}}的省略号 {{ttb|...}} 结束） 
{{sdsc begin}}
{{sdsc|{{spar|标识符}}}}
{{sdsc|{{spar|属性命名空间}} {{ttb|::}} {{spar|标识符}}}}
{{sdsc|{{spar|标识符}} {{ttb|(}} {{spar optional|实参列表}} {{ttb|)}}}}
{{sdsc|{{spar|属性命名空间}} {{ttb|::}} {{spar|标识符}} {{ttb|(}} {{spar optional|实参列表}} {{ttb|)}}}}
{{sdsc end}}
其中{{spar|属性命名空间}}为一个{{spar|标识符}}，而{{spar|实参列表}}为其中圆括号、方括号和花括号平衡出现的记号序列（{{spar|平衡记号序列}}）。
@1@ 简单属性，例如 {{c|[[noreturn]]}}。
@2@ 有命名空间的属性，例如 {{c|[[gnu::unused]]}}。
@3@ 有实参的属性，例如 {{c|[[deprecated("原因")]]}}。
@4@ 既有命名空间又有实参列表的属性。

{{rrev|since=c++17|
如果 {{tt|using namespace:}} 出现在属性列表开头，那么属性列表中的其他属性均无法指定命名空间：由 using 所指定的命名空间会应用到所有这些属性：
{{source|1=
[[using CC: opt(1), debug]] // 同 [[CC::opt(1), CC::debug]]
[[using CC: CC::opt(1)]] // 错误：不能结合 using 和有作用域属性
}}
}}

{{rrev|since=c++26|
如果属性说明符中的每一项都以 {{tt|{{=}}}} 开头，则该属性说明符转而引入{{rlp|annotations|标注}}。属性（不以 {{tt|{{=}}}} 开头）和标注（以 {{tt|{{=}}}} 开头）不能在同一个属性说明符中混用。
}}

===解释===
属性为各种由实现定义的语言扩展（例如 GNU 与 IBM 的语言扩展 {{tt|__attribute__((...))}}，微软的语言扩展 {{tt|__declspec()}} 等）提供了统一的语法。

属性可用在 C++ 程序中的几乎所有位置，而且可应用于几乎所有事物：类型、变量、函数、名字、代码块、整个翻译单元，不过每个特定的属性都只在实现允许范围内有效：{{attr/core|expect_true}} 可能是只能与 {{c/core|if}}，而非与类声明一同使用的属性，{{attr/core|omp::parallel()}} 可能是应用到代码块或 {{c/core|for}} 循环，而非到类型 {{c/core|int}} 等的属性。（请注意以上两个属性只是虚构的例子，有关标准与一些非标准属性请见下文。）

在声明中，属性既可以在整个声明之前出现，也可以直接跟在被声明实体的名字之后，这些情况下它们被组合起来。大多数其他情形中，属性应用于直接位于其之前的实体。

虽然 {{rlp|alignas|{{c/core|alignas}} 说明符}}拥有不同的语法，但它是属性序列说明符的一部分。它可以在 {{tt|[<nowiki/>[...]]}} 属性出现的地方出现，并可以和它们混合（假设此处允许使用 {{c/core|alignas}}）。

两个连续的方括号记号（{{tt|[<!---->[}}）只能出现于引入属性说明符之处，或在属性实参之内。

{{source|1=
void f()
{
    int y[3];
    y[<!---->[] { return 0; }()] = 1; // 错误
    int i [[cats::meow([[]])]]; // OK
}
}}

除了以下所列出的标准属性之外，实现还可能支持拥有由实现定义的行为的任意非标准属性。{{rev inl|since=c++17|所有实现所未知的属性均被忽略，且不产生错误。}}

{{rrev|since=c++20|
无{{spar sep|属性命名空间}}的属性与名字以 {{tt|std}} 或 {{tt|std}} 后随一或多个数字的{{spar sep|属性命名空间}}为未来标准化保留。即每个非标准属性都在实现提供的 {{spar|属性命名空间}} 中，例如 {{attr/core|gnu::may_alias}}、{{attr/core|clang::trivial_abi}} 和 {{attr/core|msvc::noop_dtor}}。
}}

===标准属性===
C++ 标准定义了下列属性。

标准属性不能在语法上被忽略：它们不能包含语法错误，必须应用到正确的目标，并且实参中的实体都会被 {{rlps|definition#ODR 使用}}。

标准属性也不能在语义上被忽略：程序在去掉某个标准属性的所有实例的情况下的行为必须是该程序在保留该属性的情况下遵守标准要求的行为。

{{dsc begin}}
{{dsc inc|cpp/language/attributes/dsc noreturn}}
{{dsc inc|cpp/language/attributes/dsc carries_dependency}}
{{dsc inc|cpp/language/attributes/dsc deprecated}}
{{dsc inc|cpp/language/attributes/dsc fallthrough}}
{{dsc inc|cpp/language/attributes/dsc maybe_unused}}
{{dsc inc|cpp/language/attributes/dsc nodiscard}}
{{dsc inc|cpp/language/attributes/dsc likely}}
{{dsc inc|cpp/language/attributes/dsc no_unique_address}}
{{dsc inc|cpp/language/attributes/dsc assume}}
{{dsc inc|cpp/language/attributes/dsc indeterminate}}
{{dsc inc|cpp/language/attributes/dsc optimize_for_synchronized}}
{{dsc end}}

===注解===
预处理宏 [[cpp/feature test#属性|{{tt|__has_cpp_attribute}}]] 可以检查平台是否实现某个单独属性。
{{ftm begin|core=yes|sort=yes}}
{{ftm|std=C++11|value=200809L|__cpp_attributes|属性}}
{{ftm|std=C++17|value=201411L|__cpp_namespace_attributes|可将属性应用到{{rlp|namespace|命名空间}}}}
{{ftm end}}

===示例===
{{example
|code=
[[gnu::always_inline]] [[gnu::hot]] [[gnu::const]] [[nodiscard]]
inline int f(); // 声明 f 带四个属性

[[gnu::always_inline, gnu::const, gnu::hot, nodiscard]]
int f(); // 同上，但使用含有四个属性的单个属性说明符

// C++17:
[[using gnu : const, always_inline, hot]] [[nodiscard]]
int f[[gnu::always_inline]](); // 属性可出现于多个说明符中

int f() { return 0; }

int main() {}
}}

===缺陷报告===
{{dr list begin}}
{{dr list item|wg=cwg|dr=2079|std=C++11|before={{tt|[<!---->[}} 不能在属性实参之内出现|after=可以出现}}
{{dr list item|wg=cwg|dr=2538|std=C++11|before=不明确标准属性是否能在语法上被忽略|after=禁止忽略}}
{{dr list item|wg=cwg|dr=2695|std=C++11|before=不明确标准属性是否能在语义上被忽略|after=禁止忽略}}
{{dr list item|paper=P2156R1|std=C++11|before=每个标准属性在一个{{spar sep|属性列表}}中最多只能出现一次|after=不限制次数}}
{{dr list end}}

===参阅===
{{dsc begin}}
{{dsc|[[cpp/feature test#属性|{{ttb|__has_cpp_attribute}}]] - 检查某个属性是否存在}}
{{dsc see c|c/language/attributes|属性说明符序列|nomono=true}}
{{dsc end}}

===外部链接===
{{elink begin}}
{{elink|1=[https://gcc.gnu.org/onlinedocs/gcc/Attribute-Syntax.html#Attribute-Syntax GCC 中的属性]。这些属性可用作 {{attr/core|gnu::...}}，见 [https://stackoverflow.com/questions/54639524/which-gnu-attributes-have-c11-syntax#comment96071307_54639524 SO 帖子]。}}
{{elink|1=[https://clang.llvm.org/docs/AttributeReference.html Clang 中的属性]。}}
{{elink|1=[https://learn.microsoft.com/en-us/cpp/cpp/attributes#microsoft-specific-attributes MSVC 中的属性]。}}
{{elink end}}

{{langlinks|de|en|es|fr|it|ja|pt|ru}}

该页面使用的模板：

Template:!!（查看源代码）
Template:attr（查看源代码）
Template:attr/core（查看源代码）
Template:c（查看源代码）
Template:c/core（查看源代码）
Template:cpp/language/attributes/dsc assume（查看源代码）
Template:cpp/language/attributes/dsc carries dependency（查看源代码）
Template:cpp/language/attributes/dsc deprecated（查看源代码）
Template:cpp/language/attributes/dsc fallthrough（查看源代码）
Template:cpp/language/attributes/dsc indeterminate（查看源代码）
Template:cpp/language/attributes/dsc likely（查看源代码）
Template:cpp/language/attributes/dsc maybe unused（查看源代码）
Template:cpp/language/attributes/dsc no unique address（查看源代码）
Template:cpp/language/attributes/dsc nodiscard（查看源代码）
Template:cpp/language/attributes/dsc noreturn（查看源代码）
Template:cpp/language/attributes/dsc optimize for synchronized（查看源代码）
Template:cpp/language/attributes/navbar（查看源代码）
Template:cpp/language/attributes/navbar content（查看源代码）
Template:cpp/language/attributes/navbar heading（查看源代码）
Template:cpp/language/declarations/navbar content（查看源代码）
Template:cpp/language/declarations/navbar heading（查看源代码）
Template:cpp/language/navbar content（查看源代码）
Template:cpp/language/navbar heading（查看源代码）
Template:cpp/navbar content（查看源代码）
Template:cpp/navbar heading（查看源代码）
Template:dr list begin（查看源代码）
Template:dr list end（查看源代码）
Template:dr list item（查看源代码）
Template:dsc（查看源代码）
Template:dsc attr（查看源代码）
Template:dsc begin（查看源代码）
Template:dsc editlink（查看源代码）
Template:dsc end（查看源代码）
Template:dsc guard（查看源代码）
Template:dsc inc（查看源代码）
Template:dsc member（查看源代码）
Template:dsc see c（查看源代码）
Template:elink（查看源代码）
Template:elink begin（查看源代码）
Template:elink end（查看源代码）
Template:example（查看源代码）
Template:ftm（查看源代码）
Template:ftm begin（查看源代码）
Template:ftm end（查看源代码）
Template:ftm link（查看源代码）
Template:get lang（查看源代码）
Template:get lang formal（查看源代码）
Template:i（查看源代码）
Template:inc（查看源代码）
Template:langlinks（查看源代码）
Template:langlinks/one（查看源代码）
Template:lc（查看源代码）
Template:lines（查看源代码）
Template:list guard（查看源代码）
Template:ls（查看源代码）
Template:ltt（查看源代码）
Template:ltt/core（查看源代码）
Template:mark（查看源代码）
Template:mark attribute（查看源代码）
Template:mark c++11（查看源代码）
Template:mark c++14（查看源代码）
Template:mark c++17（查看源代码）
Template:mark c++20（查看源代码）
Template:mark c++23（查看源代码）
Template:mark c++26（查看源代码）
Template:mark life（查看源代码）
Template:mark optional（查看源代码）
Template:mark rev（查看源代码）
Template:mark since c++11（查看源代码）
Template:mark since c++17（查看源代码）
Template:mark since c++20（查看源代码）
Template:mark since c++26（查看源代码）
Template:mark since tm ts（查看源代码）
Template:mark tooltip（查看源代码）
Template:mark until c++26（查看源代码）
Template:navbar（查看源代码）
Template:navbar editlink（查看源代码）
Template:nbsp（查看源代码）
Template:nv（查看源代码）
Template:nv begin（查看源代码）
Template:nv col begin（查看源代码）
Template:nv col end（查看源代码）
Template:nv col next（查看源代码）
Template:nv end（查看源代码）
Template:nv h1（查看源代码）
Template:nv h2（查看源代码）
Template:nv ln（查看源代码）
Template:nv ph（查看源代码）
Template:rev（查看源代码）
Template:rev begin（查看源代码）
Template:rev end（查看源代码）
Template:rev inl（查看源代码）
Template:rlp（查看源代码）
Template:rlps（查看源代码）
Template:rrev（查看源代码）
Template:sdsc（查看源代码）
Template:sdsc begin（查看源代码）
Template:sdsc end（查看源代码）
Template:sdsc sep（查看源代码）
Template:sep（查看源代码）
Template:source（查看源代码）
Template:spar（查看源代码）
Template:spar optional（查看源代码）
Template:spar sep（查看源代码）
Template:title（查看源代码）（受保护）
Template:tooltip（查看源代码）
Template:trim（查看源代码）
Template:tt（查看源代码）
Template:ttb（查看源代码）
Template:wg21（查看源代码）

返回cpp/language/attributes。

cppreference.com

搜索

命名空间

语言变体

查看

操作

查看“︁cpp/language/attributes”︁的源代码

导航

工具