fs - 文件系统 - 天天看点

<code> fs</code> 模块提供了一些 API，用于以一种类似标准 POSIX 函数的方式与文件系统进行交互。

用法如下：

<col>

<code>异步形式的最后一个参数都是完成时回调函数。传给回调函数的参数取决于具体方法，但回调函数的第一个参数都会保留给异常。如果操作成功完成，则第一个参数会是 null 或 undefined。</code>

当使用同步操作时，任何异常都会被立即抛出，可以使用 <code>try</code>/<code>catch</code> 来处理异常，或让异常向上冒泡。

大部分 <code>fs</code> 操作接受字符串、<code>Buffer</code>、或使用 <code>file:</code> 协议的 <code>URL</code> 对象作为文件路径。

字符串形式的路径会被解释为表示绝对路径或相对路径的 UTF-8 字符序列。相对路径会相对于 <code>process.cwd()</code> 定义的当前工作目录进行处理。

使用绝对路径的例子：

使用 <code>Buffer</code> 定义的路径主要用于将文件路径处理为 opaque 字节序列的特定 POSIX 操作系统。在这种系统上，一个文件路径可能包含使用多种字符编码的子序列。与字符串路径一样，<code>Buffer</code> 路径也可以是相对的或绝对的。

对于大多数 <code>fs</code> 模块的函数，<code>path</code> 或 <code>filename</code> 参数可以传入 WHATWG URL 对象。只支持使用 <code>file:</code> 协议的 URL 对象。

<code>file:</code> URL 必须是绝对路径。

在 POSIX 系统，内核为所有进程维护着一张当前打开着的文件与资源的表格。每个打开的文件都会分配一个名为文件描述符的数值标识。在系统层，所有文件系统操作使用这些文件描述符来识别与追踪每个特定的文件。 Window 系统使用了一个不同但概念类似的机制来追踪资源。为方便用户，Node.js 抽象了不同操作系统间的差异，为所有打开的文件分配了数值的文件描述符。

<code>fs.open()</code> 方法用于分配一个新的文件描述符。一旦分配了，文件描述符可用于读取数据、写入数据、或查看文件信息。

<code>注意：大多数操作系统会限制打开的文件描述符的数量，所以当操作完成时需关闭描述符。如果不这样做会导致内存泄漏，最终造成应用奔溃。</code>

略过。

<code>fs.Stats</code> 对象提供了一个文件的信息。

从 <code>fs.stat()</code>、<code>fs.lstat()</code> 和 <code>fs.fstat()</code> 及其同步版本返回的对象都是该类型。

返回的信息包含如下：

stats.isDirectory() 如果 <code>fs.Stats</code> 对象表示一个文件系统目录，则返回 <code>true</code> 。

stats.isFile() 如果 <code>fs.Stats</code> 对象表示一个普通文件，则返回 <code>true</code> 。

stats.size 文件的字节大小。

<code>file</code> <string> | <Buffer> | <URL> | <number> 文件名或文件描述符

<code>options</code><Object> | <string>

<code>encoding</code><string> | <null> 默认为 <code>'utf8'</code>

<code>callback</code><Function>

异步地追加数据到一个文件，如果文件不存在则创建文件。 <code>data</code> 可以是一个字符串或 <code>Buffer</code>。

如果 <code>options</code> 是一个字符串，则它指定了字符编码。

<code>file</code> 可能是一个被打开用来追加数据的数字文件描述符（通过 <code>fs.open()</code> 或者 <code>fs.openSync()</code>）。这样的文件描述符将不会被自动关闭。

fs.chmod(path, mode, callback) 异步地改变文件的权限。完成回调只有一个可能的异常参数。

<code>callback</code> <Function>

<code>mode</code> 参数会在 <code>fs.chmod()</code> 和 <code>fs.chmodSync()</code>方法中用到，它是用下面的常量进行逻辑或(logical OR)操作后的数字掩码：

Constant

Octal

Description

