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.WEOF
EOF
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!