fputs, fputws
Schreibt eine Zeichenfolge in einen Stream.
Syntax
int fputs(
const char *str,
FILE *stream
);
int fputws(
const wchar_t *str,
FILE *stream
);
Parameter
str
Ausgabezeichenfolge.
stream
Zeiger zur FILE -Struktur.
Rückgabewert
Jede dieser Funktionen gibt einen nichtegativen Wert zurück, wenn sie erfolgreich ist. Bei einem Fehler geben fputs und fputwsEOF zurück. Wenn str oder stream ein Nullzeiger ist, rufen diese Funktionen den ungültigen Parameterhandler auf, wie in der Parameterüberprüfung beschrieben. Wenn die Ausführung fortgesetzt werden darf, werden diese Funktionen festgelegt errno EINVAL und dann zurückgegeben EOF.
Weitere Informationen zu Fehlercodes finden Sie unter , , _doserrno, _sys_errlistund _sys_nerr.errno
Hinweise
Jede dieser Funktionen kopiert an der aktuellen Position str in die Ausgabe stream. fputws kopiert das Argument str stream "Breitzeichen" in eine Multibyte-Zeichenfolge oder eine Zeichenfolge mit breitem Zeichen, wenn stream sie im Textmodus oder im Binärmodus geöffnet wird. Keine der Funktionen kopiert das am Ende stehende NULL-Zeichen.
Die zwei Funktionen verhalten sich identisch, wenn der Stream im ANSI-Modus geöffnet ist. fputs unterstützt derzeit die Ausgabe in einen UNICODE-Stream nicht.
Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Informationen zum Ändern finden Sie im Global state in the CRT.
Mapping generischer Textroutinen
| TCHAR.H-Routine | _UNICODE und _MBCS nicht definiert |
_MBCS definiert |
_UNICODE definiert |
|---|---|---|---|
_fputts |
fputs |
fputs |
fputws |
Anforderungen
| Funktion | Erforderlicher Header |
|---|---|
fputs |
<stdio.h> |
fputws |
<stdio.h> oder <wchar.h> |
Die Konsole wird in UWP-Apps (Universelle Windows-Plattform) nicht unterstützt. Die Standardstreamhandles, die der Konsole zugeordnet sind ,stdin und stderrmüssen umgeleitet werden, stdoutbevor C-Laufzeitfunktionen sie in UWP-Apps verwenden können. Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Beispiel
// crt_fputs.c
// This program uses fputs to write
// a single line to the stdout stream.
#include <stdio.h>
int main( void )
{
fputs( "Hello world from fputs.\n", stdout );
}
Hello world from fputs.