ftruncate

(PHP 4, PHP 5, PHP 7, PHP 8)

ftruncate — Trunca um arquivo a um tamanho especificado

Descrição

ftruncate(resource$stream, int$size): bool

Toma o ponteiro de arquivo stream e trunca o arquivo para o comprimento definido em size.

Parâmetros

stream: O ponteiro do arquivo.
Nota:
O fluxo stream deve estar aberto para escrita.
size: O tamanho para o qual será truncado.
Nota:
Se o parâmetro size for maior que o arquivo, o arquivo será estendido com bytes nulos.
Se o parâmetro size for menor que o arquivo, o arquivo será truncado para este tamanho.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Exemplos

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

Notas

Nota:
O ponteiro do arquivo não é alterado.

Veja Também

fopen() - Abre um arquivo ou URL
fseek() - Procura (seeks) em um ponteiro de arquivo