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.

Retornar valor

Cada uma dessas funções retorna um valor não negativo se for bem-sucedida. Quando ocorre um erro, fputs e fputws retornam EOF. Se str ou stream for um ponteiro nulo, essas funções invocarão o manipulador de parâmetros 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 , , _sys_errlist_doserrnoe _sys_nerr.errno

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 para stream como 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

Rotina TCHAR.H	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_fputts	fputs	fputs	fputws

Requisitos

Função	Cabeçalho necessário
fputs	<stdio.h>
fputws	<stdio.h> ou <wchar.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 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