_cputs, _cputws
콘솔에 문자열을 넣습니다.
중요
이 API는 Windows 런타임에서 실행되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /ZW에서 지원하지 않는 CRT 함수를 참조하십시오.
int _cputs(
const char *str
);
int _cputws(
const wchar_t *str
);
매개 변수
- str
출력 문자열
반환 값
성공하면 _cputs 은 0을 반환합니다. 함수가 실패 하면 0이 아닌 값을 반환 합니다.
설명
_cputs 함수는 콘솔에 바로 str로 찍히는 null로 끝나는 문자열을 작성합니다. 캐리지 리턴-줄 바꿈(CR-LF) 조합은 문자열에 자동으로 추가 되지 않습니다.
이 함수는 매개변수를 인증합니다. 만약 str 이 NULL이면 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다. 만약 실행이 계속해서 허용된 경우, errno 는 EINVAL 으로 설정되고, -1이 반환됩니다.
제네릭 텍스트 라우팅 매핑
Tchar.h 루틴 |
_UNICODE 및 _MBCS 정의되지 않음 |
_MBCS 정의됨 |
_UNICODE 정의됨 |
---|---|---|---|
cputs |
_cputs |
_cputs |
_cputws |
요구 사항
루틴 |
필수 헤더 |
선택적 헤더 |
---|---|---|
_cputs |
<conio.h> |
<<errno.h>> |
_cputws |
<conio.h> |
<<errno.h>> |
호환성에 대한 자세한 내용은 호환성을 참조하십시오.
라이브러리
모든 버전의 C 런타임 라이브러리입니다.
예제
// crt_cputs.c
// compile with: /c
// This program first displays a string to the console.
#include <conio.h>
#include <errno.h>
void print_to_console(char* buffer)
{
int retval;
retval = _cputs( buffer );
if (retval)
{
if (errno == EINVAL)
{
_cputs( "Invalid buffer in print_to_console.\r\n");
}
else
_cputs( "Unexpected error in print_to_console.\r\n");
}
}
void wprint_to_console(wchar_t* wbuffer)
{
int retval;
retval = _cputws( wbuffer );
if (retval)
{
if (errno == EINVAL)
{
_cputws( L"Invalid buffer in wprint_to_console.\r\n");
}
else
_cputws( L"Unexpected error in wprint_to_console.\r\n");
}
}
int main()
{
// String to print at console.
// Notice the \r (return) character.
char* buffer = "Hello world (courtesy of _cputs)!\r\n";
wchar_t *wbuffer = L"Hello world (courtesy of _cputws)!\r\n";
print_to_console(buffer);
wprint_to_console( wbuffer );
}
Output
Hello world (courtesy of _cputs)!
Hello world (courtesy of _cputws)!