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 retornará 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âmetro inválido, conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, essas funções definirão errno como EINVAL e retornarão EOF.

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

Comentários

Cada uma dessas funções copia str para a saída stream na posição atual. fputws copia o argumento de caractere largo str para stream como uma cadeia de caracteres multibyte ou uma cadeia de caracteres largos, dependendo de stream ser aberto no modo de texto ou 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 alterá-lo, consulte Estado global no CRT.

Mapeamentos de rotina de texto genérico

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