C++ Core Guidelines

In.struct: The structure of this document

规则本身——例如，没有赤裸裸的新规则

引用号——例如，C.7(与类相关的第7条规则)。由于主要部分本身没有排序，所以我们使用字母作为规则引用“number”的第一部分。当我们添加或删除规则时，我们在编号中留下空隙以最小化“干扰”。

理由——因为发现程序员很难遵循他们不理解的规则。

例如——因为抽象的规则很难理解;不管是积极的还是消极的

替代——“不要这样做”规则的替代方法。

例外——我们更喜欢简单的一般规则。然而，许多规则应用广泛，但不是普遍的，因此必须列出例外情况．

执行——关于如何“机械地”检查规则的想法

其他看法——参见相关规则和进一步讨论的参考(在本文件或其他地方)

注释——需要说明但不适合其他分类的内容

讨论——引用更广泛的基本原理和/或置于主要规则列表之外的例子。

有些规则很难机械地检查，但专家程序员可以轻易地发现许多违规。我们希望改进“机械”工具，使它们更精确和可检查。规则的目的是简单，而不是提到每一种情况。其他情况可以在备选段落和讨论部分找到。如果你不理解一个规则或不同意它，去找它的讨论。

我们努力确保“好的”例子遵循核心准则。注释通常是用来说明规则的，在“真正的代码”中它们是不必要的或分散注意力的。我们假设了解标准库。例如，我们使用普通vector而不是std:: vector。

这不是语言手册。它想提供帮助，而不是在技术细节上完整、完全准确，或对现有代码的指导。推荐的信息来源可以在参考资料中找到。