_cputs, _cputws

Articolo
03/12/2013

Inserisce una stringa nella console.

Importante
Questa API non può essere utilizzato nelle applicazioni eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW.

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

Parametri

str
Restituire la stringa.

Valore restituito

Se l'operazione riesce, restituisce 0 di _cputs.Se la funzione ha esito negativo, restituisce un valore diverso da zero.

Note

La funzione di _cputs scrive la stringa con terminazione null che è indicata da str direttamente nella console.Un miscuglio di un feed di ritorno- riga del carrello () CR-LF automaticamente non viene aggiunto alla stringa.

Questa funzione convalida il parametro.Se str è NULL, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, errno è impostato su EINVAL e -1 viene restituito.

Mapping di routine a Testo generico

Routine Tchar.h	_UNICODE e _MBCS non definiti	_MBCS definito	_UNICODE definito
_cputts	_cputs	_cputs	_cputws

Requisiti

Routine	Intestazione obbligatoria	Intestazione facoltativa
_cputs	<conio.h>	<errno.h>
_cputws	<conio.h>	<errno.h>

Per ulteriori informazioni di compatibilità, vedere 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 );
}

Output

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

Vedere anche

Riferimenti

Console e porta I/O

_putch, _putwch

Condividi tramite