setbuf

void setbuf( FILE* stream, char* buffer );

void setbuf( FILE* restrict stream, char* restrict buffer );

#define BUFSIZ  /* unspecified */

Définit le tampon interne à utiliser pour les opérations sur le flux. Il doit mesurer au moins BUFSIZ caractères.

Si buffer n'est pas nul, équivaut à setvbuf(stream, buffer, _IOFBF, BUFSIZ).

Si buffer est nul, équivaut à setvbuf(stream, NULL, _IONBF, 0), ce qui désactive la mise en tampon.

Paramètres

Notes

Si BUFSIZ n'est pas la taille de tampon appropriée, setvbuf peut être utilisé pour la modifier.

setvbuf devrait également être utilisé pour détecter les erreurs, car setbuf n'indique pas le succès ou l'échec.

Cette fonction ne peut être utilisée qu'après que stream a été associé à un fichier ouvert, mais avant toute autre opération (autre qu'un appel échoué à setbuf/setvbuf).

Une erreur courante consiste à définir le tampon de stdin ou stdout sur un tableau dont la durée de vie se termine avant la fin du programme :

int main(void)
{
    char buf[BUFSIZ];
    setbuf(stdin, buf);
} // lifetime of buf ends, undefined behavior

Exemple

#include <stdio.h>
#include <threads.h>

int main(void)
{
    setbuf(stdout, NULL); // unbuffered stdout
    putchar('a'); // 'a' appears immediately if stdout is unbuffered
    thrd_sleep(&(struct timespec){ .tv_sec = 1 }, NULL); // sleep 1 sec
    putchar('b');
}

ab

Références

Voir aussi