====== time() ======

time ist definiert in der [[c:lib:time:start|time]], die in C über time.h, bzw. in C++ über ctime eingebunden wird.

===== Funktion =====

Die Funktion time() gibt die aktuelle Systemzeit als time_t-Objekt zurück. Wenn das Argument nicht NULL ist, dann wird der Wert auch in das angegebene time_t-Objekt geschrieben.

===== Signatur =====

<code cpp>
#include <time.h>
time_t time ( time_t * timer );
</code>

**timer:** Optional, wenn ungleich NULL dann wird in timer die aktuelle Systemzeit geschrieben. \\
**Return Value:** Aktuelle Systemzeit


===== Fehlerquellen =====
Tritt ein Fehler auf, dann ist der Rückgabewert gleich -1.

===== Beispiel =====

<code cpp>
#include <stdio.h>
#include <time.h>

//Programm gibt die Tage seit dem 1.1.1970 aus
int main (void)
{
   time_t sekunden;
   sekunden = time(NULL);
   printf ("Es sind %d Tage seit dem 1.1.1970 vergangen.\n", (sekunden/ (60*60*24)));
   return 0;
}
</code>

===== Siehe auch =====

[[c:lib:time:start|time]]: [[c:lib:time:time_t|time_t]]