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

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

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

반환 값Return Value

이러한 각 함수는 성공할 경우 음수가 아닌 값을 반환합니다.Each of these functions returns a nonnegative value if it is successful. 오류 발생 시 fputsfputws 반환 EOF합니다.On an error, fputs and fputws return EOF. 경우 str 또는 스트림 가 null 포인터 이면 이러한 함수에 설명 된 대로 잘못 된 매개 변수 처리기를 호출 매개 변수 유효성 검사합니다.If str or stream is a null pointer, these functions invoke the invalid parameter handler, as described in Parameter Validation. 실행을 계속 허용 된, 이러한 함수 설정 errnoEINVAL 차례로 fputs 반환 EOF, 및 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 현재 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_fputts fputsfputs fputsfputs fputwsfputws

요구 사항Requirements

함수Function 필수 헤더Required header
fputsfputs <stdio.h><stdio.h>
fputwsfputws <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/OStream I/O
fgets, fgetwsfgets, fgetws
gets, _getwsgets, _getws
puts, _putwsputs, _putws