fputs, fputws
Schreiben Sie eine Zeichenfolge in einen Stream.
int fputs( const char *str, FILE *stream ); int fputws( const wchar_t *str, FILE *stream );
Parameter
str
Geben Sie Zeichenfolge aus.stream
Zeiger auf FILE-Struktur.
Rückgabewert
Jede dieser Funktionen gibt einen nicht negativen Wert zurück, wenn es erfolgreich ist.Auf einem Fehler gibt fputsEOF und fputws gibt WEOF zurück.Wenn str oder stream ein NULL-Zeiger ist, rufen diese Funktionen den ungültigen Parameterhandler auf, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, legen diese Funktionen errno auf EINVAL fest und geben EOF oder WEOF zurück.
Siehe _doserrno, errno, _sys_errlist und _sys_nerr weitere Informationen zu diesen und anderen, Fehlercodes.
Hinweise
Jede dieser Funktionen kopiert str zur Ausgabe stream an der aktuellen Position.fputws kopiert das das Argument str zu stream als Mehrbyte-Zeichenfolge oder Zeichenfolge mit Breitzeichen, je nachdem ob stream im Textmodus oder im Binärdateimodus geöffnet ist, bzw.Keine arbeiten kopiert das NULL.
Die beiden Funktionen verhalten sich identisch, wenn der Stream in ANSI-Modus geöffnet ist.fputs nicht unterstützt Ausgabe in einen UNICODE-Stream.
Zuordnung generische 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 nicht in Windows Store-App unterstützt.Die Standardstreamhandles, die mit der Konsole, stdin, stdout und stderr zugeordnet werden, müssen umgeleitet werden, bevor sie C-Laufzeitfunktionen in Windows Store-App verwenden können.So zusätzlicher Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.
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 );
}
.NET Framework-Entsprechung
System::IO::StreamWriter::Write