Go 学习笔记（21）— 标准库 os 操作文件（新建、打开、写入、读取、删除、关闭文件）

Go 操作文本文件时，与其它语言一样也有新建文件、打开文件、写文件、读文件、删除文件等操作。主要有两个标准库来提供这些操作，分别为 os 和 ioutil 。在该文中我们介绍 os 模块。

1. 新建文件

func Create(name string) (file *File, err Error)
//返回 File 的内存地址, 错误信息；通过 os 库调用

os.Create 函数用于根据给定的路径创建一个新的文件。 它会返回一个 File 值和一个错误值。我们可以在该函数返回的 File 值之上，对相应的文件进行读操作和写操作。

如果在我们给予 os.Create 函数的路径之上，已经存在了一个文件，那么该函数会先清空现有文件中的全部内容，然后再把它作为第一个结果值返回。

func NewFile(fd	int, name string) *File
//返回文件的内存地址, 通过 os 库调用

该函数在被调用的时候，需要接受一个代表文件描述符的、uintptr 类型的值，以及一个用于表示文件名的字符串值。

不要被这个函数的名称误导了，它的功能并不是创建一个新的文件，而是依据一个已经存在的文件的描述符，来新建一个包装了该文件的 File 值。

file3 := os.NewFile(uintptr(syscall.Stderr), "/dev/stderr")
file3.WriteString("The Go language program writes something to stderr.\n")

2. 打开文件

func Open(name	string) (file *File, err Error)
//返回 File 的内存地址, 错误信息；通过 os 库调用

os.Open 函数会打开一个文件并返回包装了该文件的 File 值。 然而，该函数只能以只读模式打开文件。换句话说，我们只能从该函数返回的 File 值中读取内容，而不能向它写入任何内容。

func OpenFile(name string, flag	int, perm unit32)  (file *File, err Error)
//返回 File 的内存地址, 错误信息, 通过 os 库调用

这个函数其实是 os.Create 函数和 os.Open 函数的底层支持，它最为灵活。这个函数有 3 个参数，分别名为 name、flag 和 perm 。其中的 name 指代的就是文件的路径。而 flag 参数指的则是需要施加在文件描述符之上的模式，我在前面提到的只读模式就是这里的一个可选项。

在 Go 语言中，这个只读模式由常量 os.O_RDONLY 代表，它是 int 类型的。当然了，这里除了只读模式之外，还有几个别的模式可选。

3. 写入文件

//写入一个 slice, 返回写的个数, 错误信息, 通过 File 的内存地址调用
func (file	*File).Write(b []byte)  (n int, err Error)

//从 slice 的某个位置开始写入, 返回写的个数, 错误信息,通过 File 的内存地址调用
func (file	*File).WriteAt(b []byte, off int64) (n int, err Error)

//写入一个字符串, 返回写的个数, 错误信息, 通过 File 的内存地址调用
func (file	*File).WriteString(s string) (ret int, err Error)

4. 读取文件

//读取一个 slice, 返回读的个数, 错误信息, 通过 File 的内存地址调用
func (file	*File).Read(b []byte) (n int, err Error)

//从 slice 的某个位置开始读取, 返回读到的个数, 错误信息, 通过 File 的内存地址调用
func (file	*File).ReadAt(b	[]byte, off	int64) (n int, err Error)

4. 删除文件

//传入文件的路径来删除文件，返回错误个数
func Remove(name string)	Error

5. 关闭文件

func (f *File) Close() error

6. 使用示例

package main

import (
	"fmt"
	"os"
)

func main() {
	fileName := "/home/wohu/gocode/src/test.txt"
	writeFile(fileName)
	readFile(fileName)

}

func writeFile(fileName string) {
	file, err := os.Create(fileName)

	if err != nil {
		fmt.Println(err)
		return
	}

	for i := 0; i <= 5; i++ {
		outStr := fmt.Sprintf("%s:%d\n", "hello, world", i)

		file.WriteString(outStr)
		file.Write([]byte("abcd\n"))

	}

	file.Close()
}

func readFile(fileName string) {
	file, err := os.Open(fileName)
	if err != nil {
		fmt.Println(err)
		return
	}
	defer file.Close()

	buf := make([]byte, 1024)

	for {
		n, _ := file.Read(buf)

		if n == 0 {
			//0	表示到达EOF
			break
		}
		os.Stdout.Write(buf)
	}
}

输出结果：

wohu@wohu:~/gocode/src$ ls
github.com  golang.org  hello.go  test.txt
wohu@wohu:~/gocode/src$ cat test.txt 
hello, world:0
abcd
hello, world:1
abcd
hello, world:2
abcd
hello, world:3
abcd
hello, world:4
abcd
hello, world:5
abcd
wohu@wohu:~/gocode/src$