make loop

ch1/ch1-03.md

@@ -1,8 +1,8 @@
 ## 1.3. 査找重複的行
 
-对文件做拷貝、打印、蒐索、排序、統計或类似事情的程序都有一个差不多的程序結構：一個處理輸入的循環，在每個元素上執行計算處理，在處理的同時或最后产生输出。我們會展示一個名爲`dup`的程序的三個版本；靈感來自於Unix的`uniq`命令，其寻找相鄰的重複行。该程序使用的结构和包是个参考范例，可以方便地修改。
+對文件做拷貝、打印、蒐索、排序、統計或類似事情的程序都有一個差不多的程序結構：一個處理輸入的循環，在每個元素上執行計算處理，在處理的同時或最後産生輸出。我們會展示一個名爲`dup`的程序的三個版本；靈感來自於Unix的`uniq`命令，其尋找相鄰的重複行。該程序使用的結構和包是個參考范例，可以方便地脩改。
 
-`dup`的第一個版本打印標準輸入中多次出現的行，以重复次数开头。该程序將引入`if`语句，`map`數據类型以及`bufio`包。
+`dup`的第一個版本打印標準輸入中多次出現的行，以重複次數開頭。該程序將引入`if`語句，`map`數據類型以及`bufio`包。
 
 <u><i>gopl.io/ch1/dup1</i></u>
 ```go
@@ -31,40 +31,40 @@ func main() {
 }
 ```
 
-正如`for`循環一樣，`if`语句條件兩邊也不加括號，但是主体部分需要加。`if`语句的`else`部分是可选的，在`if`的條件爲`false`時執行。
+正如`for`循環一樣，`if`語句條件兩邊也不加括號，但是主體部分需要加。`if`語句的`else`部分是可選的，在`if`的條件爲`false`時執行。
 
-**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()]++`語句等價下面兩句：
 
 ```go
 line := input.Text()
 counts[line] = counts[line] + 1
 ```
 
-`map`中不含某個键時不用擔心，首次读到新行时，等号右边的表达式`counts[line]`的值将被计算为其类型的零值，对于int`即0。
+`map`中不含某個鍵時不用擔心，首次讀到新行時，等號右邊的表達式`counts[line]`的值將被計算爲其類型的零值，對於int`卽0。
 
-为了打印结果，我们使用了基于`range`的循环，并在`counts`这个`map`上迭代。跟之前类似，每次迭代得到两个结果，键和其在`map`中对应的值。`map`的迭代顺序并不确定，從實踐來看，该顺序随机，每次运行都会变化。这种设计是有意为之的，因为能防止程序依赖特定遍历顺序，而这是无法保证的。
+爲了打印結果，我們使用了基於`range`的循環，併在`counts`這個`map`上迭代。跟之前類似，每次迭代得到兩個結果，鍵和其在`map`中對應的值。`map`的迭代順序併不確定，從實踐來看，該順序隨機，每次運行都會變化。這種設計是有意爲之的，因爲能防止程序依賴特定遍歷順序，而這是無法保證的。
 
-继续来看`bufio`包，它使處理輸入和輸出方便又高效。`Scanner`類型是该包最有用的特性之一，它读取输入并将其拆成行或單詞；通常是處理行形式的輸入最簡單的方法。
+繼續來看`bufio`包，它使處理輸入和輸出方便又高效。`Scanner`類型是該包最有用的特性之一，它讀取輸入併將其拆成行或單詞；通常是處理行形式的輸入最簡單的方法。
 
-程序使用短變量聲明創建`bufio.Scanner`类型的变量`input`。
+程序使用短變量聲明創建`bufio.Scanner`類型的變量`input`。
 
 ```
 input := bufio.NewScanner(os.Stdin)
 ```
 
-该变量從程序的標準輸入中讀取內容。每次調用`input.Scanner`，即读入下一行，并移除行末的換行符；读取的内容可以调用`input.Text()`得到。`Scan`函数在读到一行时返迴`true`，在无输入时返迴`false`。
+該變量從程序的標準輸入中讀取內容。每次調用`input.Scanner`，卽讀入下一行，併移除行末的換行符；讀取的內容可以調用`input.Text()`得到。`Scan`函數在讀到一行時返迴`true`，在無輸入時返迴`false`。
 
-类似于C或其它語言里的`printf`函數，`fmt.Printf`函数对一些表达式产生格式化输出。该函数的首個參數是个格式字符串，指定后续参数被如何格式化。各個參數的格式取決於“轉換字符”（conversion character），形式为百分号后跟一個字母。举个例子，`%d`表示以十进制形式打印一個整型操作数，而`%s`則表示把字符串型操作数的值展开。
+類似於C或其它語言里的`printf`函數，`fmt.Printf`函數對一些表達式産生格式化輸出。該函數的首個參數是個格式字符串，指定後續參數被如何格式化。各個參數的格式取決於“轉換字符”（conversion character），形式爲百分號後跟一個字母。舉個例子，`%d`表示以十進製形式打印一個整型操作數，而`%s`則表示把字符串型操作數的值展開。
 
-`Printf`有一大堆這種轉換，Go程序員称之为*动词（verb）*。下面的表格虽然远不是完整的规范，但展示了可用的很多特性：
+`Printf`有一大堆這種轉換，Go程序員稱之爲*動詞（verb）*。下面的表格雖然遠不是完整的規范，但展示了可用的很多特性：
 
 ```
