PHP fgets() -funktio

Määrittely ja käyttö

fgets() -funktio lukee riviä tiedostopisteestä.

Syntaksi

fgets(file,length)
Parametrit Kuvaus
file Välttämätön. Määrittää luettava tiedosto.
length Valinnainen. Määrittää luettavien tiettyjen tietojen määrän. Oletusarvo on 1024 tiettyä.

Kuvaus

tiedostosta file Lue rivi osoitteesta ja palauta enintään length - 1 tavun merkkijono. Jos kohtaa rivinvaihtomerkin (mukaan lukien palautusarvossa), EOF:n tai on jo luettu length - pysähtyy 1 tavun jälkeen (riippuen ensimmäisestä tapahtumasta). Jos ei määritetty length,oletus on 1K, tai 1024 tavua.

Jos epäonnistuu, palauttaa false.

Vinkit ja huomiot

Huomautus:length Parametri on mahdollinen PHP 4.2.0 versiosta lähtien, ja jos sitä ei mainita, rivin pituus oletetaan 1024 tavua. PHP 4.3 versiosta lähtien, ohita length Se jatkaa tiedoston virrasta lukemista riveihin asti. Jos tiedoston useimmat rivit ovat suurempia kuin 8 KB, määrittää suurimman rivin pituuden skriptissä on tehokkaampaa resurssien käytön kannalta.

Huomautus:Alkaen PHP 4.3 versiosta tämä funktio voidaan käyttää turvallisesti binaaritiedostoissa. Aiemmat versiot eivät tue tätä.

Huomautus:Jos PHP ei tunnista Macintosh-tiedostojen rivinvaihtomerkkejä lukiessaan tiedostoa, voit aktivoida auto_detect_line_endings suoritusajon asetuksen.

Esimerkki

Esimerkki 1

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

Tulostus muistuttaa:

Hei, tämä on testitiedosto.

Esimerkki 2

<?php
$file = fopen("test.txt","r");
while(! feof($file))
  {
  echo fgets($file) . "<br />";
  }
fclose($file);
?>

Tulostus muistuttaa:

Hei, tämä on testitiedosto. 
Tässä on kolme riviä. 
Tämä on viimeinen rivi.