_cputs, _cputws

Artigo
06/09/2015

Coloca uma cadeia de caracteres ao console.

Importante

Não é possível usar essa API em aplicativos executados no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /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 tiver êxito, retorna 0 de _cputs . Se a função falhar, retornará um valor diferente de zero.

Comentários

A função de _cputs grava a cadeia de caracteres com terminação nula que é apontada por str diretamente ao console. Uma combinação retorno- linha de retorno de carro (CR-LF) não é acrescentada automaticamente à cadeia de caracteres.

Essa função valida seu parâmetro. Se str é nulo, o manipulador inválido do parâmetro será chamado, conforme descrito em Validação do parâmetro. Se a execução puder continuar, errno será definido como EINVAL será será retornado -1.

Mapeamentos da rotina de texto genérico

Rotina Tchar.h	_UNICODE e _MBCS não definidos	_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 obter mais informações de compatibilidade, consulte Compatibilidade.

Bibliotecas

Todas as versões das Bibliotecas em tempo de execução 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 E/S de porta

_putch, _putwch

Partilhar via