Sistema de archivos
PHP Manual

fgets

(PHP 4, PHP 5)

fgets — Obtiene una línea desde el apuntador de archivo

Descripción

string fgets ( resource $gestor [, int $longitud ] )

Obtiene una línea desde un apuntador de archivo. Gets a line from file pointer.

Lista de parámetros

gestor

El puntero de fichero debe de ser valido y debe de apuntar a un fichero abierto con exito por fopen() o fsockopen().

longitud

La lectura finaliza cuando se han leído longitud - 1 bytes, se alcanza un salto de línea (el cual se incluye en el valor devuelto), o en EOF (lo que ocurra primero). Si no se especifica una longitud, la función seguirá leyendo desde la secuencia hasta que llegue al final de línea.

Note: Hasta PHP 4.3.0, al omitir este parámetro se asume 1024 como la longitud de línea. Si la mayoría de líneas en el archivo superan los 8KB, es más eficiente en términos de recursos especificar la longitud máxima de línea en su script.

Valores retornados

Devuelve una cadena de hasta longitud - 1 bytes leídos desde el archivo apuntado por gestor .

Si ocurre un error, devuelve FALSE.

Registro de cambios

Versión Descripción
4.3.0 fgets() es ahora segura con material binario
4.2.0 El parámetro longitud se hizo opcional

Ejemplos

Example#1 Lectura de un archivo línea a línea

<?php
$gestor 
= @fopen("/tmp/archivo_entrada.txt""r");
if (
$gestor) {
    while (!
feof($gestor)) {
        
$bufer fgets($gestor4096);
        echo 
$bufer;
    }
    
fclose ($gestor);
}
?>

Notes

Note: Si sufre problemas con PHP no reconociendo los finales de línea cuando lee archivos creados en un Macintosh (o leyendo archivos sobre uno), puede probar activando la opción de configuración auto_detect_line_endings.

Note: Las personas acostumbradas a la semántica de fgets() en 'C' deben notar la diferencia en cómo el valor EOF es devuelto.

Ver también


Sistema de archivos
PHP Manual