_cputs, _cputws

Fügt eine Zeichenfolge in der Konsole ein.

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

Anforderungen

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