Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] read - Lire le contenu d'un fichier. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <sys/types.h>[/b] [b]#include <unistd.h>[/b] [b][i]ssize_t read(int fd , void * buf , size_t count );[/i][/b] .fi [size=18] [b]Description[/b] [/size] [b]read[/b] lit jusqu'à [i]count[/i] octets depuis le descripteur de fichier [i]fd[/i] dans le buffer pointé par [i]buf.[/i] Si [i]count[/i] vaut zéro, [b]read[/b] renvoie zéro et n'a pas d'autres effets. Si [i]count[/i] est supérieur à SSIZE_MAX, le résultat est indéfini. [size=18] [b]Valeur renvoyée[/b] [/size] [b]read[/b] renvoie -1 s'il échoue, auquel cas [i]errno[/i] contient le code d'erreur, et la position de la tête de lecture est indéfinie. Sinon, [b]read[/b] renvoie le nombre d'octets lus (0 en fin de fichier), et avance la tête de lecture de ce nombre. Le fait que le nombre renvoyé soit plus petit que le nombre demandé n'est pas une erreur. Ceci se produit à la fin du fichier, ou si on lit depuis un tube ou un terminal, ou encore si [b]read[/b] a été interrompu par un signal. [size=18] [b]Erreurs[/b] [/size] [b]EINTR[/b] [b]read[/b] [table][row][col]    [/col][col]a été interrompu par un signal avant d'avoir eu le temps de lire quoi que ce soit.[/col][/row][/table] [b]EAGAIN [/b] [table][row][col]    [/col][col]On utilise une lecture non bloquante (attribut [b]O_NONBLOCK[/b] du descripteur de fichier) et aucune donnée n'était disponible.[/col][/row][/table] [b]EIO[/b] [table][row][col]    [/col][col]Erreur d'entrée/sortie. Ceci arrive si un processus est dans un groupe en arrière-plan et tente de lire depuis le terminal. Il reçoit un signal SIGTTIN mais il l'ignore ou le bloque. Ceci se produit également si une erreur d'entrée/sortie bas-niveau s'est produite pendant la lecture d'un disque ou d'une bande.[/col][/row][/table] [b]EISDIR[/b] [i]fd[/i] [table][row][col]    [/col][col]est un répertoire.[/col][/row][/table] [b]EBADF[/b] [i]fd[/i] [table][row][col]    [/col][col]n'est pas un descripteur valide, ou n'est pas ouvert en lecture.[/col][/row][/table] [b]EINVAL[/b] [i]fd[/i] [table][row][col]    [/col][col]correspond à un objet ne permettant pas la lecture.[/col][/row][/table] [b]EFAULT[/b] [i]buf[/i] [table][row][col]    [/col][col]pointe en dehors de l'espace d'adressage accessible.[/col][/row][/table] D'autres erreurs peuvent se produire, suivant le type d'objet associé à [b]fd .[/b] POSIX permet à un [b]read[/b] interrompu par un signal de renvoyer soit le nombre d'octets lus à ce point, soit -1, et de placer [i]errno[/i] à [b]EINTR .[/b] [size=18] [b]Conformité[/b] [/size] SVr4, SVID, AT&T, POSIX, X/OPEN, BSD 4.3 [size=18] [b]Restrictions[/b] [/size] Sur un système de fichiers NFS, la lecture de petites quantités de données ne mettra à jour l'horodatage du fichier que lors de la première lecture. Les lectures suivantes ne modifieront pas cette heure. En effet la plupart, si ce n'est tous les clients NFS disposent d'un cache des attributs de fichiers et n'effectuent pas la mise à jour du champ 'atime' du côté serveur. La véritable sémantique UNIX peut être obtenue en désactivant le cache des attributs du côté client, mais généralement ceci augmente sensiblement la charge du serveur, et dégrade ses performances. Beaucoup de disques et systèmes de fichiers ont été considérés comme suffisamment rapides pour que l'implémentation de [b]O_NONBLOCK[/b] soit jugée inutile. Ainsi cet attribut peut ne pas être disponibles sur les fichiers et/ou les disques. [size=18] [b]Voir aussi[/b] [/size] [b]close (2),[/b] [b]fcntl (2),[/b] [b]ioctl (2),[/b] [b]lseek (2),[/b] [b]readdir (2),[/b] [b]readlink (2),[/b] [b]select (2),[/b] [b]write (2),[/b] [b]fread (3),[/b] [b]readv (3)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier