Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

setbuf — configurer la mise en tampon d’un flux

`setbuf`, déclarée dans `<stdio.h>`, demande une mise en tampon complète si `buf` n’est pas `NULL`, ou un fonctionnement sans tampon si `buf` vaut `NULL`. L’implémentation peut utiliser le tableau fourni, mais n’y est pas tenue. La fonction n’indique pas si la demande a été satisfaite.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <stdio.h>
void setbuf(FILE * restrict stream, char * restrict buf);

setbuf(stream, buf) demande un mode de mise en tampon pour un flux ouvert. Si buf n’est pas NULL, la fonction demande une mise en tampon complète (_IOFBF) avec une taille de BUFSIZ. L’implémentation peut utiliser le tableau fourni comme tampon, mais n’y est pas tenue. Passer NULL demande un fonctionnement sans tampon (_IONBF).

Appelez cette fonction avant toute autre opération sur le flux ; seul un appel à setvbuf qui a échoué peut la précéder. Si buf n’est pas NULL, il doit pointer vers un tableau modifiable d’au moins BUFSIZ octets dont la durée de vie s’étend jusqu’à la fermeture du flux. Le contenu du tableau n’est pas spécifié.

La fonction renvoie void et ne peut donc pas indiquer si la demande a été satisfaite. setvbuf renvoie un code d’état, permet de choisir la taille du tampon et prend en charge la mise en tampon par ligne (_IOLBF).

Exemples

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    static char buffer[BUFSIZ];
    setbuf(stdout, buffer);

    if (puts("Hello") == EOF) {
        return EXIT_FAILURE;
    }
    if (fflush(stdout) == EOF) {
        return EXIT_FAILURE;
    }
    return EXIT_SUCCESS;
}

Résultat

Hello

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources