SplFileObject::ftruncate

    (PHP 5 >= 5.1.0, PHP 7, PHP 8)

    SplFileObject::ftruncate — Truncates the file to a given length

    Description

    public SplFileObject::ftruncate(int $size): bool

    Truncates the file to size bytes.

    Parameters

    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 file, the extra data will be lost.

    Return Values

    Returns true on success or false on failure.

    Examples

    Example #1 SplFileObject::ftruncate() example

    <?php
    // Create file containing "Hello World!"
    $file = new SplFileObject("/tmp/ftruncate", "w+");
    $file->fwrite("Hello World!");

    // Truncate to 5 bytes
    $file->ftruncate(5);

    // Rewind and read data
    $file->rewind();
    echo     $file->fgets();
    ?>

    The above example will output something similar to:

    Hello

    See Also

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    7
    irvinezega at hotmail dot com
    6 years ago
    I suppose a fair number of us know this:

    However, for those who don't:-

    If you are truncating a file, say, to $fileObject->ftruncate(0), then, it may be advisable to call $fileObject->fseek(0) first (before you call '$fileObject->ftruncate').

    On inspection, I was encountering 'NULL' characters at the beginning of a, or the, file.

    Hence, from what I have surmised; when 'ftruncate()' is called, the file pointer does NOT move to the beginning (or, at least, the required position) of the file.

    This issue cost me a fair amount of time to figure out, so I hope it helps someone.
    ＋add a note
    To Top