Namespaces
Variants

fwrite

cppreference.net에서
< c | io
 
 
파일 입출력
타입과 객체
        
함수
파일 접근
(C95)
비형식 입출력
(C95)(C95)
(C95)
(C95)(C95)
(C95)
(C95)

형식 입력
 
헤더 <stdio.h>
size_t fwrite( const void* buffer, size_t size, size_t count,
               FILE* stream );
에 정의됨 (C99까지)
size_t fwrite( const void* restrict buffer, size_t size, size_t count,
               FILE* restrict stream );
(C99부터)

count개의 객체를 주어진 배열 buffer에서 출력 스트림 stream에 씁니다. 객체는 각 객체를 unsigned char의 배열로 재해석하고 각 객체에 대해 fputc size번 호출하여 그 unsigned char들을 stream에 순서대로 쓰는 것처럼 기록됩니다. 스트림의 파일 위치 표시자는 쓰여진 문자 수만큼 전진합니다.

오류가 발생하면 스트림의 파일 위치 표시자 결과값은 불확정적입니다.

매개변수

buffer - 쓸 배열의 첫 번째 객체를 가리키는 포인터
size - 각 객체의 크기
count - 쓸 객체의 개수
stream - 출력 스트림을 가리키는 포인터

반환값

성공적으로 쓰여진 객체의 수. 오류가 발생한 경우에만 count보다 작습니다.

size 또는 count가 0이면 fwrite은 0을 반환하고 다른 동작을 수행하지 않습니다.

예제

#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

참조

  • C23 표준 (ISO/IEC 9899:2024):
  • 7.21.8.2 fwrite 함수 (p: TBD)
  • C17 표준 (ISO/IEC 9899:2018):
  • 7.21.8.2 fwrite 함수 (p: TBD)
  • C11 표준 (ISO/IEC 9899:2011):
  • 7.21.8.2 fwrite 함수 (p: 335-336)
  • C99 표준 (ISO/IEC 9899:1999):
  • 7.19.8.2 fwrite 함수 (p: 301-302)
  • C89/C90 표준 (ISO/IEC 9899:1990):
  • 4.9.8.2 fwrite 함수

같이 보기

형식화된 출력을 stdout, 파일 스트림 또는 버퍼에 출력합니다
(함수)
파일 스트림에 문자 문자열을 씁니다
(함수)
파일에서 읽습니다
(함수)
C++ 문서를 위한 fwrite