_cputs, _cputws

Artigo
03/12/2013

Coloca uma cadeia de caracteres no console.

Importante
Este API não pode ser usado em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /ZW.

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

Parâmetros

str
Cadeia de caracteres de saída.

Valor de retorno

Se com êxito, retorna 0 de _cputs .Se a função falhar, retorna um valor diferente de zero.

Comentários

A função de _cputs grava a cadeia de caracteres NULL- finalizada que é apontada por str diretamente no console.Uma linha retorno- combinação de carro de linha (CR-LF) não é acrescentado automaticamente à cadeia de caracteres.

Essa função valida o parâmetro.Se str é NULO, o manipulador inválido do parâmetro é invocado, como descrito em Validação de parâmetro.Se a execução é permitida continuar, errno é definido como EINVAL e -1 são retornados.

Mapeamentos da rotina de Genérico- texto

Rotina de Tchar.h	_UNICODE e não definidos _MBCS	_MBCS definido	_UNICODE definido
_cputts	_cputs	_cputs	_cputws

Requisitos

Rotina	Cabeçalho necessário	Cabeçalho opcional
_cputs	<conio.h>	<errno.h>
_cputws	<conio.h>	<errno.h>

Para mais informações, consulte Compatibilidadede compatibilidade.

Bibliotecas

Todas as versões de Bibliotecas em tempo de execução de C.

Exemplo

// 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 );
}

Saída

Hello world (courtesy of _cputs)!
Hello world (courtesy of _cputws)!

Consulte também

Referência

Console e a porta de e/S

_putch, _putwch

Partilhar via