putc, putwc

  • 아티클

스트림에 문자를 씁니다.

구문

int putc(
   int c,
   FILE *stream
);
wint_t putwc(
   wchar_t c,
   FILE *stream
);

매개 변수

c
쓸 문자입니다.

stream
FILE 구조체에 대한 포인터입니다.

반환 값

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

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

설명

putc 루틴은 현재 위치에서 출력 stream에 단일 문자(c)를 씁니다. putc에는 모든 정수를 전달할 수 있지만 하위 8비트만 기록됩니다. 루틴은 putcharputc( c, stdout ). 각 루틴에 대해 읽기 오류가 발생하는 경우 스트림에 대한 오류 표시기가 설정됩니다. putcputchar 은 각각 유사 fputc 하지만 _fputchar함수와 매크로로 모두 구현됩니다(함수와 매크로 중에서 선택하기 위한 권장 사항 참조). putwc 및 putwchar은 각각 putc 및 putchar의 와이드 문자 버전입니다. 스트림이 ANSI 모드에서 열리는 경우 putwc 및 putc가 동일하게 작동합니다. putc는 현재 UNICODE 스트림에 대한 출력을 지원하지 않습니다.

접미사가 있는 _nolock 버전은 다른 스레드의 간섭으로부터 보호되지 않는다는 점을 제외하고 동일합니다. 자세한 내용은 _putc_nolock, _putwc_nolock을 참조하세요.

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT의 전역 상태를 참조하세요.

일반 텍스트 루틴 매핑

TCHAR.H 루틴 _UNICODE 정의 _MBCS 되지 않음 _MBCS 정의 _UNICODE 정의
_puttc putc putc putwc

요구 사항

루틴에서 반환된 값 필수 헤더
putc <stdio.h>
putwc <stdio.h> 또는 <wchar.h>

콘솔은 UWP(유니버설 Windows 플랫폼) 앱에서 지원되지 않습니다. C 런타임 함수가 UWP 앱에서 사용할 수 있기 전에 콘솔stdinstdout, 및 , 및stderr와 연결된 표준 스트림 핸들을 리디렉션해야 합니다. 호환성에 대한 자세한 내용은 호환성을 참조하세요.

라이브러리

모든 버전의 C 런타임 라이브러리입니다.

예시

// crt_putc.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;
   /* Make standard out the stream and write to it. */
   stream = stdout;
   for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )
      ch = putc( *p, stream );
}

출력

This is the line of output

참고 항목

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