putc, putwcputc, putwc

스트림에 문자를 씁니다.Writes a character to a stream.

구문Syntax

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

매개 변수Parameters

cc
쓸 문자입니다.Character to be written.

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

Return ValueReturn Value

쓴 문자를 반환합니다.Returns the character written. 오류 또는 파일 끝 조건을 나타내려면 putcPutcEOF를 반환 합니다. putwcPutwchar 는 weof를 반환 합니다.To indicate an error or end-of-file condition, putc and putchar return EOF; putwc and putwchar return WEOF. 4개 루틴 모두에 대해 ferror 또는 feof를 사용하여 오류 또는 파일 끝을 확인합니다.For all four routines, use ferror or feof to check for an error or end of file. 스트림에대 한 null 포인터를 전달 하는 경우 매개 변수 유효성 검사에 설명 된 대로 잘못 된 매개 변수 처리기가 호출 됩니다.If passed a null pointer for stream, the invalid parameter handler is invoked, as described in Parameter Validation. 계속 해 서 실행 하도록 허용한 경우 이러한 함수는 EOF 또는 weof 를 반환 하 고 errnoEINVAL로 설정 합니다.If execution is allowed to continue, these functions return EOF or WEOF and set errno to EINVAL.

이러한 오류 코드 및 기타 오류 코드에 대한 자세한 내용은 _doserrno, errno, _sys_errlist 및 _sys_nerr를 참조하세요.See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on these, and other, error codes.

설명Remarks

Putc 루틴은 단일 문자 c 를 현재 위치의 출력 스트림에 씁니다.The putc routine writes the single character c to the output stream at the current position. 모든 정수를 putc에 전달할 수 있지만 하위 8 비트만 기록 됩니다.Any integer can be passed to putc, but only the lower 8 bits are written. Putchar 루틴은와 동일 putc( c, stdout )합니다.The putchar routine is identical to putc( c, stdout ). 각 루틴에 대해 읽기 오류가 발생하는 경우 스트림에 대한 오류 표시기가 설정됩니다.For each routine, if a read error occurs, the error indicator for the stream is set. putcputc 는 각각 fputc_fputchar와 유사 하지만 함수 및 매크로로 구현 됩니다 ( 함수와 매크로 중 선택참조).putc and putchar are similar to fputc and _fputchar, respectively, but are implemented both as functions and as macros (see Choosing Between Functions and Macros). putwcputwchar 는 각각 putwcharputwchar의 와이드 문자 버전입니다.putwc and putwchar are wide-character versions of putc and putchar, respectively. putwcPUTC 는 ANSI 모드에서 스트림이 열린 경우 동일 하 게 동작 합니다.putwc and putc behave identically if the stream is opened in ANSI mode. putc 는 현재 UNICODE 스트림에 대 한 출력을 지원 하지 않습니다.putc doesn't currently support output into a UNICODE stream.

_nolock 접미사가 있는 버전은 다른 스레드에 의한 간섭에서 보호되지 않는 점을 제외하면 동일합니다.The versions with the _nolock suffix are identical except that they are not protected from interference by other threads. 자세한 내용은 _putc_nolock, _putwc_nolock을 참조하세요.For more information, see _putc_nolock, _putwc_nolock.

기본적으로이 함수의 전역 상태는 응용 프로그램으로 범위가 지정 됩니다.By default, this function's global state is scoped to the application. 이를 변경 하려면 CRT의 전역 상태를 참조 하세요.To change this, see Global state in the CRT.

제네릭 텍스트 라우팅 매핑Generic-Text Routine Mappings

TCHAR.H 루틴TCHAR.H routine _UNICODE 및 _MBCS 정의되지 않음_UNICODE & _MBCS not defined _MBCS 정의됨_MBCS defined _UNICODE 정의됨_UNICODE defined
_puttc_puttc putcputc putcputc putwcputwc

요구 사항Requirements

루틴에서 반환된 값Routine 필수 헤더Required header
putcputc <stdio.h><stdio.h>
putwcputwc <stdio.h> 또는 <wchar.h><stdio.h> or <wchar.h>

이 콘솔은 UWP (유니버설 Windows 플랫폼) 앱에서 지원 되지 않습니다.The console is not supported in Universal Windows Platform (UWP) apps. 콘솔, stdin, stdoutstderr에 연결 된 표준 스트림 핸들은 C 런타임 함수가 UWP 앱에서 사용할 수 있으려면 먼저 리디렉션해야 합니다.The standard stream handles that are associated with the console, stdin, stdout, and stderr, must be redirected before C run-time functions can use them in UWP apps. 호환성에 대한 자세한 내용은 Compatibility을 참조하세요.For additional compatibility information, see Compatibility.

라이브러리Libraries

모든 버전의 C 런타임 라이브러리입니다.All versions of the C run-time libraries.

예제Example

// 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 );
}

출력Output

This is the line of output

참조See also

스트림 I/OStream I/O
fputc, fputwcfputc, fputwc
getc, getwcgetc, getwc