_cputs, _cputws

Fügt eine Zeichenfolge in der Konsole ein.

Wichtig

Diese API kann nicht in Anwendungen verwendet werden, die in Windows-Runtime ausgeführt werden. Weitere Informationen finden Sie im Artikel CRT functions not supported in Universal Windows Platform apps (In Apps für die universelle Windows-Plattform nicht unterstützte CRT-Funktionen).

Syntax

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

Parameter

str
Ausgabezeichenfolge.

Rückgabewert

_cputs gibt bei Erfolg 0 zurück. Wenn die Funktion fehlschlägt, wird einen Wert ungleich null zurückgegeben.

Hinweise

Die _cputs-Funktion schreibt die auf Null endende Zeichenfolge, auf die durch str verwiesen wird, direkt in die Konsole. Eine Wagenrücklaufzeileneinführung (CR-LF) wird nicht automatisch an die Zeichenfolge angefügt.

Diese Funktion überprüft seine Parameter. Wenn str den Wert NULLannimmt, wird der Handler für ungültige Parameter aufgerufen, wie in Parameter Validation. Wenn die Ausführung fortgesetzt werden darf, errno wird auf EINVAL", und -1" zurückgegeben.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Mapping generischer Textroutinen

Tchar.h-Routine	_UNICODE und _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_cputts	_cputs	_cputs	_cputws

Anforderungen

Routine	Erforderlicher Header	Optionaler Header
_cputs	<conio.h>	<errno.h>
_cputws	<conio.h>	<errno.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Libraries

Alle Versionen der C-Laufzeitbibliotheken.

Beispiel

// 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)!

Siehe auch

Konsolen- und Port-E/A
_putch, _putwch