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 errno EINVAL 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!