_cputs、_cputws

将字符串写入控制台。

重要

此 API 不能用于在 Windows 运行时 中执行的应用程序。有关更多信息，请参见不支持 /ZW 的 CRT 函数。

int _cputs(  
const char *str  
); 
int _cputws( 
const wchar_t *str  
);

参数

• str
  输出字符串

返回值

如果成功，_cputs返回 0 。 如果函数运行失败，将返回一个非零值。

备注

_cputs 函数编写由 str 指向的，直接写入控制台的 null-terminated 的字符串。 回车-换行（CR-LF）组合没有自动追加到字符串。

此函数验证其参数。 如果 str 是 NULL，则会调用无效参数处理程序，如 参数验证 中所述。 如果允许继续执行，将 EINVAL 设置为 errno，并返回 -1。

一般文本例程映射

Tchar.h 例程	未定义 _UNICODE 和 _MBCS	已定义 _MBCS	已定义 _UNICODE
_cputts	_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)!

请参见

参考

控制台和端口 I/O

_putch、_putwch