Funkce ftruncate

Funkce ftruncate ořezává soubor na zadanou velikost. První parametr funkce přijímá souborový deskriptor a druhý - velikost, na kterou je třeba soubor oříznout. Pokud byl soubor větší než zadaná velikost, nadbytečná data budou ztracena. Pokud byl soubor menší, bude doplněn nulovými bajty.

Syntaxe

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

Příklad

Ořízněme soubor na 100 bajtů:

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

Funkce vrátí true v případě úspěchu nebo false v případě chyby.

Příklad

Vytvořme prázdný soubor zadané velikosti:

php<?php
  $file = fopen('empty.dat', 'w');
  ftruncate($file, 1024); // vytvoříme soubor o velikosti 1 KB
  fclose($file);
?>

Příklad

Kontrola výsledku provedení funkce:

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

Viz také

  • funkci fopen,
    která otevírá soubor
  • funkci fwrite,
    která zapisuje do souboru
  • funkci filesize,
    která vrací velikost souboru