fputs, fputws

스트림에 문자열을 씁니다.

구문

int fputs(
   const char *str,
   FILE *stream
);
int fputws(
   const wchar_t *str,
   FILE *stream
);

매개 변수

str
출력 문자열입니다.

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

반환 값

이러한 각 함수는 성공하면 음수 값을 반환합니다. 오류 발생 시 fputs 및 fputws는 EOF를 반환합니다. null 포인터이거나 stream null 포인터인 경우 str 이러한 함수는 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기를 호출합니다. 실행을 계속하도록 허용된 경우 이러한 함수는 다음으로 EINVAL 설정 errno 되고 반환됩니다EOF.

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

설명

이러한 각 함수는 str를 현재 위치의 출력 stream에 복사합니다. fputws는 각각 텍스트 모드 또는 이진 모드에서 열릴 때 stream 와이드 문자 인수 strstream 를 멀티바이트 문자열 또는 와이드 문자열로 복사합니다. 어떤 함수도 null 종결 문자를 복사하지 않습니다.

스트림이 ANSI 모드에서 열리는 경우 두 함수는 동일하게 작동합니다. fputs는 현재 UNICODE 스트림에 대한 출력을 지원하지 않습니다.

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

일반 텍스트 루틴 매핑

TCHAR.H 루틴	_UNICODE 정의 _MBCS 되지 않음	_MBCS 정의	_UNICODE 정의
_fputts	fputs	fputs	fputws

요구 사항

함수	필수 헤더
fputs	<stdio.h>
fputws	<stdio.h> 또는 <wchar.h>

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

예시

// crt_fputs.c
// This program uses fputs to write
// a single line to the stdout stream.

#include <stdio.h>

int main( void )
{
   fputs( "Hello world from fputs.\n", stdout );
}

Hello world from fputs.

참고 항목

스트림 I/O
fgets, fgetws
gets, _getws
puts, _putws