-%d          十进制整数
-%x, %o, %b  十六進製，八進製，二進製整数。
+%d          十進製整數
+%x, %o, %b  十六進製，八進製，二進製整數。
 %f, %g, %e  浮點數： 3.141593 3.141592653589793 3.141593e+00
 %t          布爾：true或false
 %c          字符（rune） (Unicode碼點)
@@ -72,12 +72,12 @@ input := bufio.NewScanner(os.Stdin)
 %q          帶雙引號的字符串"abc"或帶單引號的字符'c'
 %v          變量的自然形式（natural format）
 %T          變量的類型
-%%          字面上的百分号標誌（无操作数）
+%%          字面上的百分號標誌（無操作數）
 ```
 
-`dup1`的格式字符串中还含有制表符`\t`和换行符`\n`。字符串字面上可能含有這些代表不可見字符的**轉義字符（escap sequences）**。默認情况下，`Printf`不會換行。按照慣例，以字母`f`結尾的格式化函數，如`log.Printf`和`fmt.Errorf`，都采用`fmt.Printf`的格式化准则。而以`ln`結尾的格式化函數，则遵循`Println`的方式，以跟`%v`差不多的方式格式化參數，并在最後添加一個換行符。（译注：后缀`f`指`fomart`，`ln`指`line`。）
+`dup1`的格式字符串中還含有製表符`\t`和換行符`\n`。字符串字面上可能含有這些代表不可見字符的**轉義字符（escap sequences）**。默認情況下，`Printf`不會換行。按照慣例，以字母`f`結尾的格式化函數，如`log.Printf`和`fmt.Errorf`，都采用`fmt.Printf`的格式化準則。而以`ln`結尾的格式化函數，則遵循`Println`的方式，以跟`%v`差不多的方式格式化參數，併在最後添加一個換行符。（譯註：後綴`f`指`fomart`，`ln`指`line`。）
 
-很多程序要么從標準輸入中讀取數據，如上面的例子所示，要么从一系列具名文件中讀取數據。`dup`程序的下个版本读取標準輸入或是使用`os.Open`打开各个具名文件，并操作它们。
+很多程序要麽從標準輸入中讀取數據，如上面的例子所示，要麽從一繫列具名文件中讀取數據。`dup`程序的下個版本讀取標準輸入或是使用`os.Open`打開各個具名文件，併操作它們。
 
 <u><i>gopl.io/ch1/dup2</i></u>
 ```go
@@ -123,19 +123,19 @@ 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節中深入介紹錯誤處理。
 
-注意`countLines`函數在其聲明前被調用。函數和包級别的變量（package-level entities）可以任意順序聲明，併不影響其被調用。（譯註：最好還是遵循一定的規范）
+註意`countLines`函數在其聲明前被調用。函數和包級别的變量（package-level entities）可以任意順序聲明，併不影響其被調用。（譯註：最好還是遵循一定的規范）
 
