fputs, fputws

Artigo
06/09/2015

Grava uma cadeia de caracteres para um fluxo.

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 a estrutura de FILE .

Valor de retorno

Cada uma dessas funções retorna um valor não negativo se for bem-sucedida. Em um erro, fputs e fputws retornam EOF. Se str ou stream for um ponteiro nulo, essas funções invoca o manipulador inválido do parâmetro, conforme descrito em Validação do parâmetro. Se a execução for permitida continuar, essas funções definem errno a EINVAL e depois fputs retorna EOF, e retorna WEOFde fputws .

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

Comentários

Cada uma dessas funções copia str à saída stream na posição atual. fputws copia o argumento str ampla de caracteres a stream como uma cadeia de caracteres de multibyte- caractere ou uma cadeia de caracteres de ampla caractere de acordo com o que stream está aberto no modo de texto ou no modo de binário, respectivamente. Nenhum função copia o caractere nulo sendo encerrado.

As duas funções se comportam de maneira idêntica, se o fluxo estiver aberto no modo de ANSI. fputs não tem suporte para saída em um fluxo UNICODE.

Mapeamentos da 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>

O console não tem suporte em aplicativos do Windows Store. Os manipuladores de fluxo padrão associados ao console — stdin, stdout e stderr — devem ser redirecionados antes que as funções de tempo de execução do C possam utilizá-los em aplicativos do Windows Store. Para informações adicionais de 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 );
}