puts, _putws
Schreibt eine Zeichenfolge in stdout.
Syntax
int puts(
const char *str
);
int _putws(
const wchar_t *str
);
Parameter
str
Ausgabezeichenfolge.
Rückgabewert
Gibt bei Erfolg einen nicht negativen Wert zurück. Wenn puts fehlschlägt, wird EOF zurückgegeben, wenn _putws fehlschlägt, wird WEOF zurückgegeben. Wenn str ein NULL-Zeiger ist, wird der Handler für ungültige Parameter aufgerufen, wie in Parameter Validation (Parameterüberprüfung) beschrieben. Wenn die Ausführung fortgesetzt werden darf, werden die funktionen auf errno EINVAL und zurückgeben oder zurückgeben.WEOFEOF
Weitere Informationen zu diesen und anderen Fehlercodes finden Sie unter errno, _doserrno, _sys_errlist und _sys_nerr.
Hinweise
Die puts Funktion schreibt str in den Standardausgabedatenstrom stdout, wobei das endende Nullzeichen ('\0') der Zeichenfolge durch ein Zeilenumbruchzeichen ('\n') im Ausgabedatenstrom ersetzt wird.
_putws ist die Breitzeichenversion von puts; die zwei Funktionen verhalten sich identisch, wenn der Stream im ANSI-Modus geöffnet ist. puts unterstützt derzeit die Ausgabe in einen UNICODE-Stream nicht.
_putwch schreibt Unicode-Zeichen mithilfe der aktuellen CONSOLE LOCALE-Einstellung.
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 |
|---|---|---|---|
_putts |
puts |
puts |
_putws |
Anforderungen
| Routine | Erforderlicher Header |
|---|---|
puts |
<stdio.h> |
_putws |
<stdio.h> |
Die Konsole wird in UWP-Apps (Universelle Windows-Plattform) nicht unterstützt. Die mit der Konsole verknüpften Standardstreamhandles stdin, stdout und stderr müssen umgeleitet werden, bevor sie von C-Laufzeitfunktionen in UWP-Apps verwendet werden können. Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Libraries
Alle Versionen der C-Laufzeitbibliotheken.
Beispiel
// crt_puts.c
// This program uses puts to write a string to stdout.
#include <stdio.h>
int main( void )
{
puts( "Hello world from puts!" );
}
Output
Hello world from puts!