From: jiahua wang <wjh180909@gmail.com>
Date: Wed, 22 Sep 2021 14:32:55 +0000 (+0800)
Subject: encoding/base32: Add examples for Encode/Decode
X-Git-Tag: go1.18beta1~1183
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=f9a53b6b4d6d2a036e80ff79cc7bc34d788cd1c0;p=gostls13.git

encoding/base32: Add examples for Encode/Decode

Updates golang/go#37595

Change-Id: I7568e7416d5504e9dc67061c79f66e3a0d597dee
Reviewed-on: https://go-review.googlesource.com/c/go/+/351470
Run-TryBot: Ian Lance Taylor <iant@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Ian Lance Taylor <iant@golang.org>
Trust: David Chase <drchase@google.com>
---

diff --git a/src/encoding/base32/example_test.go b/src/encoding/base32/example_test.go
index 2a302d88da..251624f0bd 100644
--- a/src/encoding/base32/example_test.go
+++ b/src/encoding/base32/example_test.go
@@ -20,6 +20,15 @@ func ExampleEncoding_EncodeToString() {
 	// MFXHSIBLEBXWYZBAEYQGIYLUME======
 }
 
+func ExampleEncoding_Encode() {
+	data := []byte("Hello, world!")
+	dst := make([]byte, base32.StdEncoding.EncodedLen(len(data)))
+	base32.StdEncoding.Encode(dst, data)
+	fmt.Println(string(dst))
+	// Output:
+	// JBSWY3DPFQQHO33SNRSCC===
+}
+
 func ExampleEncoding_DecodeString() {
 	str := "ONXW2ZJAMRQXIYJAO5UXI2BAAAQGC3TEEDX3XPY="
 	data, err := base32.StdEncoding.DecodeString(str)
@@ -32,6 +41,20 @@ func ExampleEncoding_DecodeString() {
 	// "some data with \x00 and \ufeff"
 }
 
+func ExampleEncoding_Decode() {
+	str := "JBSWY3DPFQQHO33SNRSCC==="
+	dst := make([]byte, base32.StdEncoding.DecodedLen(len(str)))
+	n, err := base32.StdEncoding.Decode(dst, []byte(str))
+	if err != nil {
+		fmt.Println("decode error:", err)
+		return
+	}
+	dst = dst[:n]
+	fmt.Printf("%q\n", dst)
+	// Output:
+	// "Hello, world!"
+}
+
 func ExampleNewEncoder() {
 	input := []byte("foo\x00bar")
 	encoder := base32.NewEncoder(base32.StdEncoding, os.Stdout)