# ftruncate

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

ftruncate — Trunca un archivo a una longitud dada

### Descripción

ftruncate(resource `$handle`, int `$size`): bool

Toma el puntero al archivo, `handle`, y trunca el archivo a la longitud `size`.

### Parámetros

`handle`

  El puntero al archivo.

  > Nota:

  > `handle` tiene que ser abierto para escritura.

`size`

  El tamaño a truncar.

  > Nota:

  > Si `size` es mayor que el del archivo, éste se extiende con bytes null.

  > Si `size` es menor que el del archivo, éste será truncado a ese tamaño.

### Valores devueltos

Devuelve `true` en caso de éxito o `false` en caso de error.

### Ejemplos

Ejemplo #1 Ejemplo de truncar un archivo

`<?php
$nombre_archivo = 'lorem_ipsum.txt';
$gestor = fopen($nombre_archivo, 'r+');
ftruncate($gestor, rand(1, filesize($nombre_archivo)));
rewind($gestor);
echo fread($gestor, filesize($nombre_archivo));
fclose($gestor);
?>`

### Notas

> Nota:

> El puntero al archivo no es cambiado.

### Ver también

- fopen() - Abre un fichero o un URL
- fseek() - Busca sobre un puntero a un fichero