Skip to main content
ftruncate - fs - Node documentation
function ftruncate

Usage in Deno

import { ftruncate } from "node:fs";
ftruncate(
fd: number,
len:
number
| undefined
| null
,
callback: NoParamCallback,
): void

Truncates the file descriptor. No arguments other than a possible exception are given to the completion callback.

See the POSIX ftruncate(2) documentation for more detail.

If the file referred to by the file descriptor was larger than len bytes, only the first len bytes will be retained in the file.

For example, the following program retains only the first four bytes of the file:

import { open, close, ftruncate } from 'node:fs';

function closeFd(fd) {
  close(fd, (err) => {
    if (err) throw err;
  });
}

open('temp.txt', 'r+', (err, fd) => {
  if (err) throw err;

  try {
    ftruncate(fd, 4, (err) => {
      closeFd(fd);
      if (err) throw err;
    });
  } catch (err) {
    closeFd(fd);
    if (err) throw err;
  }
});

If the file previously was shorter than len bytes, it is extended, and the extended part is filled with null bytes ('\0'):

If len is negative then 0 will be used.

Parameters

fd: number
optional
len:
number
| undefined
| null
= 0
callback: NoParamCallback

Return Type

void
ftruncate(
fd: number,
callback: NoParamCallback,
): void

Asynchronous ftruncate(2) - Truncate a file to a specified length.

Parameters

fd: number

A file descriptor.

callback: NoParamCallback

Return Type

void