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.