puts, _putws
Grava uma cadeia de caracteres em stdout.
int puts(
const char *str
);
int _putws(
const wchar_t *str
);
Parâmetros
- str
Cadeia de caracteres de saída.
Valor de retorno
Retorna um valor não negativo se tiver êxito. Se puts falhar, retornará EOF; se _putws falhar, retornará WEOF. Se str for um ponteiro nulo, o manipulador de parâmetro inválido será chamado, como descrito em Validação do parâmetro. Se a execução puder continuar, essas funções definirão errno como EINVAL e retornarão EOF ou WEOF.
Para obter informações sobre esses e outros códigos de erro, consulte _doserrno, errno, _sys_errlist, and _sys_nerr.
Comentários
A função puts grava str no fluxo de saída padrão stdout, substituindo o caractere que termina em nulo da cadeia de caracteres ('\0') por um caractere de nova linha ('\n') no fluxo de saída.
_putws é a versão de caracteres largos de puts; as duas funções se comportarão de forma idêntica se o fluxo for aberto no modo de ANSI. No momento, puts não tem suporte para saída em fluxo UNICODE.
Em Windows 2000 e posterior, _putwch grava caracteres Unicode usando a configuração atual LOCALIDADE DO CONSOLE.
Mapeamentos da rotina de texto genérico
Rotina TCHAR.H |
_UNICODE & _MBCS não definido |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_putts |
puts |
puts |
_putws |
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
puts |
<stdio.h> |
_putws |
<stdio.h> |
O console não tem suporte em aplicativos do Windows Store. Os manipuladores de fluxo padrão associados ao console — stdin, stdout e stderr — devem ser redirecionados antes que as funções de tempo de execução do C possam utilizá-los em aplicativos do Windows Store. Para informações adicionais de compatibilidade, consulte Compatibilidade.
Bibliotecas
Todas as versões das Bibliotecas em tempo de execução C.
Exemplo
// crt_puts.c
/* This program uses puts to write a string to stdout.
*/
#include <stdio.h>
int main( void )
{
puts( "Hello world from puts!" );
}
Saída
Hello world from puts!