fputs, fputws

Artigo
08/25/2010

Gravar uma seqüência de caracteres em um fluxo.

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

Parâmetros

str
Seqüência de saída.
stream
Ponteiro para FILE estrutura.

Valor de retorno

Cada uma dessas funções retornará um valor não-negativo se ele for bem-sucedido.Em um erro, fputs Retorna EOF, e fputws Retorna WEOF. If str ou stream é um ponteiro nulo, essas funções chamar o manipulador de parâmetro inválido sistema autônomo descrito em Validação de parâmetro. Se a execução for permitida para continuar, essas funções conjunto errno para EINVAL e retornar EOF ou WEOF.

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

Comentários

Cada uma dessas funções copia str na saída stream na posição corrente. fputws Copia o argumento de caractere largo str para stream sistema autônomo uma seqüência de caracteres multibyte ou uma seqüência de caracteres largos acordo com a 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 tenham comportamento idêntico se o fluxo é aberto no modo ANSI.fputs não oferece suporte atualmente à saída em um fluxo UNICODE.

Mapeamentos de rotina de texto genérica

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>

Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.

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.