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, retornaEOF
WEOF
. 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 stdout
de 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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de