puts, _putws

Grava uma cadeia de caracteres para stdout.

Sintaxe

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

Parâmetros

str
Cadeia de caracteres de saída.

Valor Retornado

Retorna um valor não negativo se for bem-sucedido. Se o pressionamento falhar, ele retornará EOF; Se _putws falhar, ele retornará WEOF. Se Str for um ponteiro NULL, o manipulador de parâmetro inválido será invocado, conforme descrito em validação de parâmetro. Se a execução tem permissão para continuar, as funções definem errno como EINVAL e retornam EOF ou WEOF.

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

Comentários

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

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

_putwch grava caracteres Unicode usando a configuração de localidade do console atual.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar isso, consulte estado global no CRT.

Mapeamentos da rotina de texto genérico

Rotina TCHAR.H _UNICODE & não _MBCS definido _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 Plataforma Universal do Windows (UWP). Os identificadores de fluxo padrão associados ao console, stdin, stdoute stderrdevem ser redirecionados antes que as funções de tempo de execução do C possam usá-los em aplicativos UWP. Para obter mais 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