style(ch1-03): 优化排版

This commit is contained in:
iGmainC 2022-08-08 13:06:43 +08:00 committed by GitHub
parent 84bd2c3927
commit 99929b676b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -5,6 +5,7 @@
`dup` 的第一个版本打印标准输入中多次出现的行,以重复次数开头。该程序将引入 `if` 语句,`map` 数据类型以及 `bufio` 包。 `dup` 的第一个版本打印标准输入中多次出现的行,以重复次数开头。该程序将引入 `if` 语句,`map` 数据类型以及 `bufio` 包。
<u><i>gopl.io/ch1/dup1</i></u> <u><i>gopl.io/ch1/dup1</i></u>
```go ```go
// Dup1 prints the text of each line that appears more than // Dup1 prints the text of each line that appears more than
// once in the standard input, preceded by its count. // once in the standard input, preceded by its count.
@ -35,7 +36,7 @@ func main() {
**map** 存储了键/值key/value的集合对集合元素提供常数时间的存、取或测试操作。键可以是任意类型只要其值能用 `==` 运算符比较,最常见的例子是字符串;值则可以是任意类型。这个例子中的键是字符串,值是整数。内置函数 `make` 创建空 `map`此外它还有别的作用。4.3 节讨论 `map` **map** 存储了键/值key/value的集合对集合元素提供常数时间的存、取或测试操作。键可以是任意类型只要其值能用 `==` 运算符比较,最常见的例子是字符串;值则可以是任意类型。这个例子中的键是字符串,值是整数。内置函数 `make` 创建空 `map`此外它还有别的作用。4.3 节讨论 `map`
(译注:从功能和实现上说,`Go`的`map`类似于`Java`语言中的`HashMap`Python语言中的`dict``Lua`语言中的`table`,通常使用`hash`实现。遗憾的是,对于该词的翻译并不统一,数学界术语为`映射`,而计算机界众说纷纭莫衷一是。为了防止对读者造成误解,保留不译。) (译注:从功能和实现上说,`Go` `map` 类似于 `Java` 语言中的 `HashMap`Python 语言中的 `dict``Lua` 语言中的 `table`,通常使用 `hash` 实现。遗憾的是,对于该词的翻译并不统一,数学界术语为*映射*,而计算机界众说纷纭莫衷一是。为了防止对读者造成误解,保留不译。)
每次 `dup` 读取一行输入,该行被当做键存入 `map`,其对应的值递增。`counts[input.Text()]++` 语句等价下面两句: 每次 `dup` 读取一行输入,该行被当做键存入 `map`,其对应的值递增。`counts[input.Text()]++` 语句等价下面两句:
@ -44,15 +45,15 @@ line := input.Text()
counts[line] = counts[line] + 1 counts[line] = counts[line] + 1
``` ```
`map`中不含某个键时不用担心,首次读到新行时,等号右边的表达式`counts[line]`的值将被计算为其类型的零值,对于`int`即0。 `map` 中不含某个键时不用担心,首次读到新行时,等号右边的表达式 `counts[line]` 的值将被计算为其类型的零值,对于 `int` `0`
为了打印结果,我们使用了基于`range`的循环,并在`counts`这个`map`上迭代。跟之前类似,每次迭代得到两个结果,键和其在`map`中对应的值。`map`的迭代顺序并不确定从实践来看该顺序随机每次运行都会变化。这种设计是有意为之的因为能防止程序依赖特定遍历顺序而这是无法保证的。译注具体可以参见这里http://stackoverflow.com/questions/11853396/google-go-lang-assignment-order 为了打印结果,我们使用了基于 `range` 的循环,并在 `counts` 这个 `map` 上迭代。跟之前类似,每次迭代得到两个结果,键和其在 `map` 中对应的值。`map` 的迭代顺序并不确定,从实践来看,该顺序随机,每次运行都会变化。这种设计是有意为之的,因为能防止程序依赖特定遍历顺序,而这是无法保证的。(译注:具体可以参见这里[https://stackoverflow.com/questions/11853396/google-go-lang-assignment-order](https://stackoverflow.com/questions/11853396/google-go-lang-assignment-order)
继续来看 `bufio` 包,它使处理输入和输出方便又高效。`Scanner` 类型是该包最有用的特性之一,它读取输入并将其拆成行或单词;通常是处理行形式的输入最简单的方法。 继续来看 `bufio` 包,它使处理输入和输出方便又高效。`Scanner` 类型是该包最有用的特性之一,它读取输入并将其拆成行或单词;通常是处理行形式的输入最简单的方法。
程序使用短变量声明创建 `bufio.Scanner` 类型的变量 `input` 程序使用短变量声明创建 `bufio.Scanner` 类型的变量 `input`
``` ```go
input := bufio.NewScanner(os.Stdin) input := bufio.NewScanner(os.Stdin)
``` ```
@ -62,7 +63,7 @@ input := bufio.NewScanner(os.Stdin)
`Printf` 有一大堆这种转换Go程序员称之为*动词verb*。下面的表格虽然远不是完整的规范,但展示了可用的很多特性: `Printf` 有一大堆这种转换Go程序员称之为*动词verb*。下面的表格虽然远不是完整的规范,但展示了可用的很多特性:
``` ```text
%d 十进制整数 %d 十进制整数
%x, %o, %b 十六进制,八进制,二进制整数。 %x, %o, %b 十六进制,八进制,二进制整数。
%f, %g, %e 浮点数: 3.141593 3.141592653589793 3.141593e+00 %f, %g, %e 浮点数: 3.141593 3.141592653589793 3.141593e+00
@ -80,6 +81,7 @@ input := bufio.NewScanner(os.Stdin)
很多程序要么从标准输入中读取数据,如上面的例子所示,要么从一系列具名文件中读取数据。`dup` 程序的下个版本读取标准输入或是使用 `os.Open` 打开各个具名文件,并操作它们。 很多程序要么从标准输入中读取数据,如上面的例子所示,要么从一系列具名文件中读取数据。`dup` 程序的下个版本读取标准输入或是使用 `os.Open` 打开各个具名文件,并操作它们。
<u><i>gopl.io/ch1/dup2</i></u> <u><i>gopl.io/ch1/dup2</i></u>
```go ```go
// Dup2 prints the count and text of lines that appear more than once // Dup2 prints the count and text of lines that appear more than once
// in the input. It reads from stdin or from a list of named files. // in the input. It reads from stdin or from a list of named files.
@ -123,9 +125,9 @@ func countLines(f *os.File, counts map[string]int) {
} }
``` ```
`os.Open`函数返回两个值。第一个值是被打开的文件(`*os.File`),其后被`Scanner`读取。 `os.Open` 函数返回两个值。第一个值是被打开的文件`*os.File`),其后被 `Scanner` 读取。
`os.Open`返回的第二个值是内置`error`类型的值。如果`err`等于内置值`nil`译注相当于其它语言里的NULL那么文件被成功打开。读取文件直到文件结束然后调用`Close`关闭该文件,并释放占用的所有资源。相反的话,如果`err`的值不是`nil`,说明打开文件时出错了。这种情况下,错误值描述了所遇到的问题。我们的错误处理非常简单,只是使用`Fprintf`与表示任意类型默认格式值的动词`%v`,向标准错误流打印一条信息,然后`dup`继续处理下一个文件;`continue`语句直接跳到`for`循环的下个迭代开始执行。 `os.Open` 返回的第二个值是内置 `error` 类型的值。如果 `err` 等于内置值`nil`(译注:相当于其它语言里的 `NULL`),那么文件被成功打开。读取文件,直到文件结束,然后调用 `Close` 关闭该文件,并释放占用的所有资源。相反的话,如果 `err` 的值不是 `nil`,说明打开文件时出错了。这种情况下,错误值描述了所遇到的问题。我们的错误处理非常简单,只是使用 `Fprintf` 与表示任意类型默认格式值的动词 `%v`,向标准错误流打印一条信息,然后 `dup` 继续处理下一个文件;`continue` 语句直接跳到 `for` 循环的下个迭代开始执行。
为了使示例代码保持合理的大小,本书开始的一些示例有意简化了错误处理,显而易见的是,应该检查 `os.Open` 返回的错误值,然而,使用 `input.Scan` 读取文件过程中不大可能出现错误因此我们忽略了错误处理。我们会在跳过错误检查的地方做说明。5.4 节中深入介绍错误处理。 为了使示例代码保持合理的大小,本书开始的一些示例有意简化了错误处理,显而易见的是,应该检查 `os.Open` 返回的错误值,然而,使用 `input.Scan` 读取文件过程中不大可能出现错误因此我们忽略了错误处理。我们会在跳过错误检查的地方做说明。5.4 节中深入介绍错误处理。
@ -138,6 +140,7 @@ func countLines(f *os.File, counts map[string]int) {
我们略微简化了 `dup3`。首先,由于 `ReadFile` 函数需要文件名作为参数,因此只读指定文件,不读标准输入。其次,由于行计数代码只在一处用到,故将其移回 `main` 函数。 我们略微简化了 `dup3`。首先,由于 `ReadFile` 函数需要文件名作为参数,因此只读指定文件,不读标准输入。其次,由于行计数代码只在一处用到,故将其移回 `main` 函数。
<u><i>gopl.io/ch1/dup3</i></u> <u><i>gopl.io/ch1/dup3</i></u>
```go ```go
package main package main
@ -172,4 +175,6 @@ func main() {
实现上,`bufio.Scanner`、`ioutil.ReadFile` 和 `ioutil.WriteFile` 都使用 `*os.File``Read``Write` 方法但是大多数程序员很少需要直接调用那些低级lower-level函数。高级higher-level函数`bufio``io/ioutil` 包中所提供的那些,用起来要容易点。 实现上,`bufio.Scanner`、`ioutil.ReadFile` 和 `ioutil.WriteFile` 都使用 `*os.File``Read``Write` 方法但是大多数程序员很少需要直接调用那些低级lower-level函数。高级higher-level函数`bufio``io/ioutil` 包中所提供的那些,用起来要容易点。
-----
**练习 1.4** 修改 `dup2`,出现重复的行时打印文件名称。 **练习 1.4** 修改 `dup2`,出现重复的行时打印文件名称。