fputs, fputws

Grava uma cadeia de caracteres em um fluxo.

Sintaxe

int fputs(
   const char *str,
   FILE *stream
);
int fputws(
   const wchar_t *str,
   FILE *stream
);

Parâmetros

str
Cadeia de caracteres de saída.

stream
Ponteiro para a estrutura FILE.

Valor retornado

Cada uma dessas funções retornará um valor não negativo se for bem-sucedida. Quando ocorre um erro, fputs e fputws retornam EOF. Se str or stream for um ponteiro nulo, essas funções invocarão o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se a execução puder continuar, essas funções definirão errno como EINVAL e retornarão EOF.

Para obter mais informações sobre códigos de erro, consulte errno, _doserrno, _sys_errliste _sys_nerr.

Comentários

Cada uma dessas funções copia str para a saída stream na posição atual. fputws Copia o argumento str de caractere largo como stream uma cadeia de caracteres multibyte ou uma cadeia de caracteres largos quando stream é aberto no modo de texto ou no modo binário, respectivamente. Nenhuma função copia o caractere nulo de terminação.

As duas funções terão comportamento idêntico se o fluxo for aberto no modo ANSI. Atualmente, fputs não dá suporte para a saída em um fluxo UNICODE.

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

Mapeamentos de rotina de texto genérico

Requisitos

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 para que as funções no runtime do C possam usá-los em aplicativos UWP. Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

// crt_fputs.c
// This program uses fputs to write
// a single line to the stdout stream.

#include <stdio.h>

int main( void )
{
   fputs( "Hello world from fputs.\n", stdout );
}

Hello world from fputs.

Confira também

E/S de fluxo
fgets, fgetws
gets, _getws
puts, _putws