ftruncate

Truncates a file to a given length

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

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

&reftitle.parameters;

`handle`

- The file pointer.

  The `handle` 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.changelog;

&Version; | &Description;
4.3.3 | Prior to this release `ftruncate` returned an `integer` value of 1 on success, instead of `boolean` &true;.

&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`