fgetcsv
fgetss
Filesystem Functions
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($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.

### Ver también

- fgetss() - Obtiene una lína desde el apuntador de archivo y elimina las etiquetas HTML
- fread() - Lectura de archivos segura con material binario
- fgetc() - Obtiene un caracter del archivo apuntado
- stream_get_line() - Obtiene una línea desde un recurso de secuencia, hasta un delimitador dado
- fopen() - Abre un archivo o URL
- popen() - Abre un apuntador de archivo de proceso
- fsockopen() - Abrir una conexión de sockets de dominio de Internet o Unix
- stream_set_timeout() - Establecer el periodo de espera de una secuencia

fgetcsv
fgetss
Filesystem Functions
PHP Manual