_cputs, _cputws
Fügt eine Zeichenfolge an der Konsole aus.
Wichtig
Diese API kann nicht in Anwendungen verwendet werden, die im Windows-Runtime ausgeführt werden.Weitere Informationen finden Sie unter CRT-Funktionen nicht mit /ZW unterstützt.
int _cputs(
const char *str
);
int _cputws(
const wchar_t *str
);
Parameter
- str
Ausgabezeichenfolge.
Rückgabewert
Wenn erfolgreich, _cputs gibt 0 zurück. Wenn die Funktion fehlschlägt, gibt sie einen Wert ungleich 0 (null) zurück.
Hinweise
Die Funktion _cputs schreibt die auf NULL abschließende Zeichenfolge, auf die str direkt in der Konsole angezeigt wird. Eine Kombination des Wagenrücklauf-Zeilenvorschubs (CR-LF) wird nicht automatisch der Zeichenfolge angehängt.
Diese Funktion überprüft seine Parameter. Wenn strNULL, wird der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben. Wenn die weitere Ausführung zugelassen wird, wird errno auf EINVAL festgelegt und – 1 zurückgegeben.
Zuordnung 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.
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)!