_cputs, _cputws

Umieszcza ciąg w konsoli.

Ważne

Tego interfejsu API nie można używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows. Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane w aplikacjach platforma uniwersalna systemu Windows.

Składnia

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

Parametry

str
Ciąg wyjściowy.

Wartość zwracana

Jeśli operacja powiedzie się, _cputs zwraca wartość 0. Jeśli funkcja zakończy się niepowodzeniem, zwraca wartość niezerową.

Uwagi

Funkcja _cputs zapisuje ciąg zakończony wartości null, który jest wskazywany str bezpośrednio w konsoli. Kombinacja zestawienia powrotnego karetki (CR-LF) nie jest automatycznie dołączana do ciągu.

Ta funkcja weryfikuje jego parametr. Jeśli str parametr ma NULLwartość , wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wykonywanie jest dozwolone do kontynuowania, errno jest ustawione na EINVAL, a -1 jest zwracany.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Mapowania procedur tekstu ogólnego

Procedura tchar.h	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_cputts	_cputs	_cputs	_cputws

Wymagania

Procedura	Wymagany nagłówek	Opcjonalny nagłówek
_cputs	<conio.h>	<errno.h>
_cputws	<conio.h>	<errno.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Biblioteki

Wszystkie wersje bibliotek czasu wykonywania języka 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 );
}

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

Zobacz też

We/Wy konsoli i portu
_putch, _putwch