<code>fs.constants.S_IRUSR</code>

read by owner

<code>fs.constants.S_IWUSR</code>

write by owner

<code>fs.constants.S_IXUSR</code>

execute/search by owner

<code>fs.constants.S_IRGRP</code>

read by group

<code>fs.constants.S_IWGRP</code>

write by group

<code>fs.constants.S_IXGRP</code>

execute/search by group

<code>fs.constants.S_IROTH</code>

read by others

<code>fs.constants.S_IWOTH</code>

write by others

<code>fs.constants.S_IXOTH</code>

execute/search by others

一个构造 <code>mode</code> 的更简单的方式是使用3位八进制串（比如，765）。最左侧的数字（例中的7）代表了文件所有者的权限。中间一位（例中的6）代表了组的权限。最右侧的数字（例中的5）代表其他人的权限。 A

Number

read, write, and execute

read and write

read and execute

read only

write and execute

write only

execute only

no permission

举个例子，八进制值 <code>0o765</code> 表示：

文件所有者可以进行读、写和执行。

文件所属组可以读和写。

其他人可以对文件进行读和执行。

异步的 <code>close(2)</code>。完成回调只有一个可能的异常参数。

<code>src</code><string> | <Buffer> | <URL> 要被拷贝的源文件名称

<code>dest</code><string> | <Buffer> | <URL> 拷贝操作的目标文件名

<code>flags</code><number> 拷贝操作修饰符默认:<code>0</code>

异步的将 <code>src</code> 拷贝到 <code>dest</code>。Asynchronously copies <code>src</code> to <code>dest</code>. 默认情况下，如果 <code>dest</code> 已经存在会被覆盖。回调函数没有给出除了异常以外的参数。Node.js 不能保证拷贝操作的原子性。如果目标文件打开后出现错误，Node.js 将尝试删除它。

<code>flags</code> 是一个可选的整数，用于指定行为的拷贝操作。唯一支持的 flag 是 <code>fs.constants.COPYFILE_EXCL</code> ，如果 <code>dest</code> 已经存在，则会导致拷贝操作失败。

fs.constants返回一个包含常用文件系统操作的常量的对象。

<code>options</code><string> | <Object>

<code>flags</code><string>

<code>encoding</code><string>

<code>autoClose</code><boolean>

<code>start</code><integer>

<code>highWaterMark</code><integer>

返回一个新建的 <code>ReadStream</code> 对象。

不同于在一个可读流上设置的 <code>highWaterMark</code> 默认值（16 kb），该方法在相同参数下返回的流具有 64 kb 的默认值。

<code>options</code> 是一个带有以下默认值的对象或字符串：

<code>options</code> 可以包括 <code>start</code> 和 <code>end</code> 值，使其可以从文件读取一定范围的字节而不是整个文件。 <code>start</code> 和 <code>end</code> 都是包括在内的，并且起始值是 0。如果指定了 <code>fd</code> 且 <code>start</code> 不传或为 <code>undefined</code>，则 <code>fs.createReadStream()</code> 从当前文件位置按顺序地读取。 <code>encoding</code> 可以是任何可以被 <code>Buffer</code> 接受的值。

如果指定了 <code>fd</code>，则 <code>ReadStream</code> 会忽略 <code>path</code> 参数并且会使用指定的文件描述符。这意味着不会触发 <code>'open'</code> 事件。注意，<code>fd</code> 应该是阻塞的；非阻塞的 <code>fd</code>们应该传给 <code>net.Socket</code>。

如果 <code>autoClose</code> 为 <code>false</code>，则文件描述符不会被关闭，即使有错误。应用程序需要负责关闭它，并且确保没有文件描述符泄漏。如果 <code>autoClose</code> 被设置为 <code>true</code>（默认），则在 <code>error</code> 或 <code>end</code> 时，文件描述符会被自动关闭。

<code>mode</code> 用于设置文件模式（权限和粘结位），但仅限创建文件时。

