_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. Ist str dies NULLder Fehler, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. 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. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Generische Textroutinzuordnungen

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.

Bibliotheken

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

Konsole und Port-E/A
_putch, _putwch