From cf6a5f00f9de384ec85f59b87f8353e27f24352d Mon Sep 17 00:00:00 2001 From: prife Date: Sun, 31 Jan 2016 16:07:26 +0800 Subject: [PATCH] polish the reset of ch1-03.md --- ch1/ch1-03.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/ch1/ch1-03.md b/ch1/ch1-03.md index d3e47ea..dcefc2a 100644 --- a/ch1/ch1-03.md +++ b/ch1/ch1-03.md @@ -121,19 +121,19 @@ func countLines(f *os.File, counts map[string]int) { } ``` -os.Open函數會返迴兩個值。第一個值是一個打開的文件類型(\*os.File),這個對象在下面的程序中被Scanner讀取。 +`os.Open`函數返迴兩個值。第一個值是被打开的文件(*os.File),其后被`Scanner`讀取。 -os.Open返迴的第二個值是一個Go語言內置的error類型。如果這個error和內置值的nil(譯註:相當於其它語言里的NULL)相等的話,説明文件被成功的打開了。之後文件被讀取,一直到文件的最後,文件的Close方法關閉該文件,併釋放占用的一切資源。如果err的值不是nil的話,那説明在打開文件的時候出了某種錯誤。這種情況下,error類型的值會描述具體的問題。我們例子里的簡單錯誤處理會在標準錯誤流中用Fprintf和%v來格式化該錯誤字符串。然後繼續處理下一個文件;continue語句會直接跳過之後的語句,直接開始執行下一個循環迭代。 +`os.Open`返迴的第二個值是內置`error`類型的值。如果`err`等于內置值`nil`(譯註:相當於其它語言里的NULL),那么文件被成功打開。读取文件,直到文件结束,然后调用`Close`關閉該文件,併釋放占用的所有資源。相反的话,如果`err`的值不是`nil`,说明打開文件時出错了。這種情況下,错误值描述了所遇到的問題。我们的错误处理非常简单,只是使用`Fprintf`与表示任意类型默认格式值的动词`%v`, 向標準錯誤流打印一条信息,然後`dup`繼續處理下一個文件;`continue`語句直接跳到`for`循环的下个迭代开始执行。 -我們在本書早期的例子中做了比較詳盡的錯誤處理,當然了,在實際編碼過程中,像os.Open這類的函數是一定要檢査其返迴的error值的;爲了減少例子程序的代碼量,我們姑且簡化掉這些不太可能返迴錯誤的處理邏輯。後面的例子里我們會跳過錯誤檢査。在5.4節中我們會對錯誤處理做更詳細的闡述。 +为了使示例代码保持合理的大小,本书开始的一些示例有意简化了错误处理,显而易见的是,应该检查`os.Open`返回的错误值,然而,使用`input.Scan`读取文件过程中,不大可能出现错误,因此我们忽略了错误处理。我们会在跳过错误检查的地方做说明。5.4節中深入介绍錯誤處理。 -讀者可以再觀察一下上面的例子,countLines函數是在其聲明之前就被調用了。在Go語言里,函數和包級别的變量可以以任意的順序被聲明,併不影響其被調用。(譯註:最好還是遵循一定的規范) +注意`countLines`函數在其聲明前被調用。函數和包級别的變量(package-level entities)可以任意順序聲明,併不影響其被調用。(譯註:最好還是遵循一定的規范) -再來講講map這個數據結構,map是用make函數創建的數據結構的一個引用。當一個map被作爲參數傳遞給一個函數時,函數接收到的是一份引用的拷貝,雖然本身併不是一個東西,但因爲他們指向的是同一塊數據對象(譯註:類似於C++里的引用傳遞,實際上指針是另一個指針了,但內部存的值指向同一塊內存),所以你在函數里對map里的值進行脩改時,原始的map內的值也會改變。在我們的例子中,我們在countLines函數中插入到counts這個map里的值,在主函數中也是看得到的。 +`map`是一个由`make`函數創建的數據結構的引用。`map`作为爲參數傳遞給某函數時,该函數接收这个引用的一份拷贝(copy, 或译为副本),被调用函數對`map`底层数据结构的任何修改,调用者函数都可以通过持有的`map`引用看到。在我們的例子中,`countLines`函數向`counts`插入的值,也会被`main`函数看到。(譯註:類似於C++里的引用傳遞,實際上指針是另一個指針了,但內部存的值指向同一塊內存) -上面這個版本的dup是以流的形式來處理輸入,併將其打散爲行。理論上這些程序也是可以以二進製形式來處理輸入的。我們也可以一次性的把整個輸入內容全部讀到內存中,然後再把其分割爲多行,然後再去處理這些行內的數據。下面的dup3這個例子就是以這種形式來進行操作的。這個例子引入了一個新函數ReadFile(從io/ioutil包提供),這個函數會把一個指定名字的文件內容一次性調入,之後我們用strings.Split函數把文件分割爲多個子字符串,併存儲到slice結構中。(Split函數是strings.Join的逆函數,Join函數之前提到過) +`dup`的前两个版本以"流”模式读取輸入,併根据需要拆分成多个行。理論上,这些程序可以处理任意数量的输入数据。还有另一个方法,就是一口气把全部输入数据讀到內存中,一次分割爲多行,然後處理它们。下面这个版本, `dup3`,就是这么操作的。這個例子引入了`ReadFile`函數(来自于`io/ioutil`包),其读取指定文件的全部内容,`strings.Split`函數把字符串分割成子串的切片。(`Split`的作用前文提到的`strings.Join`相反。) -我們簡化了dup3這個程序。首先,它隻讀取命名的文件,而不去讀標準輸入,因爲ReadFile函數需要一個文件名參數。其次,我們將行計數邏輯移迴到了main函數,因爲現在這個邏輯隻有一個地方需要用到。 +我們略微簡化了`dup3`。首先,由于`ReadFile`函數需要文件名作为參數, 因此隻讀指定文件,不读標準輸入。其次,由于行计数代码只在一处用到,故將其移回`main`函數。 gopl.io/ch1/dup3 ```go @@ -166,8 +166,8 @@ func main() { } ``` -ReadFile函數返迴byte類型的slice,這個slice必須被轉換爲string,之後才能夠用strings.Split方法來進行處理。我們在3.5.4節中會更詳細地講解string和byte slice(字節數組)。 +`ReadFile`函數返迴一个字节切片(byte slice),必须把它轉換爲`string`, 才能用`strings.Split`分割。我們会在3.5.4節詳細講解字符串和字节切片。 -在更底層一些的地方,bufio.Scanner,ioutil.ReadFile和ioutil.WriteFile使用的都是*os.File的Read和Write方法,不過一般程序員併不需要去直接了解到其底層實現細節,在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`,出现重複的行时打印文件名称。