例子，从一个 100 字节长的文件中读取最后 10 个字节：

<code>options</code> <string> | <Object>

<code>flags</code> <string>

<code>encoding</code> <string>

<code>autoClose</code> <boolean>

<code>start</code> <integer>

返回一个新建的 <code>WriteStream</code> 对象（详见可写流）。

‘<code>options</code> 是一个带有以下默认值的对象或字符串：

<code>options</code> 也可以包括一个 <code>start</code> 选项，使其可以写入数据到文件某个位置。如果是修改一个文件而不是覆盖它，则需要<code>flags</code> 模式为 <code>r+</code> 而不是默认的 <code>w</code> 模式。

其它和fs.createReadStream(path[, options])类似。

<code>mode</code> <integer> Default: <code>0o777</code>

异步地创建目录。完成回调只有一个可能的异常参数。 <code>mode</code> 默认为 <code>0o777</code>。

<code>flags</code><string> | <number>

<code>mode</code><integer>Default:<code>0o666</code>

<code>callback</code><Function>

<code>flags</code> 可以是：

<code>'r'</code> - 以读取模式打开文件。如果文件不存在则发生异常。

<code>'r+'</code> - 以读写模式打开文件。如果文件不存在则发生异常。

<code>'rs+'</code> - 以同步读写模式打开文件。命令操作系统绕过本地文件系统缓存。

这对 NFS 挂载模式下打开文件很有用，因为它可以让你跳过潜在的旧本地缓存。它对 I/O 的性能有明显的影响，所以除非需要，否则不要使用此标志。

注意，这不会使 <code>fs.open()</code> 进入同步阻塞调用。如果那是你想要的，则应该使用 <code>fs.openSync()</code>。

<code>'w'</code> - 以写入模式打开文件。文件会被创建（如果文件不存在）或截断（如果文件存在）。

<code>'wx'</code> - 类似 <code>'w'</code>，但如果 <code>path</code> 存在，则失败。

<code>'w+'</code> - 以读写模式打开文件。文件会被创建（如果文件不存在）或截断（如果文件存在）。

<code>'wx+'</code> - 类似 <code>'w+'</code>，但如果 <code>path</code> 存在，则失败。

<code>'a'</code> - 以追加模式打开文件。如果文件不存在，则会被创建。

<code>'ax'</code> - 类似于 <code>'a'</code>，但如果 <code>path</code> 存在，则失败。

<code>'a+'</code> - 以读取和追加模式打开文件。如果文件不存在，则会被创建。

<code>'ax+'</code> - 类似于 <code>'a+'</code>，但如果 <code>path</code> 存在，则失败。

<code>mode</code> 可设置文件模式（权限和 sticky 位），但只有当文件被创建时才有效。默认为 <code>0o666</code>，可读写。

<code>buffer</code><Buffer> | <Uint8Array>

<code>offset</code><integer>

<code>length</code><integer>

<code>position</code><integer>

<code>bytesRead</code><integer>

<code>buffer</code><Buffer>

<code>buffer</code> 是数据将被写入到的 buffer。

<code>encoding</code><string> 默认 = <code>'utf8'</code>

<code>files</code><string[]> | <Buffer[]>

回调有两个参数 <code>(err, files)</code>，其中 <code>files</code> 是目录中不包括 <code>'.'</code> 和 <code>'..'</code> 的文件名的数组。

<code>path</code> <string> | <Buffer> | <URL> | <integer> 文件名或文件描述符。

<code>options</code> <Object> | <string>

<code>encoding</code> <string> | <null> 默认为 <code>null</code>。

<code>flag</code> <string> 默认为 <code>'r'</code>。

异步地读取一个文件的全部内容。

注意：当 <code>path</code> 是一个目录时，<code>fs.readFile()</code> 与 fs.readFileSync() 的行为与平台有关。在 macOS、Linux 与 Windows 上，会返回一个错误。在 FreeBSD 上，会返回目录内容的表示。

