当前位置: 首页 > 知识库问答 >
问题:

C++标准的核心语言规范中的注释和示例是非规范性的吗?

史景铄
2023-03-14

因此问题是:C++标准中的所有注释和示例都是非规范性的吗?脚注呢?

共有1个答案

许俊贤
2023-03-14

参见ISO/IEC指令第2部分的§6.5。注释、示例和脚注都被认为是“信息性的”,而不是“规范性的”。

有关注释和示例:

文件正文中的注释和示例仅用于提供旨在帮助理解或使用文件的附加信息。它们不应包含要求(“应”;见3.3.1和表H.1)或任何被认为对文件的使用必不可少的信息,例如指示(必须;见表H.1)、建议(“应”;见3.3.2和表H.2)或许可(“可”;见表H.3)。注释可以作为事实陈述而写。

脚注:

案文脚注提供了补充资料;它们的使用应保持在最低限度。与文本中的注释和示例一样(见6.5.1),脚注不得包含使用文件所必需的要求或任何信息。

但是,请注意,图和表的脚注可以包含需求。

 类似资料:
  • 对于那些不熟悉它们的人--我正在寻找这样的文档http://docs.oracle.com/javase/specs/jls/se7/html/index.html。 提前道谢!

  • PSR 是 PHP Standard Recommendations 的简写,由 PHP FIG 组织制定的 PHP 规范,是 PHP 开发的实践标准。

  • PHP 语言规范,Facebook 已经把所有该规范的版权贡献给献给 CC0 公共域协议,本规范的发布不提供任何保证,Facebook 公司在 2014 年发起该项目。

  • var关键字 总是用 var 关键字定义变量。 描述 如果不显式使用 var 关键字定义变量,变量会进入到全局上下文中,可能会和已有的变量发生冲突。另外,如果不使用var声明,很难说变量存在的作用域是哪个(可能在局部作用域里,也可能在document或者window上)。所以,要一直使用 var 关键字定义变量。 常量 使用字母全部大写(如 NAMES_LIKE_THIS )的方式命名 可以使用

  • Lint 小技巧 使用该 pylintrc 对你的代码运行pylint 定义: pylint是一个在Python源代码中查找bug的工具. 对于C和C++这样的不那么动态的(译者注: 原文是less dynamic)语言, 这些bug通常由编译器来捕获. 由于Python的动态特性, 有些警告可能不对. 不过伪告警应该很少. 优点: 可以捕获容易忽视的错误, 例如输入错误, 使用未赋值的变量等.

  • 注意:本文档已失效,请浏览 Istio 官方文档。本书中的 Service Mesh 章节已不再维护,请转到 istio-handbook 中浏览。 我们知道 Istio 通过向 Pod 中注入一个 sidecar 容器来将 Pod 纳入到 Istio service mesh 中的,那么这些 sidecar 容器的注入遵循什么样的规范,需要给每个 Pod 增加哪些配置信息才能纳入 Istio s