fputs, fputws

Artikel
06/09/2015

Schreibt eine Zeichenfolge in einen Stream.

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 bei Erfolg einen nicht negativen Wert zurück. Bei einem Fehler geben fputs und fputwsEOF zurück. Wenn str oder stream ein NULL-Zeiger ist, dann rufen diese Funktionen den Handler für ungültige Parameter auf, wie in Parametervalidierung beschrieben. Wenn die weitere Ausführung zugelassen wird, stellen diese Funktionen errno auf EINVAL ein. Dann gibt fputsEOF und fputwsWEOF zurück.

Weitere Informationen zu diesen und anderen Fehlercodes finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.

Hinweise

Jede dieser Funktionen kopiert an der aktuellen Position str in die Ausgabe stream. fputws kopiert das Breitzeichenargument str als Multibyte-Zeichenfolge oder Zeichenfolge mit Breitzeichen in stream. Die Zeichenfolgenart wird dadurch bestimmt, ob stream im Textmodus oder Binärmodus geöffnet ist. 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 die Ausgabe in einen UNICODE-Stream augenblicklich nicht.

Zuordnung generischer Textroutinen

TCHAR.H-Routine	_UNICODE & _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 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.

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 );
}