puts, _putws

Scrive una stringa in stdout.

Sintassi

int puts(
   const char *str
);
int _putws(
   const wchar_t *str
);

Parametri

str
Stringa di output.

Valore restituito

Restituisce un valore non negativo se ha esito positivo. Se puts ha esito negativo, restituisce EOF; se _putws ha esito negativo, restituisce WEOF. Se str è un puntatore Null, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, le funzioni impostate su errnoEINVAL e restituiscono EOF o WEOF.

Per informazioni su questi e altri codici di errore, vedere errno, _doserrno, _sys_errliste _sys_nerr.

Osservazioni:

La puts funzione scrive str nel flusso stdoutdi output standard, sostituendo il carattere null di terminazione della stringa ('\0') con un carattere di nuova riga ('\n') nel flusso di output.

_putws è la versione a caratteri wide di puts; se il flusso viene aperto in modalità ANSI, le due funzioni si comportano in modo identico. puts non supporta attualmente l'output in un flusso UNICODE.

_putwch scrive caratteri Unicode usando l'impostazione locale console corrente.

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

Mapping di routine di testo generico

Routine TCHAR.H	_UNICODE e _MBCS non definito	_MBCS Definito	_UNICODE Definito
_putts	puts	puts	_putws

Requisiti

Ciclo	Intestazione obbligatoria
puts	<stdio.h>
_putws	<stdio.h>

La console non è supportata nelle app piattaforma UWP (Universal Windows Platform) (UWP). Gli handle di flusso standard associati alla console, stdin, stdoute stderrdevono essere reindirizzati prima che le funzioni di runtime C possano usarle nelle app UWP. Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Librerie

Tutte le versioni delle librerie di runtime C.

Esempio

// crt_puts.c
// This program uses puts to write a string to stdout.

#include <stdio.h>

int main( void )
{
   puts( "Hello world from puts!" );
}

Output

Hello world from puts!

Vedi anche

I/O di flusso
fputs, fputws
fgets, fgetws