Skip to main content

writev

function writev
Jump to headingwritev(
fd: number,
buffers: readonly ArrayBufferView[],
cb: (
err: ErrnoException | null,
bytesWritten: number,
buffers: ArrayBufferView[],
) => void
,
): void

Write an array of ArrayBufferViews to the file specified by fd using writev().

position is the offset from the beginning of the file where this data should be written. If typeof position !== 'number', the data will be written at the current position.

The callback will be given three arguments: err, bytesWritten, and buffers. bytesWritten is how many bytes were written from buffers.

If this method is util.promisify() ed, it returns a promise for an Object with bytesWritten and buffers properties.

It is unsafe to use fs.writev() multiple times on the same file without waiting for the callback. For this scenario, use createWriteStream.

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.

Parameters Jump to heading

Jump to headingbuffers: readonly ArrayBufferView[]
Jump to headingcb: (
err: ErrnoException | null,
bytesWritten: number,
buffers: ArrayBufferView[],
) => void

Return Type Jump to heading

void
Jump to headingwritev(
fd: number,
buffers: readonly ArrayBufferView[],
position: number,
cb: (
err: ErrnoException | null,
bytesWritten: number,
buffers: ArrayBufferView[],
) => void
,
): void

Parameters Jump to heading

Jump to headingbuffers: readonly ArrayBufferView[]
Jump to headingposition: number
Jump to headingcb: (
err: ErrnoException | null,
bytesWritten: number,
buffers: ArrayBufferView[],
) => void

Return Type Jump to heading

void
Back to top