_cputs, _cputws

Fügt eine Zeichenfolge an der Konsole aus.

Wichtig
Diese API kann nicht in den Anwendungen verwendet werden, die in Windows-Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /ZW.

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

Parameter

• str
  Geben Sie Zeichenfolge aus.

Rückgabewert

Wenn erfolgreich, _cputs gibt 0 zurück.Wenn die Funktion fehlschlägt, wird ein Wert ungleich 0 (null) zurück.

Hinweise

Die - Funktion gibt die _cputs auf NULL endende Zeichenfolge, die auf durch str direkt auf der Konsole angezeigt wird.Eine Kombination des Wagenrücklauf-Zeilenvorschubs (CR-LF) wird nicht automatisch in die Zeichenfolge angehängt.

Diese Funktion überprüft den Parameter.Wenn strNULL ist, wird der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, wird errno zu EINVAL festgelegt und -1 wird zurückgegeben.

Zuordnung generische Textroutinen

Anforderungen

Weitere Kompatibilitätsinformation finden Sie unter Kompatibilität.

Bibliotheken

Alle Versionen 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 );
}

Ausgabe

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

Siehe auch

Referenz

Konsole und Port E/A

_putch, _putwch