Edit Report a Bug

SplFileObject::ftruncate

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

SplFileObject::ftruncate — Обрезает файл до заданной длины

Описание

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

Отбрасывает все данные в файле после байта size.

Список параметров

size: Размер, под который требуется подогнать файл.

Замечание:
Если size больше текущего размера файла, в конец будут добавлены нулевые байты.

Если size меньше размера файла, лишние данные будут потеряны.

Возвращаемые значения

Возвращает true в случае успешного выполнения или false в случае возникновения ошибки.

Примеры

Пример #1 Пример использования SplFileObject::ftruncate()

<?php
// Создать файл, содержащий "Hello World!"
$file = new SplFileObject("/tmp/ftruncate", "w+");
$file->fwrite("Hello World!");

// Обрезать до 5 байт
$file->ftruncate(5);

// Перемотка к началу файла и чтение данные
$file->rewind();
echo $file->fgets();
?>

Вывод приведённого примера будет похож на:

Hello

Смотрите также

ftruncate() - Урезает файл до указанной длины

add a note

User Contributed Notes 1 note

down

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