任何指定的文件描述符必须支持读取。

注意：如果一个文件描述符被指定为 <code>path</code>，则它不会被自动关闭。

<code>oldPath</code> <string> | <Buffer> | <URL>

<code>newPath</code> <string> | <Buffer> | <URL>

异步的 <code>rename(2)</code>。完成回调只有一个可能的异常参数。

异步的 <code>rmdir(2)</code>。完成回调只有一个可能的异常参数。

请注意: 在文件上（而不是目录上）使用<code>fs.rmdir()</code>，在Windows平台将会导致<code>ENOENT</code>错误，而在POSIX平台将会导致<code>ENOTDIR</code>错误。

异步的 <code>unlink(2)</code>。完成回调只有一个可能的异常参数。

<code>bytesWritten</code><integer>

写入 <code>buffer</code> 到 <code>fd</code> 指定的文件。

<code>offset</code> 决定 buffer 中被写入的部分，<code>length</code> 是一个整数，指定要写入的字节数。

<code>position</code> 指向从文件开始写入数据的位置的偏移量。如果 <code>typeof position !== 'number'</code>，则数据从当前位置写入。详见 <code>pwrite(2)</code>。

回调有三个参数 <code>(err, bytesWritten, buffer)</code>，其中 <code>bytesWritten</code> 指定从 <code>buffer</code> 写入了多少字节。

如果以 <code>util.promisify()</code> 的形式调用该方法，则会返回包含 <code>bytesWritten</code> 和 <code>buffer</code> 属性的 Promise 的对象。

注意，多次对同一文件使用 <code>fs.write</code> 且不等待回调，是不安全的。对于这种情况，强烈推荐使用 <code>fs.createWriteStream</code>。

在 Linux 上，当文件以追加模式打开时，指定位置的写入是不起作用的。内核会忽略位置参数，并总是将数据追加到文件的末尾。

<code>string</code> <string>

<code>position</code> <integer>

<code>written</code> <integer>

写入 <code>string</code> 到 <code>fd</code> 指定的文件。如果 <code>string</code> 不是一个字符串，则该值将被强制转换为一个字符串。

<code>encoding</code> 是期望的字符串编码。

回调有三个参数 <code>(err, written, string)</code>，其中 <code>written</code> 指定传入的字符串被写入多少字节。注意，写入的字节与字符串的字符是不同的。详见 <code>Buffer.byteLength</code>。

不同于写入 <code>buffer</code>，该方法整个字符串必须被写入。不能指定子字符串。这是因为结果数据的字节偏移量可能与字符串的偏移量不同。

<code>file</code> <string> | <Buffer> | <URL> | <integer> 文件名或文件描述符

<code>encoding</code> <string> | <null> 默认 = <code>'utf8'</code>

异步地写入数据到文件，如果文件已经存在，则替代文件。 <code>data</code> 可以是一个字符串或一个 buffer。

如果 <code>data</code> 是一个 buffer，则忽略 <code>encoding</code> 选项。它默认为 <code>'utf8'</code>。

fs - 文件系统

继续阅读

浅谈MFC CSting类拼接效率

微信小程序前端解密获取用户信息

C和java中关于字符串与字符数组的定义和转化

Java：String类字符串与数组之间的转换

Java中 byte[] 数组与 String 字符串的转化

Spring MVC 自学杂记（五） -- SpringMVC与前台的json数据交互

《MySQL技术内幕：InnoDB存储引擎》笔记

扩容TIKV节点遇到的坑

PHP辅导代做编程：CS353 Database System

自学Zabbix3.10.2-事件通知Notifications upon events-Actions报警配置点击返回：自学zabbix集锦

HDU 5678 ztr loves trees

拓端tecdat|R语言弹性网络Elastic Net正则化惩罚回归模型交叉验证可视化

二叉树及其应用--二叉树创建

回文树学习小结

查找文件中的字符串

详解STM32单片机的堆栈