# 禁用格式 在源代码中插入注释标记可以禁用格式化和缩进。 [TOC] ## 禁用代码块 可以使用“off”和“on”标记禁用代码块。标签作为注释包含在源文件中。注释可以是C注释(/* ... */)或c++行注释(//)。标签必须包含在一行注释中。如果注释超过一行，缩进标记将被忽略。附加信息可以包含在标签中。 开头的标签是 " **\*INDENT-OFF\*** " ，结尾的标签是 " **\*INDENT-ON\*** "。它们可以在程序的任何地方使用，条件是标记之间的解析部分被禁用。禁用部分语句可能会导致结束标记后出现不正确的格式。如果发生这种情况，展开标记以包含其他代码。 以下保留预处理器定义的格式： ``` // *INDENT-OFF* #define FOO_DECLARE_int32_(name) \ FOO_API_ extern ::Int32 FOO_FLAG(name) // *INDENT-ON* ``` ## 禁用代码行 Artistic Style 无法决定有多种意义的符号的使用情况。例如，星号(*)可以是乘法、指针或指针引用。“&”和“&&”符号也是有类似的问题。 如果一个符号填充不正确，手工填充它可能会修复这个问题。如果仍未正确填充，则可能需要禁用格式。为了避免使用上面的“禁用代码块”标签，可以使用“禁用代码行”。 单行语句结束的注释标签“ **\*NOPAD\*** ”将禁用“pad-oper”、“align-pointer”和“align-reference”选项。解析不会停止，所有其他格式都将应用于该行。标签只适用于一行。 以下防止操作符填充更改： ``` size_t foo = (unsigned int) -1; // *NOPAD* ```