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 ValueReturn 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를 반환 하며 fputws 는 weof를 반환 합니다.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 을 현재 위치의 출력 스트림으로 복사 합니다.Each of these functions copies str to the output stream at the current position. fputws스트림을 텍스트 모드에서 열지 아니면 이진 모드로 열지에 따라 와이드 문자 인수 str 를 멀티 바이트 문자열 또는 와이드 문자열로 복사 합니다.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 은 현재 유니코드 스트림에 대 한 출력을 지원 하지 않습니다.fputs does not currently support output into a UNICODE stream.

기본적으로이 함수의 전역 상태는 응용 프로그램으로 범위가 지정 됩니다.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
_fputts_fputts fputsfputs fputsfputs fputwsfputws

요구 사항Requirements

기능Function 필수 헤더Required header
fputsfputs <stdio.h><stdio.h>
fputwsfputws <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.

예제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/OStream I/O
fgets, fgetwsfgets, fgetws
_getws를 가져옵니다.gets, _getws
puts, _putwsputs, _putws