ftruncate

Truncates a file to a given length

&reftitle.description; `bool` `ftruncate` `resource` `stream` `int` `size`

Takes the filepointer, `stream`, and truncates the file to length, `size`.

&reftitle.parameters;

`stream`

- The file pointer.

  The `stream` must be open for writing.

`size`

- The size to truncate to.

  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.

&reftitle.returnvalues;

&return.success;

&reftitle.examples;

### 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);
    ?>

&reftitle.notes;

The file pointer is not changed.

&reftitle.seealso;

- `fopen`
- `fseek`