fputs, fputws

Scrive una stringa in un flusso.

Sintassi

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 non negativo se ha esito positivo. In caso di errore, fputs e fputws restituiscono EOF. Se str o stream è un puntatore Null, queste funzioni richiamano il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, queste funzioni sono impostate su errnoEINVAL e quindi restituiscono EOF.

Per altre informazioni sui codici di errore, vedere errno, _doserrno, _sys_errliste _sys_nerr.

Osservazioni:

Ognuna di queste funzioni copia str nell'elemento stream di output nella posizione corrente. fputws copia l'argomento str wide-character in stream come stringa di caratteri multibyte o una stringa di caratteri wide quando stream viene aperto rispettivamente in modalità testo o in modalità binaria. Nessuna delle funzioni copia il carattere Null di terminazione.

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 UNICODE.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificarlo, vedere Stato globale in CRT.

Mapping di routine di testo generico

Routine TCHAR.H	_UNICODE e _MBCS non definito	_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 app piattaforma UWP (Universal Windows Platform) (UWP). Gli handle di flusso standard associati alla console,stdinstdout e , stderrdevono essere reindirizzati prima che le funzioni di runtime C possano usarle nelle app UWP. Per altre informazioni sulla compatibilità, vedere Compatibility (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 );
}

Hello world from fputs.

Vedi anche

I/O di flusso
fgets, fgetws
gets, _getws
puts, _putws