fputs, fputws

Articolo
03/26/2013

Scrivere una stringa in un flusso.

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

Parametri

str
Restituire la stringa.
stream
Puntatore alla struttura FILE.

Valore restituito

Ognuna di queste funzioni restituisce un valore non negativo se ha esito positivo.Su un errore, fputs restituisce EOFe restituisce WEOFdi fputws.Se str o stream è un puntatore null, queste funzioni richiamare il gestore non valido di parametro, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, questo errno impostato funzioni a EINVAL e EOF di ritorno o WEOF.

Vedere _doserrno, errno, _sys_errlist, e _sys_nerr per ulteriori informazioni su questi, e altri, codici di errore.

Note

Ognuna di queste funzioni copia str a stream di output dalla posizione corrente.fputws copia rispettivamente l'argomento a caratteri estesi str a stream come una stringa di caratteri multibyte o stringa di caratteri estesi a seconda di come stream aperto in modalità testo o in modalità binario.Non funzionano copie il carattere di terminazione null.

Le due funzioni si comportano in modo identico se il flusso viene aperto in modalità ANSI.fputs non supporta attualmente l'output in un flusso di UNICODE.

Mapping di routine a Testo generico

TCHAR.H routine	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_fputts	fputs	fputs	fputws

Requisiti

Funzione	Intestazione obbligatoria
fputs	<stdio.h>
fputws	<stdio.h> o <wchar.h>

La console non è supportata nelle applicazioni di Windows Store.L'handle standard del flusso associate alla console, stdin, stdoute stderr, devono essere reindirizzati prima di funzioni di runtime del linguaggio C possono essere utilizzate nelle applicazioni di Windows Store.Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.

Esempio

// 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 );
}