fputs, fputws
Escreva uma cadeia de caracteres em 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 para a estrutura de FILE .
Valor de retorno
Cada uma dessas funções retorna um valor não-negativos é se com êxito.Em um erro, fputs retorna EOF, e retorna WEOFde fputws .Se str ou stream são um ponteiro zero, essas funções chamam o manipulador de parâmetro inválido, como descrito em Validação de parâmetro.Se a execução é permitida continuar, este errno definir funções a EINVAL e EOF de retorno ou WEOF.
Consulte _doserrno, errno, _sys_errlist, e _sys_nerr para obter mais informações sobre eles, e outros códigos de erro.
Comentários
Cada uma dessas funções str copia a saída stream na posição atual.fputws copia o argumento str de largo- caractere a stream como uma cadeia de caracteres de multibyte- caractere ou uma cadeia de caracteres de largo- caractere de acordo com o que stream é aberto no modo de texto ou no modo de binário, respectivamente.Nenhum funcionam copia o caractere de terminação zero.
As duas funções se comportam de forma idêntica se o fluxo é aberta no modo ANSI.fputs não tem suporte para a saída em um fluxo de UNICODE.
Mapeamentos da rotina de Genérico- texto
Rotina de TCHAR.H |
_UNICODE & _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> |
O console não é suportado em aplicativos de Windows Store .Identificadores padrões de fluxo associadas ao console, stdin, stdout, e stderr, devem ser redirecionada antes que as funções de tempo de execução das C pode usar em aplicativos de Windows Store .Para informações extras de compatibilidade Compatibilidade na introdução, consulte.
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 );
}
Equivalência do .NET Framework
System::IO::StreamWriter::Write