filehandle.writev(buffers[, position])
-
buffers
<Buffer[]> | <TypedArray[]> | <DataView[]> -
position
<integer> | <null> 要写入来自buffers
的数据的文件的开头偏移量。如果position
不是number
,则数据将被写入当前位置。默认值:null
¥
position
<integer> | <null> The offset from the beginning of the file where the data frombuffers
should be written. Ifposition
is not anumber
, the data will be written at the current position. Default:null
-
返回:<Promise>
¥Returns: <Promise>
将 <ArrayBufferView> 的数组写入文件。
¥Write an array of <ArrayBufferView> to the file.
这个 promise 是通过一个包含两个属性的对象来实现的:
¥The promise is fulfilled with an object containing a two properties:
-
bytesWritten
<integer> 写入的字节数¥
bytesWritten
<integer> the number of bytes written -
buffers
<Buffer[]> | <TypedArray[]> | <DataView[]> 对buffers
输入的引用。¥
buffers
<Buffer[]> | <TypedArray[]> | <DataView[]> a reference to thebuffers
input.
在不等待 promise 履行(或拒绝)的情况下对同一个文件多次调用 writev()
是不安全的。
¥It is unsafe to call writev()
multiple times on the same file without waiting
for the promise to be fulfilled (or rejected).
在 Linux 上,以追加模式打开文件时,位置写入不起作用。内核会忽略位置参数,并始终将数据追加到文件末尾。
¥On Linux, positional writes don't work when the file is opened in append mode. The kernel ignores the position argument and always appends the data to the end of the file.