官博译文:可测试的 Golang 代码示例

简介

Dodoc 的 示例 是一些可执行的测试代码的聚合,他们做为包的文档中的一部分提供给读者阅读和执行。读者可以点击 "Run" 按钮来测试代码

Golang 的标准包包括很多这种代码示例(比如 strings 包)

本文将示例如何写出类似的代码示例。

示例即单元测试

代码示例作为包的一部分编译并执行。

在典型的单元测试中,示例就是包内 _test.go 文件中的一些方法代码示例跟测试代码不同,示例方法以 Example 开头(不同于测试代码的 Test)并且没有参数。

stringutil 包是 golang 代码示例仓库中的一部分。下面的代码展示了他是如何演示 Reverse 的用法
package stringutil_test

import (
"fmt"

"github.com/golang/example/stringutil"
)

func ExampleReverse() {
fmt.Println(stringutil.Reverse("hello"))
// Output: olleh
}

上述代码可以在 stringutil 目录下的 example_test.go 文件中找到。

Godoc 在 Reverse 方法的文档中展示了这个代码示例,详见图:

相关文章

什么是Go的接口? 接口可以说是一种类型,可以粗略的理解为他...
1、Golang指针 在介绍Golang指针隐式间接引用前,先简单说下...
1、概述 1.1 Protocol buffers定义 Protocol buffe...
判断文件是否存在,需要用到"os"包中的两个函数: os.Stat(...
1、编译环境 OS :Loongnix-Server Linux release 8.3 CPU指...
1、概述 Golang是一种强类型语言,虽然在代码中经常看到i:=1...