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.

Siehe auch

Stream-E/A
fgets, fgetws
gets, _getws
puts, _putws