fgets
(PHP 4, PHP 5)
fgets — Obtiene una lÃnea desde el apuntador de archivo
Descripción
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($gestor, 4096);
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.