Función ftruncate

La función ftruncate trunca un archivo al tamaño especificado. El primer parámetro de la función es un descriptor de archivo, y el segundo es el tamaño al que se debe truncar el archivo. Si el archivo era más grande que el tamaño especificado, se perderán los datos excedentes. Si el archivo era más pequeño, se completará con bytes nulos.

Sintaxis

phpftruncate(resource $handle, int $size): bool

Ejemplo

Trunquemos un archivo a 100 bytes:

php<?php
  $file = fopen('example.txt', 'r+');
  ftruncate($file, 100);
  fclose($file);
?>

La función devolverá true en caso de éxito o false en caso de error.

Ejemplo

Creemos un archivo vacío de un tamaño determinado:

php<?php
  $file = fopen('empty.dat', 'w');
  ftruncate($file, 1024); // creamos un archivo de 1 KB de tamaño
  fclose($file);
?>

Ejemplo

Verificación del resultado de la ejecución de la función:

php<?php
  $file = fopen('test.txt', 'r+');
  $res = ftruncate($file, 50);
  
  if ($res) {
    echo 'archivo truncado exitosamente';
  } else {
    echo 'error al truncar el archivo';
  }
  fclose($file);
?>

Ver también

  • la función fopen,
    que abre un archivo
  • la función fwrite,
    que escribe en un archivo
  • la función filesize,
    que devuelve el tamaño de un archivo