7.29 Système de fichiers
7 Index des fonctions
Manuel PHP
. Introduction . Pré-requis . Installation . Configuration à l'exécution . Types de ressources . Constantes prédefinies . Voir aussi . basename . chgrp . chmod . chown . clearstatcache . copy . delete . dirname . disk_free_space . disk_total_space . diskfreespace . fclose . feof . fflush . fgetc . fgetcsv ->fgets . fgetss . file_exists . file_get_contents . file_put_contents . file . fileatime . filectime . filegroup . fileinode . filemtime . fileowner . fileperms . filesize . filetype . flock . fnmatch . fopen . fpassthru . fputs . fread . fscanf . fseek . fstat . ftell . ftruncate . fwrite . glob . is_dir . is_executable . is_file . is_link . is_readable . is_uploaded_file . is_writable . is_writeable . link . linkinfo . lstat . mkdir . move_uploaded_file . parse_ini_file . pathinfo . pclose . popen . readfile . readlink . realpath . rename .
7.29.24 fgets()
Renvoie la ligne courante sur laquelle se trouve le pointeur du fichier.
[ Exemples avec fgets ] PHP 3, PHP 4
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 :
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 flôt 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
.
|