Manuel PHP
Précédent |  | Suivant

# fgets

(PHP 3, PHP 4 , PHP 5)

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édent | Sommaire | Suivant
fgetcsv | Niveau supérieur | fgetss