Az ftruncate függvény

A ftruncate függvény egy fájlt a megadott méretre csonkol. A függvény első paramétere egy fájlleíró, a második pedig a méret, amire a fájlt csonkolni kell. Ha a fájl nagyobb volt a megadott méretnél, a többlet adatok elvesznek. Ha a fájl kisebb volt, akkor null bájtokkal lesz kiegészítve.

Szintaxis

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

Példa

Csonkoljuk a fájlt 100 bájtra:

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

A függvény true értéket ad vissza sikeres végrehajtás esetén, vagy false értéket hiba esetén.

Példa

Hozzunk létre egy üres fájlt adott mérettel:

php<?php
  $file = fopen('empty.dat', 'w');
  ftruncate($file, 1024); // létrehozunk egy 1 KB méretű fájlt
  fclose($file);
?>

Példa

A függvény végrehajtásának eredményének ellenőrzése:

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

Lásd még

  • a fopen függvényt,
    ami megnyit egy fájlt
  • a fwrite függvényt,
    ami fájlba ír
  • a filesize függvényt,
    ami visszaadja a fájl méretét