fputs()

fputs() ist in der stdio definiert, die in C über stdio.h, bzw in C++ über cstdio eingebunden wird.

Funktion

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.

Signatur

#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

Fehlerquellen

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.

Beispiel

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

Ausgabe

Auf der Konsole (Standardausgabe):

Dieser Text landet auf der Standardausgabe.

In der Datei testfile.txt:

Dieser Text landet in testfile.txt

siehe auch