# SplFileObject::fread

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

SplFileObject::fread — Leer un fichero

### Descripción

public SplFileObject::fread(int `$length`): string|false

Lee de un fichero el número de bytes dado.

### Parámetros

`length`

  El número de bytes a leer.

### Valores devueltos

Devuelve el string léido desde el fichero o `false` en caso de error.

### Ejemplos

Ejemplo #1 Ejemplo de SplFileObject::fread()

`<?php
// Pasar el contenido de un fichero a un string
$nombre_fichero = "/usr/local/something.txt";
$fichero = new SplFileObject($nombre_fichero, "r");
$contenido = $fichero->fread($fichero->getSize());
?>`

### Notas

> Nota:

> Observe que SplFileObject::fread() lee desde la posición actual del puntero del fichero. Use SplFileObject::ftell() para conocer la posición actual del puntero, y SplFileObject::rewind() (o SplFileObject::fseek()) para posicionar el puntero al inicio.

### Ver también

- fread() - Lectura de un fichero en modo binario seguro