fputs, fputwsfputs, fputws

스트림에 문자열을 씁니다.Writes a string to a stream.

구문Syntax

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

매개 변수Parameters

str
출력 문자열입니다.Output string.

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

반환 값Return Value

이러한 각 함수는 성공할 경우 음수가 아닌 값을 반환합니다.Each of these functions returns a nonnegative value if it is successful. 오류 발생 시 fputsfputwsEOF를 반환합니다.On an error, fputs and fputws return EOF. str 또는 stream이 null 포인터이면 이러한 함수는 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기를 호출합니다.If str or stream is a null pointer, these functions invoke the invalid parameter handler, as described in Parameter Validation. 계속해서 실행하도록 허용된 경우 이러한 함수는 errnoEINVAL로 설정하고 fputsEOF를 반환하고 fputwsWEOF를 반환합니다.If execution is allowed to continue, these functions set errno to EINVAL and then fputs returns EOF, and fputws returns WEOF.

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

설명Remarks

이러한 각 함수는 str를 현재 위치의 출력 stream에 복사합니다.Each of these functions copies str to the output stream at the current position. fputwsstream이 텍스트 모드로 열리는지, 아니면 이진 모드로 열리는지에 따라 와이드 문자 인수 strstream에 각각 멀티바이트 문자열 또는 와이드 문자열로 복사합니다.fputws copies the wide-character argument str to stream as a multibyte-character string or a wide-character string according to whether stream is opened in text mode or binary mode, respectively. 어떤 함수도 null 종결 문자를 복사하지 않습니다.Neither function copies the terminating null character.

스트림이 ANSI 모드에서 열리는 경우 두 함수는 동일하게 작동합니다.The two functions behave identically if the stream is opened in ANSI mode. fputs는 현재 UNICODE 스트림에 대한 출력을 지원하지 않습니다.fputs does not currently support output into a UNICODE stream.

제네릭 텍스트 루틴 매핑Generic-Text Routine Mappings

TCHAR.H 루틴TCHAR.H routine _UNICODE 및 _MBCS 정의되지 않음_UNICODE & _MBCS not defined _MBCS 정의됨_MBCS defined _UNICODE 정의됨_UNICODE defined
_fputts fputs fputs fputws

요구 사항Requirements

함수Function 필수 헤더Required header
fputs <stdio.h><stdio.h>
fputws <stdio.h> 또는 <wchar.h><stdio.h> or <wchar.h>

콘솔 유니버설 Windows 플랫폼 (UWP) 응용 프로그램에서 지원 되지 않습니다.The console is not supported in Universal Windows Platform (UWP) apps. 콘솔에 연결된 된 표준 스트림 핸들-stdin, stdout, 및 stderr-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. 호환성에 대한 자세한 내용은 호환성을 참조하세요.For additional compatibility information, see Compatibility.

Example

// 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.  

참고 항목See Also

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