learn-tech/专栏/Go语言核心36讲/44使用os包中的API(上).md
2024-10-16 00:01:16 +08:00

132 lines
9.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

因收到Google相关通知网站将会择期关闭。相关通知内容
44 使用os包中的API (上)
我们今天要讲的是os代码包中的API。这个代码包可以让我们拥有操控计算机操作系统的能力。
前导内容os包中的API
这个代码包提供的都是平台不相关的API。那么说什么叫平台不相关的API呢
它的意思是这些API基于或者说抽象自操作系统为我们使用操作系统的功能提供高层次的支持但是它们并不依赖于具体的操作系统。
不论是Linux、macOS、Windows还是FreeBSD、OpenBSD、Plan9os代码包都可以为之提供统一的使用接口。这使得我们可以用同样的方式来操纵不同的操作系统并得到相似的结果。
os包中的API主要可以帮助我们使用操作系统中的文件系统、权限系统、环境变量、系统进程以及系统信号。
其中操纵文件系统的API最为丰富。我们不但可以利用这些API创建和删除文件以及目录还可以获取到它们的各种信息、修改它们的内容、改变它们的访问权限等等。
说到这里就不得不提及一个非常常用的数据类型os.File。
从字面上来看os.File类型代表了操作系统中的文件。但实际上它可以代表的远不止于此。或许你已经知道对于类Unix的操作系统包括Linux、macOS、FreeBSD等其中的一切都可以被看做是文件。
除了文本文件、二进制文件、压缩文件、目录这些常见的形式之外还有符号链接、各种物理设备包括内置或外接的面向块或者字符的设备、命名管道以及套接字也就是socket等等。
因此可以说我们能够利用os.File类型操纵的东西太多了。不过为了聚焦于os.File本身同时也为了让本文讲述的内容更加通用我们在这里主要把os.File类型应用于常规的文件。
下面这个问题就是以os.File类型代表的最基本内容入手。我们今天的问题是os.File类型都实现了哪些io包中的接口
这道题的典型回答是这样的。
os.File类型拥有的都是指针方法所以除了空接口之外它本身没有实现任何接口。而它的指针类型则实现了很多io代码包中的接口。
首先对于io包中最核心的3个简单接口io.Reader、io.Writer和io.Closer*os.File类型都实现了它们。
其次该类型还实现了另外的3个简单接口io.ReaderAt、io.Seeker和io.WriterAt。
正是因为*os.File类型实现了这些简单接口所以它也顺便实现了io包的9个扩展接口中的7个。
然而由于它并没有实现简单接口io.ByteReader和io.RuneReader所以它没有实现分别作为这两者的扩展接口的io.ByteScanner和io.RuneScanner。
总之os.File类型及其指针类型的值不但可以通过各种方式读取和写入某个文件中的内容还可以寻找并设定下一次读取或写入时的起始索引位置另外还可以随时对文件进行关闭。
但是它们并不能专门地读取文件中的下一个字节或者下一个Unicode字符也不能进行任何的读回退操作。
不过单独读取下一个字节或字符的功能也可以通过其他方式来实现比如调用它的Read方法并传入适当的参数值就可以做到这一点。
问题解析
这个问题其实在间接地问“os.File类型能够以何种方式操作文件”我在前面的典型回答中也给出了简要的答案。
在我进一步地说明一些细节之前我们先来看看怎样才能获得一个os.File类型的指针值以下简称File值
在os包中有这样几个函数Create、NewFile、Open和OpenFile。
os.Create函数用于根据给定的路径创建一个新的文件。 它会返回一个File值和一个错误值。我们可以在该函数返回的File值之上对相应的文件进行读操作和写操作。
不但如此,我们使用这个函数创建的文件,对于操作系统中的所有用户来说,都是可以读和写的。
换句话说,一旦这样的文件被创建出来,任何能够登录其所属的操作系统的用户,都可以在任意时刻读取该文件中的内容,或者向该文件写入内容。
注意如果在我们给予os.Create函数的路径之上已经存在了一个文件那么该函数会先清空现有文件中的全部内容然后再把它作为第一个结果值返回。
另外os.Create函数是有可能返回非nil的错误值的。
比如,如果我们给定的路径上的某一级父目录并不存在,那么该函数就会返回一个*os.PathError类型的错误值以表示“不存在的文件或目录”。
再来看os.NewFile函数。 该函数在被调用的时候需要接受一个代表文件描述符的、uintptr类型的值以及一个用于表示文件名的字符串值。
如果我们给定的文件描述符并不是有效的那么这个函数将会返回nil否则它将会返回一个代表了相应文件的File值。
注意不要被这个函数的名称误导了它的功能并不是创建一个新的文件而是依据一个已经存在的文件的描述符来新建一个包装了该文件的File值。
例如我们可以像这样拿到一个包装了标准错误输出的File值
file3 := os.NewFile(uintptr(syscall.Stderr), "/dev/stderr")
然后通过这个File值向标准错误输出上写入一些内容
if file3 != nil {
defer file3.Close()
file3.WriteString(
"The Go language program writes the contents into stderr.\n")
}
os.Open函数会打开一个文件并返回包装了该文件的File值。 然而该函数只能以只读模式打开文件。换句话说我们只能从该函数返回的File值中读取内容而不能向它写入任何内容。
如果我们调用了这个File值的任何一个写入方法那么都将会得到一个表示了“坏的文件描述符”的错误值。实际上我们刚刚说的只读模式正是应用在File值所持有的文件描述符之上的。
所谓的文件描述符是由通常很小的非负整数代表的。它一般会由I/O相关的系统调用返回并作为某个文件的一个标识存在。
从操作系统的层面看针对任何文件的I/O操作都需要用到这个文件描述符。只不过Go语言中的一些数据类型为我们隐匿掉了这个描述符如此一来我们就无需时刻关注和辨别它了就像os.File类型这样
实际上我们在调用前文所述的os.Create函数、os.Open函数以及将会提到的os.OpenFile函数的时候它们都会执行同一个系统调用并且在成功之后得到这样一个文件描述符。这个文件描述符将会被储存在它们返回的File值中。
os.File类型有一个指针方法名叫Fd。它在被调用之后将会返回一个uintptr类型的值。这个值就代表了当前的File值所持有的那个文件描述符。
不过在os包中除了NewFile函数需要用到它它也没有什么别的用武之地了。所以如果你操作的只是常规的文件或者目录那么就无需特别地在意它了。
最后再说一下os.OpenFile函数。 这个函数其实是os.Create函数和os.Open函数的底层支持它最为灵活。
这个函数有3个参数分别名为name、flag和perm。其中的name指代的就是文件的路径。而flag参数指的则是需要施加在文件描述符之上的模式我在前面提到的只读模式就是这里的一个可选项。
在Go语言中这个只读模式由常量os.O_RDONLY代表它是int类型的。当然了这里除了只读模式之外还有几个别的模式可选我们稍后再细说。
os.OpenFile函数的参数perm代表的也是模式它的类型是os.FileMode此类型是一个基于uint32类型的再定义类型。
为了加以区别我们把参数flag指代的模式叫做操作模式而把参数perm指代的模式叫做权限模式。可以这么说操作模式限定了操作文件的方式而权限模式则可以控制文件的访问权限。关于权限模式的更多细节我们将在后面讨论。
-
获得os.File类型的指针值的几种方式
到这里你需要记住的是通过os.File类型的值我们不但可以对文件进行读取、写入、关闭等操作还可以设定下一次读取或写入时的起始索引位置。
此外os包中还有用于创建全新文件的Create函数用于包装现存文件的NewFile函数以及可被用来打开已存在的文件的Open函数和OpenFile函数。
总结
我们今天讲的是os代码包以及其中的程序实体。我们首先讨论了os包存在的意义和它的主要用途。代码包中所包含的API都是对操作系统的某方面功能的高层次抽象这使得我们可以通过它以统一的方式操纵不同的操作系统并得到相似的结果。
在这个代码包中操纵文件系统的API最为丰富最有代表性的就是数据类型os.File。os.File类型不但可以代表操作系统中的文件还可以代表很多其他的东西。尤其是在类Unix的操作系统中它几乎可以代表一切可以操纵的软件和硬件。
在下一期的文章中我会继续讲解os包中的API的内容。如果你对这部分的知识有什么问题可以给我留言感谢你的收听我们下期再见。
戳此查看Go语言专栏文章配套详细代码。