php man page for ftruncate

FTRUNCATE(3)								 1							      FTRUNCATE(3)

ftruncate - Truncates a file to a given length

SYNOPSIS
       bool ftruncate (resource  $handle, int  $size)

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

PARAMETERS
	      o $handle
		- The file pointer.

	      Note

		      The $handle must be open for writing.

	      o $size
		- The size to truncate to.

	      Note

		      If $size is larger than the file then the file is extended with null bytes.

		      If $size is smaller than the file then the file is truncated to that size.

RETURN VALUES
	Returns TRUE on success or FALSE on failure.

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.

SEE ALSO
       fopen(3), fseek(3).

PHP Documentation Group 													      FTRUNCATE(3)