====== system() ======

''system()'' ist in der ''[[c:lib:stdlib:start|stdlib]]'' definiert, die in C über ''stdlib.h'', bzw in C++ über ''cstdlib'' eingebunden wird.

===== Funktion =====

''system()'' führt einen Shell-Befehl aus.

===== Signatur =====

<code cpp>#include <stdlib.h>
char * system( char const * command );</code>

**command**: Shell-Befehl, der ausgeführt werden soll\\
\\
**Return Value**: -1 im Fehlerfall oder den Rückgabewert des Shell-Befehls.

===== Fehlerquellen =====

-

===== Beispiel =====

<code cpp>
#include <stdio.h>
#include <stdlib.h>
 
int main (void)
{
  char * command = "ls -l /non-existent";
 
  int ret = system( command );
 
  if( ret == -1 )
    printf( "Fehler beim Initialisieren der Shell.\n");
  else if( ret > 0 )
    printf( "Programm mit Code %d beendet.\n", ret );
  else 
    printf( "Programm ohne Fehler durchgelaufen\n" );
 
  return EXIT_SUCCESS;
}</code>

**Ausgabe** \\
  ls: Zugriff auf /non-existent nicht möglich: Datei oder Verzeichnis nicht gefunden
  Programm mit Code 2 beendet.

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

[[c:lib:stdlib:]]: [[abort()]], [[atexit()]], [[exit()]]