_cputs, _cputws

Článek
06/09/2015

Vloží řetězec do konzoly.

Důležité
Toto rozhraní API nelze použít v aplikacích, které jsou spuštěny v prostředí Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /ZW.

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

Parametry

str
Výstupní řetězec.

Vrácená hodnota

Pokud je úspěšná, _cputs vrátí hodnotu 0.Pokud selže funkce vrací nenulovou hodnotu.

Poznámky

_cputs Funkce zapíše řetězec zakončený hodnotou null, který se odkazuje str přímo do konzoly.Kombinace carriage return-line feed (CR-LF) nejsou automaticky připojeny k řetězci.

Tato funkce ověřuje jeho parametr.Pokud str je NULL, je vyvolána obslužná rutina neplatný parametr, jak je popsáno v Ověření parametru.Je-li pokračovat, je povoleno zpracování errno je nastavena na EINVAL a vrátí hodnotu -1.

Mapování rutiny obecného textu

Byla zahájena rutina Tchar.h	_UNICODE a _MBCS není definováno	_MBCS, definice	_UNICODE definována
_cputts	_cputs	_cputs	_cputws

Požadavky

Byla zahájena rutina	Požadované záhlaví	Volitelné záhlaví
_cputs	<conio.h>	<errno.h>
_cputws	<conio.h>	<errno.h>

Další informace o kompatibilitě v tématu Kompatibilita.

Knihovny

Všechny verze C run-time libraries.

Příklad

// 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 );
}

Výsledek

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

Viz také

Referenční dokumentace

I/O konzoly a portu

_putch, _putwch

Sdílet prostřednictvím