Go语言中文件操作的完全指南:创建和打开技巧

发表时间: 2024-05-23 20:29

在任何计算机设备中, 文件是都是必须的对象, 而在Web编程中,文件的操作一直是Web程序员经常遇到的问题, 文件操作在Web应用中是必须的, 非常有用的, 我们经常遇到生成文件目录, 文件(夹)编辑等操作,

现在我把Go中的这些操作做一详细总结并实例示范如何使用。

目录操作

文件操作的大多数函数都是在os包里面, 下面列举了几个目录操作的:

func Mkdir(name string, perm FileMode) error

创建名称为name的目录, 权限设置是perm, 例如0777

func MkdirAll(path string, perm FileMode) error

根据path创建多级子目录, 例如astaxie/test1/test2。

func Remove(name string) error

删除名称为name的目录, 当目录下有文件或者其他目录是会出错

func RemoveAll(path string) error

根据path删除多级子目录, 如果path是单个名称, 那么该目录下的子目录全部删除。

package main //必须有个main包import (    "fmt"    "os")func main() {    err1 := os.Mkdir("parent", 0777)    err2 := os.MkdirAll("parent/children", 0777)    if err1 != nil {    		fmt.Println("Mkdir err:", err1) //执行第二次: err, Mkdir err: mkdir parent: Cannot create a file when that file already exists.    }    if err2 != nil {    		fmt.Println("MkdirAll err:", err2)    }    /*    err3 := os.Remove("parent")    if err3 != nil {    fmt.Println("Remove err:", err3) //Remove err: remove parent: The directory is not empty.    }    */    err3 := os.RemoveAll("parent")    if err3 != nil {    		fmt.Println("RemoveAll err:", err3)    }}

文件操作

建立与打开文件

新建文件可以通过如下两个方法

func Create(name string) (file *File, err Error)

根据提供的文件名创建新的文件, 返回一个文件对象, 默认权限是0666的文件, 返回的文件对象是可读写的。

func NewFile(fd uintptr, name string) *File

根据文件描述符创建相应的文件, 返回一个文件对象

通过如下两个方法来打开文件:

func Open(name string) (file *File, err Error)

该方法打开一个名称为name的文件, 但是是只读方式, 内部实现其实调用了OpenFile。

func OpenFile(name string, flag int, perm uint32) (file *File, err Error)

打开名称为name的文件, flag是打开的方式, 只读、读写等, perm是权限

flag可用参数如下:

const (O_RDONLY int = syscall.O_RDONLY // 只读模式打开文件O_WRONLY int = syscall.O_WRONLY // 只写模式打开文件O_RDWR int = syscall.O_RDWR // 读写模式打开文件O_APPEND int = syscall.O_APPEND // 写操作时将数据附加到文件尾部O_CREATE int = syscall.O_CREAT // 如果不存在将创建一个新文件O_EXCL int = syscall.O_EXCL // 和O_CREATE配合使用,文件必须不存在O_SYNC int = syscall.O_SYNC // 打开文件用于同步I/OO_TRUNC int = syscall.O_TRUNC // 如果可能,打开时清空文件)

写文件

写文件函数:

func (file *File) Write(b []byte) (n int, err Error)

写入byte类型的信息到文件

func (file *File) WriteAt(b []byte, off int64) (n int, err Error)

在指定位置开始写入byte类型的信息

func (file *File) WriteString(s string) (ret int, err Error)

写入string信息到文件

【实例】

package main //必须有个main包import (    "fmt"    "os")func main() {    //fout, err := os.Create("./xxx.txt") //新建文件    fout, err := os.OpenFile("./xxx.txt", os.O_CREATE, 0666) // 如果不存在将创建一个新文件    if err != nil {        fmt.Println(err)        return    }    defer fout.Close()    for i := 0; i < 5; i++ {        outstr := fmt.Sprintf("%s:%d\n", "Hello go", i)        fout.WriteString(outstr) //追加写        fout.Write([]byte("abcd\n"))    }}

读文件

读文件函数:

func (file *File) Read(b []byte) (n int, err Error)

读取数据到b中

Read方法从f中读取最多len(b)字节数据并写入b。它返回读取的字节数和可能遇到的任何错误。文件终止标志是读取0个字节且返回值err为io.EOF。

func (file *File) ReadAt(b []byte, off int64) (n int, err Error)

从off开始读取数据到b中, off一般传递len(b)

package main //必须有个main包import (    "fmt"    "os")func main() {    fin, err := os.Open("./xxx.txt") //打开文件    if err != nil {        fmt.Println(err)    }    defer fin.Close()    buf := make([]byte, 1024) //开辟1024个字节的slice作为缓冲    for {        n, _ := fin.Read(buf) //读文件        if n == 0 {        break    }    fmt.Println(string(buf)) //输出读取的内容    }}

删除文件

Go语言里面删除文件和删除文件夹是同一个函数

func Remove(name string) Error

调用该函数就可以删除文件名为name的文件

package main //必须有个main包import (    "fmt"    "os")func main() {    err := os.Remove("./xxx.txt")    if err != nil {    fmt.Println("删除失败")    }}

【案例】:拷贝文件

package main //必须有个main包import (    "fmt"    "io"    "os")func main() {    args := os.Args //获取用户输入的所有参数    //如果用户没有输入, 或参数个数不够, 则调用该函数提示用户    if args == nil || len(args) != 3 {    fmt.Println("useage : xxx srcFile dstFile", len(args))    return    }    srcPath := args[1] //获取输入的第一个参数    dstPath := args[2] //获取输入的第二个参数    fmt.Printf("srcPath = %s, dstPath = %s\n", srcPath, dstPath)    if srcPath == dstPath {    fmt.Println("源文件和目的文件名字不能相同")    return    }    srcFile, err1 := os.Open(srcPath) //打开源文件    if err1 != nil {    fmt.Println(err1)    return    }    dstFile, err2 := os.Create(dstPath) //创建目的文件    if err2 != nil {    fmt.Println(err2)    return    }    buf := make([]byte, 1024) //切片缓冲区    for {    //从源文件读取内容, n为读取文件内容的长度    n, err := srcFile.Read(buf)    if err != nil && err != io.EOF { //EOF: end of file 读取到文件的末尾    fmt.Println(err)    break    }    if n == 0 {    fmt.Println("文件处理完毕")    break    }    //切片读取    tmp := buf[:n]    //把读取的内容写入到目的文件    dstFile.Write(tmp)    }    srcFile.Close()		dstFile.Close()}

使用方法

> go build copy.go> copy xxx.mp4 yyy.mp4

显示状态:

srcPath = xxx.mp4, dstPath = yyy.mp4

文件处理完毕

注意:路径可以是相对路径, 也可以是绝对路径

var EOF = errors.New("EOF")

EOF当无法得到更多输入时, Read方法返回EOF。当函数一切正常的到达输入的结束时, 就应返回EOF。

如果在一个结构化数据流中EOF在不期望的位置出现了, 则应返回错误ErrUnexpectedEOF或者其它给出更多细节的错误。

io.EOF变量正是由errors.New函数的结果值来初始化的。EOF是文件结束符(End Of File)的缩写。对于文件读取操作来说, 它意味着读取器已经读到了文件的末尾。

因此, 严格来说, EOF并不应该算作一个真正的错误, 而仅仅属于一种"错误信号"。