_cputs, _cputws

Inserisce una stringa nella console.

Sintassi

int _cputs(
   const char *str
);
int _cputws(
   const wchar_t *str
);

Parametri

str
Stringa di output.

Valore restituito

Se l'esito è positivo, _cputs restituisce 0. In caso contrario, restituisce un valore diverso da zero.

Osservazioni:

La funzione _cputs scrive la stringa con terminazione Null a cui punta str direttamente alla console. Una combinazione di avanzamento riga ritorno a capo (CR-LF) non viene aggiunta automaticamente alla stringa.

Questa funzione convalida il relativo parametro. Se str è NULL, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, errno viene impostata su EINVALe viene restituito -1.

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

Requisiti

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Librerie

Tutte le versioni delle librerie di runtime C.

Esempio

// crt_cputs.c
// compile with: /c
// This program first displays a string to the console.

#include <conio.h>
#include <errno.h>

void print_to_console(char* buffer)
{
   int retval;
   retval = _cputs( buffer );
   if (retval)
   {
       if (errno == EINVAL)
       {
         _cputs( "Invalid buffer in print_to_console.\r\n");
       }
       else
         _cputs( "Unexpected error in print_to_console.\r\n");
   }
}

void wprint_to_console(wchar_t* wbuffer)
{
   int retval;
   retval = _cputws( wbuffer );
   if (retval)
   {
       if (errno == EINVAL)
       {
         _cputws( L"Invalid buffer in wprint_to_console.\r\n");
       }
       else
         _cputws( L"Unexpected error in wprint_to_console.\r\n");
   }
}

int main()
{
   // String to print at console.
   // Notice the \r (return) character.
   char* buffer = "Hello world (courtesy of _cputs)!\r\n";
   wchar_t *wbuffer = L"Hello world (courtesy of _cputws)!\r\n";
   print_to_console(buffer);
   wprint_to_console( wbuffer );
}

Hello world (courtesy of _cputs)!
Hello world (courtesy of _cputws)!

Vedi anche

I/O della console e della porta
_putch, _putwch