fwritefwrite

스트림에 데이터를 씁니다.Writes data to a stream.

구문Syntax

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

매개 변수Parameters

bufferbuffer
쓸 데이터에 대한 포인터입니다.Pointer to data to be written.

sizesize
항목 크기입니다(바이트).Item size, in bytes.

countcount
쓸 항목의 최대 수입니다.Maximum number of items to be written.

스트림stream
FILE 구조체에 대한 포인터입니다.Pointer to FILE structure.

반환 값Return Value

fwrite 전체 개수를 반환 일 수 있는 실제로 기록 된 항목 보다 작거나 개수 오류가 발생 한 경우.fwrite returns the number of full items actually written, which may be less than count if an error occurs. 또한 오류가 발생하면 파일 위치 표시기를 확인할 수 없습니다.Also, if an error occurs, the file-position indicator cannot be determined. 이면 스트림을 하거나 버퍼 가 null 포인터인 경우 또는 유니코드 모드에서 홀수 바이트를 쓰도록가 지정 하는 경우 함수에 설명 된 대로 잘못 된 매개 변수 처리기를을 호출 하는 매개 변수 유효성 검사합니다.If either stream or buffer is a null pointer, or if an odd number of bytes to be written is specified in Unicode mode, the function invokes the invalid parameter handler, as described in Parameter Validation. 이 함수를 설정 하는 경우는 계속 실행 하도록 허용 합니다 errnoEINVAL 0을 반환 합니다.If execution is allowed to continue, this function sets errno to EINVAL and returns 0.

설명Remarks

합니다 fwrite 함수 작성 개수 항목의 크기 길이 각각에서 버퍼 출력에 stream.The fwrite function writes up to count items, of size length each, from buffer to the output stream. 연결 된 파일 포인터 스트림을 (있는 경우)는 실제로 쓴 바이트 수가 씩 증가 합니다.The file pointer associated with stream (if there is one) is incremented by the number of bytes actually written. 하는 경우 스트림을 열릴 텍스트 모드에서 각 줄 바꿈은 캐리지 리턴-줄 바꿈 쌍으로 바뀝니다.If stream is opened in text mode, each linefeed is replaced with a carriage-return - linefeed pair. 이렇게 바뀌더라도 반환 값에는 영향을 미치지 않습니다.The replacement has no effect on the return value.

스트림 유니코드 변환 모드로 열리면-예를 들어, 경우 스트림 를 호출 하 여 열 fopen 포함 하는 모드 매개 변수를 사용 하 여 및 ccs = 유니코드, ccs = u t F-16LE, 또는 ccs = u t F-8를 사용 하 여 모드를 유니코드 변환 모드로 변경 된 경우 또는 _setmode 와 모드 매개 변수를 포함 하는 _O_WTEXT, _O_U16TEXT, 또는 _O_U8TEXT-버퍼 포인터로 해석 되는 배열을 wchar_t utf-16 형식으로 데이터를 포함 하는 합니다.When stream is opened in Unicode translation mode—for example, if stream is opened by calling fopen and using a mode parameter that includes ccs=UNICODE, ccs=UTF-16LE, or ccs=UTF-8, or if the mode is changed to a Unicode translation mode by using _setmode and a mode parameter that includes _O_WTEXT, _O_U16TEXT, or _O_U8TEXTbuffer is interpreted as a pointer to an array of wchar_t that contains UTF-16 data. 이 모드에서 홀수 바이트를 쓰려고 하면 매개 변수 유효성 검사 오류가 발생합니다.An attempt to write an odd number of bytes in this mode causes a parameter validation error.

이 함수는 호출 스레드를 잠그기 때문에 스레드로부터 안전하게 보호됩니다.Because this function locks the calling thread, it is thread-safe. 잠기지 않은 버전을 참조 하세요 _fwrite_nolock합니다.For a non-locking version, see _fwrite_nolock.

요구 사항Requirements

기능Function 필수 헤더Required header
fwritefwrite <stdio.h><stdio.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.For additional compatibility information, see Compatibility.

예제Example

fread의 예제를 참조하세요.See the example for fread.

참고자료See also

스트림 I/OStream I/O
_setmode_setmode
freadfread
_fwrite_nolock_fwrite_nolock
_write_write