puts, _putws

Grava uma cadeia de caracteres no stdout.

Sintaxe

int puts(
   const char *str
);
int _putws(
   const wchar_t *str
);

Parâmetros

str
Cadeia de caracteres de saída.

Retornar valor

Retorna um valor não negativo se for bem-sucedido. Se puts falhar, retorna, se _putws falhar, retornaEOFWEOF. Se str for um ponteiro nulo, o manipulador de parâmetros inválido será chamado, conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, as funções definidas errno como EINVAL e retornar EOF ou WEOF.

Para obter informações sobre esses e outros códigos de erro, confira errno, _doserrno, _sys_errlist e _sys_nerr.

Comentários

A puts função grava str no fluxo de saída padrão, substituindo o caractere nulo de terminação da cadeia de caracteres ('\0') por um caractere de nova linha ('\n') no fluxo stdoutde saída.

_putws é a versão de caractere largo de puts; as duas funções se comportam de forma idêntica quando o fluxo é aberto no modo ANSI. Atualmente, puts não dá suporte para a saída em um fluxo UNICODE.

_putwch grava caracteres Unicode usando a configuração CONSOLE LOCALE atual.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, consulte Estado global na CRT.

Mapeamentos de rotina de texto genérico

Rotina TCHAR.H	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_putts	puts	puts	_putws

Requisitos

Rotina	Cabeçalho necessário
puts	<stdio.h>
_putws	<stdio.h>

Não há suporte para o console em aplicativos UWP (Plataforma Universal do Windows). Os identificadores de fluxo padrão associados ao console, stdin, stdout e stderr, devem ser redirecionados antes que as funções em tempo de execução C possam usá-los em aplicativos UWP. Para obter informações sobre 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!

Confira também

E/S de fluxo
fputs, fputws
fgets, fgetws