setvbuf

int setvbuf( FILE* stream, char* buffer,
             int mode, size_t size );

int setvbuf( FILE* restrict stream, char* restrict buffer,
             int mode, size_t size );

#define _IOFBF     /* unspecified */
#define _IOLBF     /* unspecified */
#define _IONBF     /* unspecified */

(seit C99)streamÄndert den Puffermodus des angegebenen Dateistroms mode wie durch das Argument

• angegeben. Zusätzlich, bufferFalls size ein Nullzeiger ist, wird der interne Puffer auf
• vergrößert.bufferFalls size kein Nullzeiger ist, wird der Strom angewiesen, den vom Benutzer bereitgestellten Puffer der Größe buffer ab zu verwenden. Der Strom muss geschlossen werden (mit fclose) bevor die Lebensdauerbuffer des Arrays, auf das setvbuf zeigt, endet. Der Inhalt des Arrays nach einem erfolgreichen Aufruf von

Siehe auch

Rückgabewert

0 bei Erfolg oder ungleich Null bei Fehler.

Hinweise

Diese Funktion darf nur verwendet werden, nachdem stream mit einer geöffneten Datei verknüpft wurde, aber vor jeder anderen Operation (außer einem fehlgeschlagenen Aufruf von setbuf/setvbuf).

Nicht alle size Bytes werden notwendigerweise für die Pufferung verwendet: Die tatsächliche Puffergröße wird normalerweise auf ein Vielfaches von 2, ein Vielfaches der Seitengröße usw. abgerundet.

In vielen Implementierungen ist Zeilenpufferung nur für Terminal-Eingabestreams verfügbar.

Ein häufiger Fehler ist das Setzen des Puffers von stdin oder stdout auf ein Array, dessen Lebensdauer vor Programmende endet:

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

Die standardmäßige Puffergröße BUFSIZ gilt als die effizienteste Puffergröße für Datei-E/A in der Implementierung, aber POSIX fstat bietet oft eine bessere Schätzung.

Beispiel

// Make some POSIX functions, such as ‘int fileno(FILE*)’, visible:
#define _POSIX_SOURCE

#include <stdio.h>
#include <stdlib.h>
#include <sys/stat.h>

int main(void)
{
    FILE* fp = fopen("/tmp/test.txt", "w+");
    if (fp == NULL)
    {
        perror("fopen");
        return EXIT_FAILURE;
    }

    struct stat stats;
    if (fstat(fileno(fp), &stats) == -1) // POSIX only
    {
        perror("fstat");
        return EXIT_FAILURE;
    }

    printf("BUFSIZ is %d, but optimal block size is %ld\n", BUFSIZ, stats.st_blksize);
    if (setvbuf(fp, NULL, _IOFBF, stats.st_blksize) != 0)
    {
        perror("setvbuf failed"); // POSIX version sets errno
        return EXIT_FAILURE;
    }

    int ch;
    while((ch=fgetc(fp)) != EOF); // read entire file: use truss/strace to
                                  // observe the read(2) syscalls used
    fclose(fp);
    return EXIT_SUCCESS;
}

BUFSIZ is 8192, but optimal block size is 65536

Referenzen

Siehe auch