fputs, fputws

Articolo
06/09/2015

Scrive una stringa in un flusso.

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

Parametri

str
Stringa di output.
stream
Puntatore alla struttura FILE.

Valore restituito

Ognuna di queste funzioni restituisce un valore negativo in caso di successo. In caso di errore, fputs e fputws restituiscono EOF. Se str o stream è un puntatore null, queste funzioni richiamano un gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, queste funzioni impostano errno su EINVAL e quindi fputs restituisce EOF, e fputws restituisce 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 nell'output stream alla posizione corrente. fputws copia rispettivamente l'argomento a caratteri wide str in stream come una stringa di caratteri multibyte o una stringa di caratteri estesi a seconda di come lo stream venga aperto rispettivamente, in modalità di testo oppure in modalità binaria. Nemmeno una funzione copia il carattere di terminazione null.

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

Mapping di routine su testo generico

Routine TCHAR.H	_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 Windows Store. Gli handle del flusso standard associati alla console,stdin, stdout e stderr, devono essere reindirizzati prima di poter utilizzare le funzioni di runtime del linguaggio C nelle applicazioni Windows Store. Per ulteriori informazioni sulla compatibilità, vedere Compatibilità.

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