专业编程基础技术教程

网站首页 > 基础教程 正文

golang 文件操作-创建与打开汇总

ccvgpt 2024-08-10 12:45:06 基础教程 10 ℃

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

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

golang 文件操作-创建与打开汇总

目录操作

文件操作的大多数函数都是在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/O
O_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并不应该算作一个真正的错误, 而仅仅属于一种"错误信号"。

Tags:

最近发表
标签列表