Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] setbuf, setbuffer, setlinebuf, setvbuf - Agir sur les buffers d'un flux. [size=18] [b]Résumé[/b] [/size] .na [b]#include <stdio.h>[/b] [b][i]void setbuf (FILE * stream , char * buf );[/i][/b] [b][/b] [b][i]void setbuffer (FILE * stream , char * buf , size_t size );[/i][/b] [b][/b] [b][i]void setlinebuf (FILE * stream );[/i][/b] [b][/b] [b][i]int setvbuf (FILE * stream , char * buf , int mode[/i][/b] [b][i], size_t size );[/i][/b] .ad [size=18] [b]Description[/b] [/size] Les trois types de buffers disponibles sont les suivants : pas de buffers, buffers de blocs, et buffers de lignes. Quand un flux de sortie n'a pas de buffer, les données apparaissent dans le fichier destination, ou sur le terminal, dès qu'elles sont écrites. Avec les buffers par blocs, une certaine quantité de données est conservée avant d'être écrite en tant que bloc. Avec les buffers de lignes, les caractères sont conservés jusqu'à ce qu'un saut de ligne soit transmis, ou que l'on réclame une lecture sur un flux attaché au terminal (typiquement stdin). La fonction [b]fflush (3)[/b] peut être utilisée pour forcer l'écriture à n'importe quel moment. (Voir [b]fclose (3).)[/b] Normalement tous les fichiers utilisent des buffers de blocs. Quand une première opération d'entrée/sortie se déroule sur un fichier, [b]malloc (3)[/b] est appelé, et un buffer est créé. Si le flux se rapporte à un terminal (comme [i]stdout[/i] habituellement) il s'agit d'un buffer de ligne. Le flux standard de sortie d'erreur [i]stderr[/i] n'a jamais de buffer par défaut. La fonction [b]setvbuf[/b] peut être utilisée sur n'importe quel flux ouvert pour modifier son type de buffer. La paramètre [i]mode[/i] doit correspondre à l'une des constantes symboliques suivantes :[table][row][col]    [/col][col] [b]_IONBF[/b] [table][row][col]    [/col][col]pas de buffer[/col][/row][/table] [b]_IOLBF[/b] [table][row][col]    [/col][col]buffer de ligne[/col][/row][/table] [b]_IOFBF[/b] [table][row][col]    [/col][col]buffer complet[/col][/row][/table][/col][/row][/table] A l'exception des fichiers sans buffers, l'argument [i]buf[/i] doit pointer sur un buffer contenant au moins [i]size[/i] octets. Ce nouveau buffer sera utilisé à la place de l'ancien. Si l'argument [i]buf[/i] est [b]NULL ,[/b] seul le mode est affecté. Un nouveau buffer sera alloué automatiquement lors de la prochaine opération de lecture ou d'écriture. La fonction [b]setvbuf[/b] ne peut être utilisée qu'après l'ouverture du flux, et avant toute opération dessus. Les trois autres appels sont, en fait, simplement des alias pour l'appel de [b]setvbuf .[/b] la fonction [b]setbuf[/b] est exactement équivalente à [table][row][col]    [/col][col] setvbuf(stream, buf, buf ? _IOFBF : _IONBF, BUFSIZ);[/col][/row][/table] La fonction [b]setbuffer[/b] est identique, sauf que la taille du buffer est indiquée par l'appelant plutôt que la valeur par défaut [b]BUFSIZ .[/b] La fonction [b]setlinebuf[/b] est exactement équivalente à : [table][row][col]    [/col][col] setvbuf(stream, (char *)NULL, _IOLBF, 0);[/col][/row][/table] [size=18] [b]Valeur renvoyée[/b] [/size] La fonction [b]setvbuf[/b] renvoie zéro si elle réussit. Elle peut renvoyer n'importe quelle valeur en cas d'échec, mais toujours une valeur non-nulle si le [i]mode[/i] est invalide, ou si la requête ne peut pas être honorée. Elle peut remplir [i]errno[/i] en cas d'erreur. Les autres fonctions ne renvoient rien.[/col][/row][/table] [size=18] [b]Conformité[/b] [/size] Les fonctions [b]setbuf[/b] et [b]setvbuf[/b] sont conformes à ANSI X3.159-1989 (``ANSI C''). [size=18] [b]Bugs[/b] [/size] Les fonctions [b]setbuffer[/b] et [b]setlinebuf[/b] ne sont pas portables sur les systèmes BSD antérieurs à 4.2BSD, et sont isponibles sous Linux depuis la LibC 4.5.21. Sur les systèmes 4.2BSD et 4.3BSD, [b]setbuf[/b] utilise toujours une taille de buffer non-optimale, et doit être évitée. Il faut toujours s'assurer que [i]buf[/i] et son contenu existent encore au moment de la fermeture du flux (qui se produit automatiquement à la fin du programme). Par exemple, ceci est INCORRECT : .nf #include <stdio.h> int main (void) { char buf [BUFSIZ]; setbuf (stdin, buf); printf ("Hello, world! "); return (0); } .fi [size=18] [b]Voir aussi[/b] [/size] [b]fclose (3),[/b] [b]fflush (3),[/b] [b]fopen (3),[/b] [b]fread (3),[/b] [b]malloc (3),[/b] [b]printf (3),[/b] [b]puts (3)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier