putchar, putwchar
stdout에 문자를 씁니다.
구문
int putchar(
int c
);
wint_t putwchar(
wchar_t c
);
매개 변수
c
쓸 문자입니다.
반환 값
쓴 문자를 반환합니다. 오류 또는 파일 끝 조건을 putc 나타내고 putchar ; putwc 를 반환EOF하고 putwchar 반환WEOF합니다. 네 가지 루틴 모두에 대해 오류 또는 파일의 끝을 사용 ferror 하거나 feof 확인합니다. null 포인터를 stream전달한 경우 이러한 함수는 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 예외를 생성합니다. 실행을 계속하도록 허용된 경우 반환 EOF 또는 WEOF로 설정 errno 됩니다 EINVAL.
반환 코드에 대한 자세한 내용은 , , 및 를 참조하세요errno._sys_nerr_sys_errlist_doserrno
설명
putc 루틴은 현재 위치에서 출력 stream에 단일 문자(c)를 씁니다. putc에는 모든 정수를 전달할 수 있지만 하위 8비트만 기록됩니다. 루틴은 putchar putc( c, stdout ). 각 루틴에 대해 읽기 오류가 발생하는 경우 스트림에 대한 오류 표시기가 설정됩니다. putcputchar 은 각각 유사 fputc 하지만 _fputchar함수와 매크로로 모두 구현됩니다(함수와 매크로 중에서 선택하기 위한 권장 사항 참조). putwc 및 putwchar은 각각 putc 및 putchar의 와이드 문자 버전입니다.
_nolock 접미사가 있는 버전은 다른 스레드에 의한 간섭에서 보호되지 않는 점을 제외하면 동일합니다. 이러한 버전에서는 다른 스레드를 잠그는 오버헤드가 발생하지 않으므로 속도가 더 빠를 수 있습니다. 단일 스레드 애플리케이션과 같은 스레드로부터 안전한 컨텍스트 또는 이미 스레드 격리를 처리한 호출 범위에서만 이러한 함수를 사용합니다.
기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT 전역 상태를 참조하세요.
일반 텍스트 루틴 매핑
| TCHAR.H 루틴 | _UNICODE 및 _MBCS 정의되지 않음 |
정의된 _MBCS |
정의된 _UNICODE |
|---|---|---|---|
_puttchar |
putchar |
putchar |
putwchar |
요구 사항
| 루틴에서 반환된 값 | 필수 헤더 |
|---|---|
putchar |
<stdio.h> |
putwchar |
<stdio.h> 또는 <wchar.h> |
UWP(유니버설 Windows 플랫폼) 앱에서는 콘솔이 지원되지 않습니다. 콘솔에 연결된 표준 스트림 핸들, stdin, stdout 및 stderr은 UWP 앱의 C 런타임 함수에서 사용되기 전에 리디렉션되어야 합니다. 호환성에 대한 자세한 내용은 호환성을 참조하세요.
라이브러리
모든 버전의 C 런타임 라이브러리입니다.
예시
// crt_putchar.c
/* This program uses putc to write buffer
* to a stream. If an error occurs, the program
* stops before writing the entire buffer.
*/
#include <stdio.h>
int main( void )
{
FILE *stream;
char *p, buffer[] = "This is the line of output\n";
int ch;
ch = 0;
for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )
ch = putchar( *p );
}
출력
This is the line of output