puts, _putws
Schreibt eine Zeichenfolge in stdout.
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äft, 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 Parametervalidierung beschrieben. Wenn die weitere Ausführung zugelassen wird, setzen die Funktionen errno auf EINVAL und geben EOF oder WEOF zurück.
Weitere Informationen über diese und andere Fehlercodes finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.
Hinweise
Die puts-Funktion schreibt str in den Standardausgabestream stdout und ersetzt das abschließende NULL-Zeichen ('\0') im Ausgabestream durch ein Zeilenumbruchzeichens ('\n').
_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.
In Windows 2000 und höher erstellt _putwch Unicode-Zeichen mit der aktuellen Einstellung des Konsolengebietsschemas.
Zuordnung generischer Textroutinen
TCHAR.H-Routine |
_UNICODE & _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 Windows Store-Apps nicht unterstützt. Die mit der Konsole verknüpften Standardstreamhandles, stdin, stdout und stderr, müssen umgeleitet werden, bevor sie von C-Laufzeitfunktionen in Windows Store-Apps verwendet werden können. Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Bibliotheken
Alle Versionen 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!" );
}
Ausgabe
Hello world from puts!