← 返回起始笔记位置

知识卡片

普通读书笔记卡 · 5620.a.1.d.3.a

示例输出既是文档也是断言

理解等级:中级

Example函数中的末尾Output注释给出预期标准输出,go test执行后作比对;没有输出注释的示例只编译而不运行。示例适合展示稳定、简洁的用法,不能由某个打印结果推断全面正确性。名称应符合对象关联规则,当前工具会校验其对应标识符,不能随意用不存在的对象名。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • 程序测试和文档 · 查看原书依据

      如果一个样本测试函数中没有任何样本注释行,那么这个函数仅仅会被编译而不会被执行。 3. 样本测试函数的命名 按照惯例,根据被测试的程序实体的种类,我们应该遵循这样的样本测试函数命名规则。

    参考来源

    - 位置:《Go并发编程实战》第05章《程序测试和文档》之《5.1 程序测试》(来源项目book-sources;源文件:extracted/Go并发编程实战/_epub-src/text/part0000_split_035.html) - 结论依据:原文围绕示例输出既是文档也是断言给出定义、实例或限制;卡片结合这些上下文解释条件,已知错误在正文就近校正。 - 原始内容:如果一个样本测试函数中没有任何样本注释行,那么这个函数仅仅会被编译而不会被执行。 3. 样本测试函数的命名 按照惯例,根据被测试的程序实体的种类,我们应该遵循这样的样本测试函数命名规则。