Funktio fgets

Funktio fgets lukee rivin tiedostosta. Sen ensimmäinen parametri on osoitin tiedostoon, jonka on oltava aiemmin avattu funktiolla fopen. Toisella valinnaisella parametrilla voidaan määrittää luettavan rivin enimmäispituus. Funktio lopettaa lukemisen, kun se saavuttaa rivin lopun, tiedoston lopun tai määritetyn pituuden.

Syntaksi

phpfgets(resource $handle, int $length = ?): string|false

Esimerkki

Luetaan ensimmäinen rivi tiedostosta:

php<?php
  $file = fopen('test.txt', 'r');
  echo fgets($file);
  fclose($file);
?>

Esimerkki

Tiedoston lukeminen rivi kerrallaan silmukassa:

php<?php
  $file = fopen('test.txt', 'r');
  
  while ($line = fgets($file)) {
    echo $line;
  }
  fclose($file);
?>

Esimerkki

Rivin lukeminen pituusrajoituksella:

php<?php
  $file = fopen('test.txt', 'r');
  echo fgets($file, 4);
  fclose($file);
?>

Katso myös

  • funktion fgetc,
    joka lukee merkin tiedostosta
  • funktion fread,
    joka lukee tiedostosta
  • funktion file,
    joka lukee tiedoston merkkijonotaulukkoon