_cputs, _cputws
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)!