fwrite

size_t fwrite( const void* buffer, size_t size, size_t count,
               FILE* stream );

size_t fwrite( const void* restrict buffer, size_t size, size_t count,
               FILE* restrict stream );

Schreibt count Objekte aus dem angegebenen Array buffer in den Ausgabestrom stream. Die Objekte werden geschrieben, als ob jedes Objekt als ein Array von unsigned char interpretiert und fputc size mal für jedes Objekt aufgerufen würde, um diese unsigned chars der Reihe nach in stream zu schreiben. Der Dateipositionszeiger für den Strom wird um die Anzahl der geschriebenen Zeichen weitergesetzt.

Tritt ein Fehler auf, ist der resultierende Wert des Dateipositionszeigers für den Strom unbestimmt.

Parameter

Rückgabewert

Die Anzahl der erfolgreich geschriebenen Objekte, die nur dann kleiner als count ist, wenn ein Fehler auftritt.

Wenn size oder count Null ist, gibt fwrite Null zurück und führt keine weitere Aktion aus.

Beispiel

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

enum { SIZE = 5 };

int main(void)
{
    double a[SIZE] = {1, 2, 3, 4, 5};
    FILE* f1 = fopen("file.bin", "wb");
    assert(f1);
    size_t r1 = fwrite(a, sizeof a[0], SIZE, f1);
    printf("wrote %zu elements out of %d requested\n", r1, SIZE);
    fclose(f1);

    double b[SIZE];
    FILE* f2 = fopen("file.bin", "rb");
    size_t r2 = fread(b, sizeof b[0], SIZE, f2);
    fclose(f2);
    printf("read back: ");
    for (size_t i = 0; i < r2; ++i)
        printf("%0.2f ", b[i]);
}

wrote 5 elements out of 5 requested
read back: 1.00 2.00 3.00 4.00 5.00

Referenzen

Siehe auch