Golang os包下常用的文件相关操作

╰+攻爆jí腚メ 2022-01-31 05:47 479阅读 0赞

一、文件操作的相关方法

// File represents an open file descriptor.
    type File struct {
        *file // os specific
    }

File表示打开的文件描述符

操作File的常用函数：

1.Create函数

func Create(name string) (\*File, error) \{

return OpenFile(name, O\_RDWR|O\_CREATE|O\_TRUNC, 0666)

功能：创建一个文件，文件的mode为0666(读写权限)，如果文件已存在，则重新创建一个，原文件被覆盖(内容会被清空)，创建的新文件具有读写权限，实现是调用OpenFile来创建文件的。

2.NewFile函数

func NewFile(fd uintptr, name string) \*File

功能：根据文件描述符和名字创建一个新的文件

Stdin  = NewFile(uintptr(syscall.Stdin), "/dev/stdin")

Stdout = NewFile(uintptr(syscall.Stdout), "/dev/stdout")

Stderr = NewFile(uintptr(syscall.Stderr), "/dev/stderr")

3.OpenFile函数

func OpenFile(name string, flag int, perm FileMode) (\*File, error)

功能：按指定文件权限和打开方式打开文件或者创建文件，其中flag标志如下

O\_RDONLY：只读模式(read-only)

O\_WRONLY：只写模式(write-only)

O\_RDWR：读写模式(read-write)

//以上三种模式必须指定一个

O\_APPEND：追加模式(append)

O\_CREATE：文件不存在就创建(create a new file if none exists.)

O\_EXCL：与 O\_CREATE 一起用，构成一个新建文件的功能，它要求文件必须不存在(used with O\_CREATE, file must not exist)

O\_SYNC：同步方式打开，即不使用缓存，直接写入硬盘

O\_TRUNC：打开并清空文件

至于操作权限perm，除非创建文件时才需要指定，不需要创建新文件时可以将其设定为０.虽然go语言给perm权限设定了很多的常量，但是习惯上也可以直接使用数字，如0666(具体含义和Unix系统的一致).

4.Open函数

func Open(name string) (\*File, error)

功能：打开一个文件，返回文件描述符，该文件描述符只有只读权限．他相当于OpenFile(name string,O\_RDWR,0)

5.Pipe函数

func Pipe() (r \*File, w \*File, err error)

功能：返回一对连接的文件，从r中读取写入w中的数据，即首先向w中写入数据，此时从r中变能够读取到写入w中的数据，Pipe()函数返回文件和该过程中产生的错误．

示例：

func main() {
           r,w,_ := os.Pipe()
           w.Write([]byte("Hello Pipe!"))
    
           bs := make([]byte,20)
           n,err := r.Read(bs)
           if err != nil {
               log.Fatal(err)
           }
    
           fmt.Println(string(bs[:n]))  //打印结果： Hello Pipe!
    
    }

6. Chdir函数

func Chdir(dir string) error

7. Getwd函数

func Getwd() (dir string, err error)

功能：获取当前目录，类似linux中的pwd。

8. Chmod函数

func Chmod(name string, mode FileMode) error

功能：更改文件的权限（读写执行，分为三类：all-group-owner）

9. Chown函数

func Chown(name string, uid, gid int) error

功能：更改文件拥有者owner

10. Chtimes函数

func Chtimes(name string, atime time.Time, mtime time.Time) error

功能：更改文件的访问时间和修改时间，atime表示访问时间，mtime表示更改时间

11. Rename函数

func Rename(oldpath, newpath string) error

功能：用于修改文件夹或文件名的名称

12. Mkdir函数

func Mkdir(name string, perm FileMode) error

功能：用于创建指定权限的文件夹，只能创建一级目录。

注意：当该文件夹已经存在时，会返回error(Cannot create a file when that file already exists.)

13. MkdirAll函数

func MkdirAll(path string, perm FileMode) error

功能：用于递归创建文件目录，可以创建多级目录。

func main() {
           dir,err := os.Getwd()
           if err != nil {
               log.Fatal(err)
           }
    
    
           fmt.Println("current directory:",dir)
           err = os.Mkdir(dir +"/ccc",0555)
           if err != nil {
               log.Fatal("Mkdir error:",err)
           }
    
    
           err = os.MkdirAll(dir +"/ccc/ddd/eee/fff",0555)
           if err != nil {
               log.Fatal("MkdirAll error:",err)
           }
    }

14. Remove函数

func Remove(name string) error

功能：用于删除文件或目录(该文件或目录只能是最后一级)

比如说: /home/test/aaa/bbb/ccc，只能删除最后一级ccc目录，不能直接删除aaa的目录，如果需要删除多级目录，则使用RemoveAll函数。

15. RemoveAll函数

func RemoveAll(path string) error

功能：用于删除目录及它包含的所有子目录和文件。

16. IsExist函数

func IsExist(err error) bool

功能：返回一个布尔值，它指明err错误是否报告了一个文件或者目录已经存在。它被ErrExist和其它系统调用满足。

17. IsNotExist函数

func IsNotExist(err error) bool

功能：返回一个布尔值，它指明err错误是否报告了一个文件或者目录不存在。它被ErrNotExist 和其它系统调用满足。

18. IsPermission函数

func IsPermission(err error) bool

功能：判定err错误是否是权限错误。它被ErrPermission 和其它系统调用满足。

19. Lchown函数

func Lchown(name string, uid, gid int) error

功能：改变了文件的gid和uid。如果文件是一个符号链接，它改变的链接自己。如果出错，则会是\*PathError类型。

20. Link函数

func Link(oldname, newname string) error

功能：创建一个从oldname指向newname的硬连接，对一个进行操作，则另外一个也会被修改。

注意：newname必须是不存在的，负责会返回error（Cannot create a file when that file already exists.）

示例:

func main() {
    	dir,err := os.Getwd()
    	if err != nil {
    		log.Fatal(err)
    	}
    
    	dir1 := dir+"/ccc/a.go"  
    	dir2 := dir  +"/ccc/b.go"
    	err = os.Link(dir1,dir2)   //dir1必须存在，dir2必须是不存在的，负责会报错
    	if err != nil {
    		log.Fatal("create link error ",err)
    	}
    
    	fil1 ,err := os.OpenFile(dir1,os.O_RDWR|os.O_CREATE|os.O_APPEND,0555)
    	if err != nil {
    		log.Fatal("open file1 error  ",err)
    	}
    	fil2 ,err := os.OpenFile(dir2,os.O_RDWR,0555)
    	if err != nil {
    		log.Fatal("open file2 error  ",err)
    	}
    
    	fil1.WriteString(`
    package main
    import "fmt"
    
    func main(){
    	 fmt.Println("hello link")
    }
    `)
    
    
    	bytes := make([]byte,128)
    	n,err := fil2.Read(bytes)
    
    	if err != nil {
    		log.Fatal("read file2 error  ",err)
    	}
    
    	fmt.Println(string(bytes[:n]))
    }

21. Readlink函数

func Readlink(name string) (string, error)

功能：返回符号链接的目标。如果出错，将会是 \*PathError类型。

22. Symlink函数

func Symlink(oldname, newname string) error

功能：创建一个newname作为oldname的符号连接，这是一个符号连接（软连接），与Link的硬连接不同，利用Link创建的硬连接，则newname和oldname的file互不影响，一个文件删除，另外一个文件不受影响；但是利用SymLink创建的符号连接，其newname只是一个指向oldname文件的符号连接，当oldname　file删除之后，则newname的文件也就不能够继续使用。

23. TempDir函数

func TempDir() string

功能：创建临时目录用来存放临时文件，这个临时目录一般为/tmp

24. Truncate函数

func Truncate(name string, size int64) error

功能：按照指定长度size将文件截断，如果这个文件是一个符号链接，则同时也改变其目标连接的长度，如果有错误，则返回一个错误。

二、File对象的常用方法：

1. Chdir方法

func (f \*File) Chdir() error

功能：改变工作目录到f，其中f必须为一个目录，否则便会报错。目前不支持windows系统，如果windows系统下可用os.Chdir()函数来改变工作目录。

示例：

func main() {
       dir, _ := os.Getwd()
       fmt.Println(dir)
       f, _ := os.Open("tmp.txt")
       err := f.Chdir()
       if err != nil {
          fmt.Println(err) //chdir tmp.txt: not a directory，因为tmp.txt不是目录，所以报错
       }
       f, _ = os.Open("develop")
       err = f.Chdir()
       if err != nil {
          fmt.Println(err)
       }
       dir1, _ := os.Getwd()
       fmt.Println(dir1) //home/work/develop，因为develop是工作目录，所以切换到该目录
    }

2. Chmod 方法

func (f \*File) Chmod(mode FileMode) error

功能：更改文件权限，其等价与os.Chmod(name string,mode FileMode)error

3. Chown方法

func (f \*File) Chown(uid, gid int) error

功能：更改文件所有者，与os.Chown等价

4.Close方法

func (f \*File) Close() error

功能：关闭文件，使其不能够再进行i/o操作，其经常和defer一起使用，用在创建或者打开某个文件之后，这样在程序退出前变能够自己关闭响应的已经打开的文件。

5.Fd方法

func (file \*File) Fd() uintptr

功能：返回系统文件描述符，也叫做文件句柄。

6.Name方法

func (f \*File) Name() string

功能：返回文件名字，与file.Stat().Name()等价

7.Read方法

func (f \*File) Read(b \[\]byte) (n int, err error)

功能：读取文件中的内容到b中，n是读取的字节数

如果len(b) 大于文件中可读的字节数，则可以读取文件的全部内容，n是文件中的字节数

如果len(b)小于文件中可读的字节数，则只读取文件中的前len(b)个字节（即把len(b)个字节从f中读取到b中）。

8.ReadAt方法

func (f \*File) ReadAt(b \[\]byte, off int64) (n int, err error)

功能：和Read类似，不过ReadAt指定开始读取的位置offset

9.Seek方法

func (f \*File) Seek(offset int64, whence int) (ret int64, err error)

功能：Seek设置下一个读或写操作的偏移量offset，根据whence来解析，whence可以理解为参考标准，0意味着相对于文件的原始位置，1意味着相对于当前偏移量，2意味着相对于文件结尾。它返回新的偏移量和错误（如果存在）。whence的定义如下(io包下)

const (

SeekStart   = 0 // seek relative to the origin of the file

SeekCurrent = 1 // seek relative to the current offset

SeekEnd     = 2 // seek relative to the end

)

示例：

func main() {
         s := make([]byte, 10)
         file, _ := os.Open("tmp.txt")
         defer file.Close()
         file.Seek(-12, 2)   //从离最后位置12的地方开始
         n, _ := file.Read(s)
         fmt.Println(string(s[:n]))
    
    }

10.Readdir 方法

func (f \*File) Readdir(n int) (\[\]FileInfo, error)

功能：读取指定目录f下的所有内容，如果f是文件，则会返回The system cannot find the file specified.的错误。

当n> 0, Readdir返回最多n个FileInfo结构。

当n <= 0,Readdir返回该目录下所有文件或目录的FileInfo信息。

示例：读取当前目录下的所有文件或目录，并控制台打印名称

func main() \{

curPwd,\_ := os.Getwd()

dirOp,err  := os.Open(curPwd)

if err != nil \{

log.Fatal(err)

defer dirOp.Close()

list,err := dirOp.Readdir(-1)

if err != nil \{

log.Fatal(err)

for i := range list \{

fmt.Println(list\[i\].Name())

11. Readdirnames方法

func (f \*File) Readdirnames(n int) (names \[\]string, err error)

功能：

读取并返回目录f里面的文件(或文件夹)的名称列表

如果n>0，Readdirnames返回最多n个名字。

如果n<0，Readdirnames返回目录下所有的文件的名字，用一个切片表示。

示例：获取并打印输出当前目录下的文件名称

func main() {
           curPwd,_ := os.Getwd()
           dirOp,err  := os.Open(curPwd)
           if err != nil {
                log.Fatal(err)
           }
    
    
           defer dirOp.Close()
    
    
           dirList ,err := dirOp.Readdirnames(-1)
           if err != nil {
                  log.Fatal(err)
           }
    
           fmt.Println(dirList)
    
    }

12. Stat方法

func (f \*File) Stat() (fi FileInfo, err error)

功能：返回文件描述相关信息，包括大小，名字等。等价于os.Stat(filename string)

13. Sync方法

func (f \*File) Sync() (err error)

功能：同步操作，将当前存在内存中的文件内容写入硬盘。

14. Truncate方法

func (f \*File) Truncate(size int64) error

功能：类似  os.Truncate(name, size),将文件进行截断。

15. Write方法

func (f \*File) Write(b \[\]byte) (n int, err error)

功能：将b中的数据写入f文件

16. WriteAt方法

func (f \*File) WriteAt(b \[\]byte, off int64) (n int, err error)

功能：将b中数据写入f文件中，写入时从offset位置开始进行写入操作

17. WriteString方法

func (f \*File) WriteString(s string) (ret int, err error)

功能：将字符串s写入文件中

示例：上面几个方法的小demo

func main() {
           file, _ := os.OpenFile("tmp.txt",os.O_RDWR|os.O_CREATE,0666)
           file.Write([]byte("abc!"))
           file.WriteString("hello os!")
    
    
           fileInfo,err := file.Stat()
    
           if err != nil {
                log.Fatal(err)
           }
           fmt.Println("file size:",fileInfo.Size())
           file.Seek(0,io.SeekStart)   //file指针指向文件开始位置
           b := make([]byte,100)
    
           n,err := file.Read(b)
           if err != nil {
                log.Fatal(err)
           }
    
    
           fmt.Printf("read file size:%d,content:%s\n",n,string(b[:n]))
    
    }

注意：调用Write相关的方法向文件中写入数据时，一定要注意是否有写权限，如果用Open打开则是只读权限。

三、文件信息相关操作：

type FileInfo interface \{

Name() string  // base name of the file  文件名称

Size() int64  // length in bytes for regular files; system-dependent for others 文件大小

Mode() FileMode     // file mode bits  文件权限

ModTime() time.Time // modification time  文件更改时间

IsDir() bool        // abbreviation for Mode().IsDir() 文件是否为目录

Sys() interface\{\}   // underlying data source (can return nil)  基础数据源

FileInfo用来描述一个文件的相关信息，当调用Stat和Lstat函数时，会获取到该文件信息FileInfo。

1.Stat函数

func Stat(name string) (FileInfo, error)

功能：返回描述文件的FileInfo信息。如果出错，将是 \*PathError类型。

2. Lstat函数

func Lstat(name string) (FileInfo, error)

功能：返回描述文件的FileInfo信息。如果文件是符号链接，返回的FileInfo描述的符号链接。Lstat不会试着去追溯link。如果出错，将是 \*PathError类型。

示例：

func main() {
    
           ls,err := os.Lstat("tmp.txt")
    
           if err != nil {
    
                  log.Fatal(err)
    
           }
    
           s,err := os.Stat("tmp.txt")
    
           if err != nil {
    
                  log.Fatal(err)
    
           }
    
    
    
           fmt.Printf("name:%s,size:%d\n",ls.Name(),ls.Size())
    
           fmt.Printf("name:%s,size:%d\n",s.Name(),s.Size())
    
    }

FileMode文件的模式和权限

type FileMode uint32

const (

// The single letters are the abbreviations

// used by the String method's formatting.

ModeDir        FileMode = 1 << (32 - 1 - iota) // d: is a directory

ModeAppend                                     // a: append-only

ModeExclusive                                  // l: exclusive use

ModeTemporary                                  // T: temporary file; Plan 9 only

ModeSymlink                                    // L: symbolic link

ModeDevice                                     // D: device file

ModeNamedPipe                                  // p: named pipe (FIFO)

ModeSocket                                     // S: Unix domain socket

ModeSetuid                                     // u: setuid

ModeSetgid                                     // g: setgid

ModeCharDevice                                 // c: Unix character device, when ModeDevice is set

ModeSticky                                     // t: sticky

// Mask for the type bits. For regular files, none will be set.

ModeType = ModeDir | ModeSymlink | ModeNamedPipe | ModeSocket | ModeDevice

ModePerm FileMode = 0777 // Unix permission bits

)

所定义的文件标志位最重要的位是FileMode。9个次重要的位是标准Unix rwxrwxrwx权限。这些位的值应该被认为公开API的一部分，可能用于连接协议或磁盘表示：它们必须不能被改变，尽管新的标志位有可能增加。

FileModel的方法主要用来进行判断和输出权限

1. IsDir方法

func (m FileMode) IsDir() bool

功能：判断m是否是目录，也就是检查文件是否有设置的ModeDir位

2. IsRegular方法

func (m FileMode) IsRegular() bool

功能：判断m是否是普通文件，也就是说检查m中是否有设置mode type

3. Perm方法

func (m FileMode) Perm() FileMode

功能：返回m的权限位

4.String方法

func (m FileMode) String() string

功能：返回m的字符串表示

示例：

func main() {
    
           s,err := os.Stat("tmp.txt")
    
           if err != nil {
    
                  log.Fatal(err)
    
           }
    
    
    
           fm := s.Mode()
    
           fmt.Println(fm.IsDir())    //false
    
           fmt.Println(fm.IsRegular())  //true
    
               fmt.Println(fm.Perm())  //-rw-rw-rw-
    
               fmt.Println(fm.String())  //-rw-rw-rw-
    
    }

参考地址：

[https://blog.csdn.net/chenbaoke/article/details/42494851?utm\_campaign=studygolang.com&utm\_medium=studygolang.com&utm\_source=studygolang.com][https_blog.csdn.net_chenbaoke_article_details_42494851_utm_campaign_studygolang.com_utm_medium_studygolang.com_utm_source_studygolang.com]

[https_blog.csdn.net_chenbaoke_article_details_42494851_utm_campaign_studygolang.com_utm_medium_studygolang.com_utm_source_studygolang.com]: https://blog.csdn.net/chenbaoke/article/details/42494851?utm_campaign=studygolang.com&utm_medium=studygolang.com&utm_source=studygolang.com