====== fputs() ======

''fputs()'' ist in der ''[[c:lib:stdio:start|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 ''[[c:lib:stdio:fopen|fopen()]]'' getan werden.

===== Signatur =====

<code cpp>#include <stdio.h>
int fputs( const char * str, FILE * stream );</code>

**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 =====

<code cpp>
#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;
}</code>
===== Ausgabe =====
Auf der Konsole (Standardausgabe):
  Dieser Text landet auf der Standardausgabe.
In der Datei ''testfile.txt'':
  Dieser Text landet in testfile.txt

===== siehe auch =====

[[c:lib:stdio:start|stdio]]: [[c:lib:stdio:puts]], [[c:lib:stdio:fgets]], [[c:lib:stdio:printf]]