Funzione ftruncate

La funzione ftruncate tronca un file alla dimensione specificata. Il primo parametro della funzione è un descrittore di file, il secondo è la dimensione alla quale il file deve essere troncato. Se il file era più grande della dimensione specificata, i dati in eccesso andranno persi. Se il file era più piccolo, verrà riempito con byte nulli.

Sintassi

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

Esempio

Tronchiamo un file a 100 byte:

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

La funzione restituirà true in caso di successo o false in caso di errore.

Esempio

Creiamo un file vuoto di una determinata dimensione:

php<?php
  $file = fopen('empty.dat', 'w');
  ftruncate($file, 1024); // creiamo un file di 1 KB
  fclose($file);
?>

Esempio

Verifica del risultato dell'esecuzione della funzione:

php<?php
  $file = fopen('test.txt', 'r+');
  $res = ftruncate($file, 50);
  
  if ($res) {
    echo 'file troncato con successo';
  } else {
    echo 'errore durante il troncamento del file';
  }
  fclose($file);
?>

Vedi anche

  • la funzione fopen,
    che apre un file
  • la funzione fwrite,
    che scrive in un file
  • la funzione filesize,
    che restituisce la dimensione di un file