Sdílet prostřednictvím

_cputs, _cputws

  • Článek

Vloží řetězec do konzoly.

Důležité

Toto rozhraní API nelze použít v aplikacích, které se spouští v prostředí Windows Runtime. Další informace najdete v tématu Funkce CRT, které nejsou v aplikacích Univerzální platforma Windows podporované.

Syntaxe

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

Parametry

str
Výstupní řetězec

Vrácená hodnota

V případě úspěchu _cputs vrátí hodnotu 0. Pokud funkce selže, vrátí nenulovou hodnotu.

Poznámky

Funkce _cputs zapíše řetězec ukončený hodnotou null, na který odkazuje str přímo na konzolu. Kombinace návratového kanálu (CR-LF) na začátek řádku není automaticky připojena k řetězci.

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

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Mapování rutin obecného textu

Rutina Tchar.h _UNICODE a _MBCS není definován _MBCS definovaný _UNICODE definovaný
_cputts _cputs _cputs _cputws

Požadavky

Rutina Požadovaný hlavičkový soubor Volitelné záhlaví
_cputs <conio.h> <errno.h>
_cputws <conio.h> <errno.h>

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

Knihovny

Všechny verze knihoven runtime jazyka C.

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

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

Viz také

Vstupně-výstupní operace konzoly a portu
_putch, _putwch