fwrite

Artykuł
06/09/2015

Zapisuje dane w strumieniu.

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

Parametry

buffer
Wskaźnik do danych do zapisania.
size
Rozmiar elementu w bajtach.
count
Maksymalna liczba elementów do zapisania.
stream
Wskaźnik do FILE struktury.

Wartość zwracana

fwriteZwraca liczbę pełnych rzeczywiście zapisanych elementów, które mogą być mniejsza niż count w przypadku wystąpienia błędu.Ponadto w przypadku wystąpienia błędu, nie można określić wskaźnik położenie pliku.Jeśli jedna z metod stream lub buffer wskaźnik null lub jeśli nieparzysta liczba bajtów do zapisania jest określona w trybie Unicode, funkcja wywołuje program obsługi nieprawidłowy parametr, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli jest dozwolone wykonywanie aby kontynuować, ta funkcja ustawia errno do EINVAL i zwraca wartość 0.

Uwagi

fwrite Funkcji zapisuje do count elementów, z size długości, z buffer w wyniku stream.Wskaźnik plików skojarzonych z stream (jeśli istnieje) jest zwiększany przez liczbę bajtów zapisanych w rzeczywistości.Jeśli stream jest otwarty w trybie tekst każdego wysuwu wiersza zostanie zastąpiony powrotu karetki — pary wysuwu wiersza.Zastąpienie nie ma wpływu na wartość zwracaną.

Po stream jest otwarta w trybie translacji Unicode — na przykład, jeśli stream jest otwarty przez wywołanie metody fopen i za pomocą parametru tryb, który zawiera ccs=UNICODE, ccs=UTF-16LE, lub ccs=UTF-8, lub jeśli tryb zostało zmienione w trybie translacji Unicode przy użyciu _setmode i parametr tryb, który zawiera _O_WTEXT, _O_U16TEXT, lub _O_U8TEXT—buffer jest interpretowany jako wskaźnik do tablicy wchar_t zawierający dane UTF-16.Próba zapisu nieparzysta liczba bajtów w tym trybie powoduje błąd sprawdzania poprawności parametru.

Ta funkcja blokady wywołującego wątku, dlatego jest bezpieczeństwa wątków.Wersja bez blokowania dla _fwrite_nolock.