La función fgets() en PHP es una función incorporada que se usa para devolver una línea desde un archivo abierto.
- Se utiliza para devolver una línea desde un puntero de archivo y deja de devolver en una longitud específica, al final del archivo (EOF) o en una nueva línea, lo que ocurra primero.
- El archivo a leer y el número de bytes a leer se envían como parámetros a la función fgets() y esta devuelve una string de longitud -1 bytes del archivo apuntado por el usuario.
- Devuelve False en caso de falla.
Sintaxis:
fgets(file, length) Parameters Used: The fgets() function in PHP accepts two parameters. file : It specifies the file from which characters have to be extracted. length : It specifies the number of bytes to be read by the fgets() function. The default value is 1024 bytes.
Valor devuelto: Devuelve una string de longitud -1 bytes del archivo apuntado por el usuario o Falso en caso de falla.
Errores y excepciones
- La función no está optimizada para archivos grandes, ya que lee una sola línea a la vez y puede llevar mucho tiempo leer completamente un archivo grande.
- El búfer debe borrarse si la función fgets() se usa varias veces.
- La función fgets() devuelve Boolean False pero muchas veces sucede que devuelve un valor no booleano que se evalúa como False.
Supongamos que hay un archivo llamado «gfg.txt» que consta de:
Esta es la primera línea.
Esta es la segunda línea.
Esta es la tercera línea.
Programa 1
<?php // file is opened using fopen() function $my_file = fopen("gfg.txt", "rw"); // Prints a single line from the opened file pointer echo fgets($my_file); // file is closed using fclose() function fclose($my_file); ?>
Producción:
This is the first line.
Programa 2
<?php //file is opened using fopen() function $my_file = fopen("gfg.txt", "rw"); // prints a single line at a time until end of file is reached while (! feof ($my_file)) { echo fgets($my_file); } // file is closed using fclose() function fclose($my_file); ?>
Producción:
This is the first line. This is the second line. This is the third line.
Referencia:
http://php.net/manual/en/function.fgets.php
Publicación traducida automáticamente
Artículo escrito por Shubrodeep Banerjee y traducido por Barcelona Geeks. The original can be accessed here. Licence: CCBY-SA