Truncates a file to a given length

Description

bool ftruncate ( resource $handle , int $size )

Takes the filepointer, handle, and truncates the file to length, size.

Parameters

handle: The file pointer.

Note: The handle must be open for writing.
size: The size to truncate to.

Note: If size is larger than the file it is extended with null bytes.
If size is smaller than the extra data will be lost.

Return Values

Returns TRUE on success or FALSE on failure.

Changelog

Version	Description
PHP 4.3.3	Prior to this release ftruncate() returned an integer value of 1 on success, instead of boolean `TRUE`.

Examples

Example #1 File truncation example


<?php
$filename = 'lorem_ipsum.txt';

$handle = fopen($filename, 'r+');
ftruncate($handle, rand(1, filesize($filename)));
rewind($handle);
echo fread($handle, filesize($filename));
fclose($handle);
?>

Notes

Note: The file pointer is not changed.