Go by Example：讀取檔案

讀取和寫入檔案是許多 Go 程式所需的基本工作。首先我們將了解一些檔案讀取範例。

 
package main
 
import (
    "bufio"
    "fmt"
    "io"
    "os"
)

讀取檔案需要檢查大部分呼叫是否有錯誤。此方法說明將簡化我們的錯誤檢查。

 
func check(e error) {
    if e != nil {
        panic(e)
    }
}
 
func main() {

最基本的檔案讀取工作也許是將整個檔案的內容讀入到記憶體中。

 
    dat, err := os.ReadFile("/tmp/dat")
    check(err)
    fmt.Print(string(dat))

你通常會想更多地控制如何及讀取哪些檔案部份。對於這些工作，請從開啟檔案以取得 os.File 值開始。

 
    f, err := os.Open("/tmp/dat")
    check(err)

從檔案的開頭讀取一些位元組。容許讀取最多 5 個位元組，並記錄實際讀取的數量。

 
    b1 := make([]byte, 5)
    n1, err := f.Read(b1)
    check(err)
    fmt.Printf("%d bytes: %s\n", n1, string(b1[:n1]))

你也可以使用 Seek 跳到檔案中的已知位置，然後從那裡開始讀取。

 
    o2, err := f.Seek(6, io.SeekStart)
    check(err)
    b2 := make([]byte, 2)
    n2, err := f.Read(b2)
    check(err)
    fmt.Printf("%d bytes @ %d: ", n2, o2)
    fmt.Printf("%v\n", string(b2[:n2]))

其他尋址方法會相對於目前游標位置，

 
    _, err = f.Seek(4, io.SeekCurrent)
    check(err)

以及相對於檔案結尾。

 
    _, err = f.Seek(-10, io.SeekEnd)
    check(err)

io 套件提供一些函數，這些函數可能有助於檔案讀取。例如，可以更穩健地實作像是上述的讀取，方法是使用 ReadAtLeast。

 
    o3, err := f.Seek(6, io.SeekStart)
    check(err)
    b3 := make([]byte, 2)
    n3, err := io.ReadAtLeast(f, b3, 2)
    check(err)
    fmt.Printf("%d bytes @ %d: %s\n", n3, o3, string(b3))

內建沒有快轉功能，但 Seek(0, io.SeekStart) 可以達成這個目的。

 
    _, err = f.Seek(0, io.SeekStart)
    check(err)

bufio 套件實作一個緩衝讀取器，它可能對於許多小型讀取的效率和它提供的新增讀取方法都很有用。

 
    r4 := bufio.NewReader(f)
    b4, err := r4.Peek(5)
    check(err)
    fmt.Printf("5 bytes: %s\n", string(b4))

完成後請關閉檔案（通常會在使用 defer 執行 Open 之後立即排程）。

 
    f.Close()
}
 
$ echo "hello" > /tmp/dat
$ echo "go" >>   /tmp/dat
$ go run reading-files.go
hello
go
5 bytes: hello
2 bytes @ 6: go
2 bytes @ 6: go
5 bytes: hello

接下來我們將了解檔案寫入。

下一個範例：寫入檔案。

由 Mark McGranaghan 和 Eli Bendersky | 來源 | 授權