Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] write - Écrire dans un descripteur de fichier. [size=18] [b]Résumé[/b] [/size] [b]#include <unistd.h>[/b] [b][i]ssize_t write(int fd , const void * buf , size_t count );[/i][/b] [size=18] [b]Description[/b] [/size] [b]write[/b] écrit jusqu'à [i]count[/i] octets dans le fichier associé au descripteur [i]fd[/i] depuis le buffer pointé par [i]buf.[/i] POSIX réclame qu'une lecture avec [b]read()[/b] effectuée après le retour d'une écriture avec [b]write()[/b], renvoie les nouvelles données. Notez que tous les systèmes de fichiers ne sont pas compatibles avec POSIX. [size=18] [b]Valeur renvoyée[/b] [/size] [b]write[/b] renvoie le nombre d'octets écrits (0 signifiant aucune écriture), ou -1 s'il échoue, auquel cas [i]errno[/i] contient le code d'erreur. Si [i]count[/i] vaut zéro, et si le descripteur est associé à un fichier normal, 0 sera renvoyé sans effets de bord. Pour un fichier spécial, les résultats ne sont pas portables. [size=18] [b]Erreurs[/b] [/size] [b]EBADF[/b] [i]fd[/i] [table][row][col]    [/col][col]n'est pas un descripteur de fichier valide, ou n'est pas ouvert en écriture.[/col][/row][/table] [b]EINVAL[/b] [i]fd[/i] [table][row][col]    [/col][col]correspond à un objet ne permettant pas l'écriture.[/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] [b]EFBIG[/b] [table][row][col]    [/col][col]Tentative d'écrire un fichier dont la taille dépasse un maximum dépendant de l'implémentation ou du processus, ou d'écrire à une position qui dépasse le déplacement maximal autorisé.[/col][/row][/table] [b]EPIPE[/b] [i]fd[/i] [table][row][col]    [/col][col]est connecté à un tube (pipe) ou une socket dont l'autre extrémité est fermée. Quand ceci se produit, le processus écrivain reçoit un signal [b]SIGPIPE .[/b] S'il intercepte, bloque ou ignore ce signal, [b]EPIPE[/b] est renvoyé.[/col][/row][/table] [b]EAGAIN[/b] [table][row][col]    [/col][col]L'écriture est non-bloquante (attribut [b]O_NONBLOCK[/b] du descripteur), et l'opération devrait bloquer.[/col][/row][/table] [b]EINTR[/b] [table][row][col]    [/col][col]L'appel système a été interrompu par un signal avant d'avoir pu écrire quoique ce soit.[/col][/row][/table] [b]ENOSPC[/b] [table][row][col]    [/col][col]Le périphérique correspondant à [i]fd[/i] n'a plus de place disponible.[/col][/row][/table] [b]EIO[/b] [table][row][col]    [/col][col]Une erreur d'entrée/sortie bas niveau s'est produite durant la modification de l'i-noeud.[/col][/row][/table] D'autres erreurs peuvent se produire suivant le type d'objet associé à [b]fd .[/b] [size=18] [b]Conformité[/b] [/size] SVr4, SVID, POSIX, X/OPEN, BSD 4.3. SVr4 mentionne des conditions d'erreur supplémentaires EDEADLK, ENOLCK, ENOLNK, ENOSR, ENXIO, EPIPE, et ERANGE. Sous SVr4, un appel [b]write[/b]() peut être interrompu, et renvoyer EINTR à n'importe quel moment, pas seulement avant l'écriture des données. [size=18] [b]Notes[/b] [/size] Une réussite de [b]write[/b] n'offre aucune garantie que les données se trouvent sur le disque. En fait, sur certaines implémentations erronées, elle ne garantie même pas que l'espace suffisant a été réservé pour les données. La seule manière d'être sûr de la réussite est d'invoquer [b]fsync (2)[/b] après avoir écrit les données. [size=18] [b]Voir aussi[/b] [/size] [b]close (2),[/b] [b]fcntl (2), [/b] [b]fsync (2),[/b] [b]ioctl (2), [/b] [b]lseek (2),[/b] [b]open (2),[/b] [b]read (2), [/b] [b]select (2),[/b] [b]fwrite (3),[/b] [b]writev (2)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier