CKTIS / C
setvbuf — configurer la mise en mémoire tampon d’un flux
setvbuf choisit le mode de mise en mémoire tampon d’un flux ouvert avant toute autre opération et permet d’utiliser un tampon fourni par l’appelant.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <stdio.h>
int setvbuf(FILE * restrict stream, char * restrict buf, int mode, size_t size);Appelez setvbuf de <stdio.h> après l’ouverture du flux et avant toute autre opération sur celui-ci ; un appel infructueux à setvbuf constitue l’exception.
mode : _IOFBF — mise en mémoire tampon complète, _IOLBF — mise en mémoire tampon ligne par ligne, _IONBF — aucune mise en mémoire tampon. La valeur de retour 0 signifie que l’appel a réussi ; une valeur non nulle indique un mode invalide ou une demande qui n’a pas pu être satisfaite.
Si buf != NULL, size indique la taille du tableau ; la bibliothèque peut utiliser ce tableau. Gardez-le en mémoire jusqu’à la fermeture du flux ; son contenu n’est pas spécifié. Si buf == NULL, la bibliothèque peut utiliser size lors de l’allocation d’un tampon.
L’exemple ferme stream avant que le buffer local cesse d’exister. Quitter le bloc sans fermer le flux provoquerait un comportement indéfini.
Exemples
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
char buffer[BUFSIZ];
FILE *stream = tmpfile();
if (stream == NULL)
return EXIT_FAILURE;
if (setvbuf(stream, buffer, _IOFBF, sizeof buffer) != 0) {
fclose(stream);
return EXIT_FAILURE;
}
int failed = fputs("Hello\n", stream) == EOF;
if (fclose(stream) == EOF)
failed = 1;
if (failed)
return EXIT_FAILURE;
return puts("OK") == EOF ? EXIT_FAILURE : EXIT_SUCCESS;
}
Résultat
OK
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.