Funktio ftruncate

Funktio ftruncate lyhentää tiedostoa määritettyyn kokoon. Ensimmäisenä parametrina funktio ottaa tiedostokahvan ja toisena - koon, johon tiedosto on lyhennettävä. Jos tiedosto oli suurempi kuin määritetty koko, ylimääräiset tiedot menetetään. Jos tiedosto oli pienempi, sitä täydennetään nollatavuilla.

Syntaksi

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

Esimerkki

Lyhennetään tiedostoa 100 tavuun:

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

Funktio palauttaa true onnistuessaan tai false virheen sattuessa.

Esimerkki

Luodaan tyhjä tiedosto määritetystä koosta:

php<?php
  $file = fopen('empty.dat', 'w');
  ftruncate($file, 1024); // luodaan 1 KT:n kokoinen tiedosto
  fclose($file);
?>

Esimerkki

Funktion suorituksen tuloksen tarkistus:

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

Katso myös