putchar, putwchar

  • 아티클

stdout에 문자를 씁니다.

구문

int putchar(
   int c
);
wint_t putwchar(
   wchar_t c
);

매개 변수

c
쓸 문자입니다.

반환 값

쓴 문자를 반환합니다. 오류 또는 파일 끝 조건을 putc 나타내고 putchar ; putwc 를 반환EOF하고 putwchar 반환WEOF합니다. 네 가지 루틴 모두에 대해 오류 또는 feof 파일 끝에 대해 검사.ferror null 포인터를 stream전달한 경우 이러한 함수는 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 예외를 생성합니다. 실행을 계속하도록 허용된 경우 반환 EOF 또는 WEOF로 설정 errno 됩니다 EINVAL.

반환 코드에 대한 자세한 내용은 , , 및 를 참조하세요errno._sys_nerr_sys_errlist_doserrno

설명

putc 루틴은 현재 위치에서 출력 stream에 단일 문자(c)를 씁니다. putc에는 모든 정수를 전달할 수 있지만 하위 8비트만 기록됩니다. 루틴은 putcharputc( 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 플랫폼) 앱에서 지원되지 않습니다. C 런타임 함수가 UWP 앱에서 사용할 수 있기 전에 콘솔stdinstdout, 및 , 및stderr와 연결된 표준 스트림 핸들을 리디렉션해야 합니다. 호환성에 대한 자세한 내용은 호환성을 참조하세요.

라이브러리

모든 버전의 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

참고 항목

스트림 I/O
fputc, fputwc
getc, getwc