fputs()
ist in der stdio
definiert, die in C über stdio.h
, bzw in C++ über cstdio
eingebunden wird.
fputs()
wird dazu verwendet, eine Zeichenkette (const char
*) in einen Stream zu schreiben. Als Stream kann die Standardausgabe (stdout
), die Fehlerausgabe (stderr
) oder ein selbst geöffneter Stream. Dies kann beispielsweise mit fopen()
getan werden.
#include <stdio.h> int fputs( const char * str, FILE * stream );
str: Ein char
-Array, welches in den Stream geschrieben werden soll.
stream: Ein Zeiger auf einen Stream.
„Return Value“: 0 oder ein anderer nicht negativer Wert falls der Schreibvorgang glückte, EOF
bei einem Fehler
Der gegebene string muss mit Nullbyte enden (\0
).
Es kommt leicht zu einer Verwechslung mit puts()
, welches direkt auf die Standardausgabe schreibt und ein Newline-Zeichen an den ausgebenden String anfügt. fputs()
fügt kein Newline-Zeichen an.
#include <stdio.h> #include <stdlib.h> int main(void) { /* Ausgabe auf der Standardausgabe*/ fputs("Dieser Text landet auf der Standardausgabe.\n", stdout); /* Ausgabe in eine Datei (wird zum Schreiben angelegt)*/ FILE* file = fopen("testfile.txt", "w"); fputs("Dieser Text landet in testfile.txt\n", file); fclose(file); return EXIT_SUCCESS; }
Auf der Konsole (Standardausgabe):
Dieser Text landet auf der Standardausgabe.
In der Datei testfile.txt
:
Dieser Text landet in testfile.txt