fputc
, fputwc
스트림에 문자를 씁니다.
구문
int fputc(
int c,
FILE *stream
);
wint_t fputwc(
wchar_t c,
FILE *stream
);
매개 변수
c
쓸 문자입니다.
stream
FILE
구조체에 대한 포인터입니다.
반환 값
이러한 각 함수는 기록된 문자를 반환합니다. fputc
의 경우 EOF
의 반환 값은 오류를 나타냅니다. fputwc
의 경우 WEOF
의 반환 값은 오류를 나타냅니다. 이 경우 stream
이러한 함수는 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기를 호출합니다.NULL
계속해서 실행하도록 허용된 경우, 이러한 함수는 EOF
을 반환하고 errno
를 EINVAL
로 설정합니다.
반환 코드에 대한 자세한 내용은 , , 및 를 참조하세요errno
._sys_nerr
_sys_errlist
_doserrno
설명
이러한 각 함수는 정의된 경우 연결된 파일 위치 표시기가 나타내는 위치에 있는 파일에 단일 문자를 c
씁니다. 함수는 표시기를 적절하게 진행합니다. In fputc
및 fputwc
, 파일은 .와 stream
연결됩니다. 파일이 위치 지정 요청을 지원할 수 없거나 추가 모드에서 열린 경우 문자가 스트림의 끝에 추가됩니다.
스트림이 ANSI 모드에서 열리는 경우 두 함수는 동일하게 작동합니다. fputc
는 현재 UNICODE 스트림에 대한 출력을 지원하지 않습니다.
_nolock
접미사가 있는 버전은 다른 스레드에 의한 간섭에서 보호되지 않는 점을 제외하면 동일합니다. 자세한 내용은 다음을 참조하세요_fputwc_nolock
_fputc_nolock
.
이어서 루틴별 설명이 제공됩니다.
루틴에서 반환된 값 | 설명 |
---|---|
fputc |
putc 와 일치하지만 함수 및 매크로가 아니라 함수로만 구현됩니다. |
fputwc |
와이드 문자 버전의 fputc 입니다. c 각각 텍스트 모드 또는 이진 모드에서 열릴 때 stream 멀티바이트 문자 또는 와이드 문자로 씁니다. |
기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT 전역 상태를 참조하세요.
일반 텍스트 루틴 매핑
TCHAR.H 루틴 | _UNICODE 및 _MBCS 정의되지 않음 |
정의된 _MBCS |
정의된 _UNICODE |
---|---|---|---|
_fputtc |
fputc |
fputc |
fputwc |
요구 사항
함수 | 필수 헤더 |
---|---|
fputc |
<stdio.h> |
fputwc |
<stdio.h> 또는 <wchar.h> |
UWP(유니버설 Windows 플랫폼) 앱에서는 콘솔이 지원되지 않습니다. 콘솔에 연결된 표준 스트림 핸들, stdin
, stdout
및 stderr
은 UWP 앱의 C 런타임 함수에서 사용되기 전에 리디렉션되어야 합니다. 호환성에 대한 자세한 내용은 호환성을 참조하세요.
예시
// crt_fputc.c
// This program uses fputc
// to send a character array to stdout.
#include <stdio.h>
int main( void )
{
char strptr1[] = "This is a test of fputc!!\n";
char *p;
// Print line to stream using fputc.
p = strptr1;
while( (*p != '\0') && fputc( *(p++), stdout ) != EOF ) ;
}
This is a test of fputc!!