go package學習——io/util

這是一個建立於 的文章，其中的資訊可能已經有所發展或是發生改變。

package io/util實現了一些io效用函數。

Index

• Variables
• func NopCloser(r io.Reader) io.ReadCloser
• func ReadAll(r io.Reader) ([]byte, error)
• func ReadDir(dirname string) ([]os.FileInfo, error)
• func ReadFile(filename string) ([]byte, error)
• func TempDir(dir, prefix string) (name string, err error)
• func TempFile(dir, prefix string) (f *os.File, err error)
• func WriteFile(filename string, data []byte, perm os.FileMode) error

Package Files

blackhole.go ioutil.go tempfile.go

func ReadAll

func ReadAll(r io.Reader) ([]byte, error)

讀，直到遇到error或EOF；返回讀到的資料。

func ReadDir

func ReadDir(dirname string) ([]os.FileInfo, error)

根據給定的目錄名讀取目錄，返回目錄的FileInfo。

func ReadFile

func ReadFile(filename string) ([]byte, error)

根據檔案名稱讀取檔案，返回讀取的內容。

func WriteFile

func WriteFile(filename string, data []byte, perm os.FileMode) error

向給定的檔案中寫入資料；如果給定的檔案不存在，則依據perm建立此檔案；如果存在，則先進行截斷，再寫入資料。

// ioutil.go
------------------------------------------------------------
// ReadAll 讀取 r 中的所有資料
// 返回讀取的資料和讀取過程中遇到的任何錯誤
// 如果讀取成功，則 err 返回 nil，而不是 EOF
func ReadAll(r io.Reader) ([]byte, error)

func main() {
s := strings.NewReader("Hello World!")
ra, _ := ioutil.ReadAll(s)
fmt.Printf("%s", ra)
// Hello World!
}
------------------------------------------------------------

// ReadFile 讀取檔案中的所有資料
// 返回讀取的資料和讀取過程中遇到的任何錯誤
// 如果讀取成功，則 err 返回 nil，而不是 EOF
func ReadFile(filename string) ([]byte, error)

func main() {
ra, _ := ioutil.ReadFile("C:\\Windows\\win.ini")
fmt.Printf("%s", ra)
}
------------------------------------------------------------

// WriteFile 向檔案 filename 中寫入資料 data
// 如果檔案不存在，則以 perm 許可權建立該檔案
// 如果檔案存在，則先清空檔案，然後再寫入
// 返回寫入過程中遇到的任何錯誤
func WriteFile(filename string, data []byte, perm os.FileMode) error

func main() {
fn := "C:\\Test.txt"
s := []byte("Hello World!")
ioutil.WriteFile(fn, s, os.ModeAppend)
rf, _ := ioutil.ReadFile(fn)
fmt.Printf("%s", rf)
// Hello World!
}
------------------------------------------------------------

// ReadDir 讀取目錄 dirmane 中的所有目錄和檔案（不包括子目錄）
// 返回讀取到的檔案的資訊列表和讀取過程中遇到的任何錯誤
// 返回的檔案清單是經過排序的
func ReadDir(dirname string) ([]os.FileInfo, error)

func main() {
rd, err := ioutil.ReadDir("C:\\Windows")
for _, fi := range rd {
fmt.Println("")
fmt.Println(fi.Name())
fmt.Println(fi.IsDir())
fmt.Println(fi.Size())
fmt.Println(fi.ModTime())
fmt.Println(fi.Mode())
}
fmt.Println("")
fmt.Println(err)
}
------------------------------------------------------------

// NopCloser 將 r 封裝為一個 ReadCloser 類型
// 其 Close 方法不做任何事情
func NopCloser(r io.Reader) io.ReadCloser
------------------------------------------------------------
// tempfile.go
------------------------------------------------------------

// TempFile 在目錄 dir 中建立一個臨時檔案並將其開啟
// 檔案名稱以 prefix 為首碼
// 返回建立的檔案的對象和建立過程中遇到的任何錯誤
// 如果 dir 為空白，則在系統的臨時目錄中建立臨時檔案
// 如果環境變數中沒有設定系統臨時目錄，則在 /tmp 中建立臨時檔案
// 調用者可以通過 f.Name() 方法擷取臨時檔案的完整路徑
// 調用 TempFile 所建立的臨時檔案，應該由調用者自己移除
func TempFile(dir, prefix string) (f *os.File, err error)


func main() {
dn := "C:\\"
f, _ := ioutil.TempFile(dn, "Test")
fmt.Printf("%s", f.Name())
}
------------------------------------------------------------

// TempDir 功能同 TempFile，只不過建立的是目錄
// 傳回值也只返目錄的完整路徑
func TempDir(dir, prefix string) (name string, err error)

func main() {
dn := "C:\\"
f, _ := ioutil.TempDir(dn, "Test")
fmt.Printf("%s", f.Name())
}