Fonction ftruncate

La fonction ftruncate tronque un fichier à la taille spécifiée. Le premier paramètre de la fonction est un descripteur de fichier, et le second - la taille à laquelle le fichier doit être tronqué. Si le fichier était plus grand que la taille spécifiée, les données excédentaires seront perdues. Si le fichier était plus petit, il sera complété par des octets nuls.

Syntaxe

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

Exemple

Tronquons un fichier à 100 octets :

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

La fonction renverra true en cas de succès ou false en cas d'erreur.

Exemple

Créons un fichier vide de taille spécifiée :

php<?php
  $file = fopen('empty.dat', 'w');
  ftruncate($file, 1024); // créons un fichier de 1 Ko
  fclose($file);
?>

Exemple

Vérification du résultat de l'exécution de la fonction :

php<?php
  $file = fopen('test.txt', 'r+');
  $res = ftruncate($file, 50);
  
  if ($res) {
    echo 'file truncated successfully';
  } else {
    echo 'error truncating file';
  }
  fclose($file);
?>

Voir aussi

  • la fonction fopen,
    qui ouvre un fichier
  • la fonction fwrite,
    qui écrit dans un fichier
  • la fonction filesize,
    qui retourne la taille d'un fichier