-`map`是一个由`make`函數創建的數據結構的引用。`map`作为爲參數傳遞給某函數時，该函數接收这个引用的一份拷贝（copy，或译为副本），被调用函數對`map`底层数据结构的任何修改，调用者函数都可以通过持有的`map`引用看到。在我們的例子中，`countLines`函數向`counts`插入的值，也会被`main`函数看到。（譯註：類似於C++里的引用傳遞，實際上指針是另一個指針了，但內部存的值指向同一塊內存）
+`map`是一個由`make`函數創建的數據結構的引用。`map`作爲爲參數傳遞給某函數時，該函數接收這個引用的一份拷貝（copy，或譯爲副本），被調用函數對`map`底層數據結構的任何脩改，調用者函數都可以通過持有的`map`引用看到。在我們的例子中，`countLines`函數向`counts`插入的值，也會被`main`函數看到。（譯註：類似於C++里的引用傳遞，實際上指針是另一個指針了，但內部存的值指向同一塊內存）
 
-`dup`的前两个版本以"流”模式读取輸入，併根据需要拆分成多个行。理論上，这些程序可以处理任意数量的输入数据。还有另一个方法，就是一口气把全部输入数据讀到內存中，一次分割爲多行，然後處理它们。下面这个版本，`dup3`，就是这么操作的。這個例子引入了`ReadFile`函數（来自于`io/ioutil`包），其读取指定文件的全部内容，`strings.Split`函數把字符串分割成子串的切片。（`Split`的作用与前文提到的`strings.Join`相反。）
+`dup`的前兩個版本以"流”模式讀取輸入，併根據需要拆分成多個行。理論上，這些程序可以處理任意數量的輸入數據。還有另一個方法，就是一口氣把全部輸入數據讀到內存中，一次分割爲多行，然後處理它們。下面這個版本，`dup3`，就是這麽操作的。這個例子引入了`ReadFile`函數（來自於`io/ioutil`包），其讀取指定文件的全部內容，`strings.Split`函數把字符串分割成子串的切片。（`Split`的作用與前文提到的`strings.Join`相反。）
 
-我們略微簡化了`dup3`。首先，由于`ReadFile`函數需要文件名作为參數，因此隻讀指定文件，不读標準輸入。其次，由于行计数代码只在一处用到，故將其移回`main`函數。
+我們略微簡化了`dup3`。首先，由於`ReadFile`函數需要文件名作爲參數，因此隻讀指定文件，不讀標準輸入。其次，由於行計數代碼隻在一處用到，故將其移迴`main`函數。
 
 <u><i>gopl.io/ch1/dup3</i></u>
 ```go
@@ -168,8 +168,8 @@ func main() {
 }
 ```
 
-`ReadFile`函數返迴一个字节切片（byte slice），必须把它轉換爲`string`，才能用`strings.Split`分割。我們会在3.5.4節詳細講解字符串和字节切片。
+`ReadFile`函數返迴一個字節切片（byte slice），必須把它轉換爲`string`，才能用`strings.Split`分割。我們會在3.5.4節詳細講解字符串和字節切片。
 
-实现上，`bufio.Scanner`、`outil.ReadFile`和`ioutil.WriteFile`都使用`*os.File`的`Read`和`Write`方法，但是，大多数程序員很少需要直接调用那些低级（lower-level）函数。高级（higher-level）函数，像`bufio`和`io/ioutil`包中所提供的那些，用起来要容易点。
+實現上，`bufio.Scanner`、`outil.ReadFile`和`ioutil.WriteFile`都使用`*os.File`的`Read`和`Write`方法，但是，大多數程序員很少需要直接調用那些低級（lower-level）函數。高級（higher-level）函數，像`bufio`和`io/ioutil`包中所提供的那些，用起來要容易點。
 
-**練習 1.4：** 脩改`dup2`，出现重複的行时打印文件名称。
+**練習 1.4：** 脩改`dup2`，出現重複的行時打印文件名稱。