Manuel PHP
PrécédentSuivant

fgets

(PHP 3, PHP 4 )

fgets --  Renvoie la ligne courante sur laquelle se trouve le pointeur du fichier.

Description

string fgets ( resource handle [, int length])

fgets() retourne la chaîne lue jusqu'à la longueur length - 1 octet, ou bien la fin du fichier, ou encore un retour chariot (le premier des trois qui sera rencontré).

Si une erreur survient, fgets() retourne FALSE.

Erreur courante :

Les programmeurs habitués à la programmation 'C' noteront que fgets() ne se comporte pas comme son équivalent C lors de la rencontre de la fin du fichier.

handle doit être valide, et avoir été correctement ouvert par fopen(), popen(), ou fsockopen().

Un exemple simple :

Exemple 1. Lecture d'un fichier ligne par ligne

<?php
  $fd = fopen ("/tmp/inputfile.txt", "r");
  while (!feof ($fd)) {
    $buffer = fgets($fd, 4096);
    echo $buffer;
  }
  fclose ($fd);
?>

Note : Le paramètre length est devenu optionnel depuis PHP 4.2.0. Si il est omis, il prend la valeur par défaut de 1024. Depuis PHP 4.3.0, omettre le paramètre length fait que la fonction va continuer à lire le flux jusqu'à ce que la ligne s'achève. Si la majorité des lignes du fichier dépassent les 8 ko, il est plus efficace pour votre script de spécifier ce paramètre.

Note : fgets() est compatible avec les données binaires depuis PHP 4.3. Les versions plus anciennes ne le sont pas.

Note : Si vous avez des problèmes avec PHP qui ne reconnait pas certaines lignes lors de la lecture de fichier qui ont été créé ou lus sur un MacIntosh, vous pouvez activer l'option de configuration auto_detect_line_endings.

Voir aussi fread(), fgetc(), stream_get_line(), fopen(), popen(), fsockopen() et socket_set_timeout().

PrécédentSommaireSuivant
fgetcsvNiveau supérieurfgetss