In.struct: The structure of this document
规则本身——例如,没有赤裸裸的新规则
引用号——例如,C.7(与类相关的第7条规则)。由于主要部分本身没有排序,所以我们使用字母作为规则引用“number”的第一部分。当我们添加或删除规则时,我们在编号中留下空隙以最小化“干扰”。
理由——因为发现程序员很难遵循他们不理解的规则。
例如——因为抽象的规则很难理解;不管是积极的还是消极的
替代——“不要这样做”规则的替代方法。
例外——我们更喜欢简单的一般规则。然而,许多规则应用广泛,但不是普遍的,因此必须列出例外情况.
执行——关于如何“机械地”检查规则的想法
其他看法——参见相关规则和进一步讨论的参考(在本文件或其他地方)
注释——需要说明但不适合其他分类的内容
讨论——引用更广泛的基本原理和/或置于主要规则列表之外的例子。
有些规则很难机械地检查,但专家程序员可以轻易地发现许多违规。我们希望改进“机械”工具,使它们更精确和可检查。规则的目的是简单,而不是提到每一种情况。其他情况可以在备选段落和讨论部分找到。如果你不理解一个规则或不同意它,去找它的讨论。
我们努力确保“好的”例子遵循核心准则。注释通常是用来说明规则的,在“真正的代码”中它们是不必要的或分散注意力的。我们假设了解标准库。例如,我们使用普通vector而不是std:: vector。
这不是语言手册。它想提供帮助,而不是在技术细节上完整、完全准确,或对现有代码的指导。推荐的信息来源可以在参考资料中找到。