_cputs, _cputws

Powoduje umieszczenie ciąg do konsoli.

Ważne
Ten interfejs API nie można używać w aplikacji, których wykonywanie w Środowisko wykonawcze systemu Windows.Aby uzyskać więcej informacji, zobacz CRT funkcje nie obsługiwane przez /ZW.

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

Parametry

• str
  Ciąg danych wyjściowych.

Wartość zwracana

W przypadku powodzenia _cputs zwraca wartość 0.Jeśli funkcja się nie powiedzie, zwraca wartość różną od zera.

Uwagi

_cputs Funkcja trace() ciąg zakończony zerem, która jest wskazywana przez str bezpośrednio do konsoli.Kombinacja return-line feed (CR-LF) przewóz nie jest automatycznie dołączany do ciągu.

Ta funkcja sprawdza poprawność jej parametr.Jeśli str jest NULL, program obsługi nieprawidłowy parametr jest wywoływana, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może kontynuować, errno jest ustawiona na EINVAL i zwracana jest wartość -1.

Tekst rodzajowy rutynowych mapowania

Rozpoczęto wykonywanie procedury TCHAR.h	_UNICODE i _MBCS nie zdefiniowany	_MBCS, definicja	_UNICODE, definicja
_cputts	_cputs	_cputs	_cputws

Wymagania

Rozpoczęto wykonywanie procedury	Wymaganego nagłówka	Opcjonalny nagłówka
_cputs	<conio.h>	<errno.h>
_cputws	<conio.h>	<errno.h>

Informacji dotyczących zgodności, zobacz Zgodność.

Biblioteki

Wszystkie wersje programu biblioteki uruchomieniowej C.

Przykład

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

Dane wyjściowe

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

Zobacz też

Informacje

Konsoli i portów We/Wy

_putch, _putwch