focal (3) clock.3.gz

BEZEICHNUNG

       clock - ermittelt die verbrauchte CPU-Zeit

ÜBERSICHT

       #include <time.h>

       clock_t clock(void);

BESCHREIBUNG

       Die Funktion clock() gibt eine Näherung für die vom Programm verbrauchte Prozessorzeit zurück.

RÜCKGABEWERT

       Der  Rückgabewert  ist  die  bisher  verbrauchte  CPU-Zeit. Er ist vom Typ clock_t. Für die Umrechnung in
       Sekunden teilen ihn Sie durch CLOCKS_PER_SEC. Wenn die Prozessorzeit nicht verfügbar oder ihr Wert  nicht
       darstellbar ist, gibt die Funktion (clock_t) -1 zurück.

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

       ┌──────────────┬───────────────────────┬─────────┐
       │Schnittstelle │ Attribut              │ Wert    │
       ├──────────────┼───────────────────────┼─────────┤
       │clock()       │ Multithread-Fähigkeit │ MT-Safe │
       └──────────────┴───────────────────────┴─────────┘

KONFORM ZU

       POSIX.1-2001,  POSIX.1-2008,  C89, C99. XSI fordert, dass CLOCKS_PER_SEC unabhängig von der tatsächlichen
       Auflösung gleich 1000000 ist.

ANMERKUNGEN

       Der  C-Standard  lässt  willkürliche  Werte  beim  Programmstart  zu.  Um  maximale   Portierbarkeit   zu
       gewährleisten, subtrahieren Sie jeweils den Rückgabewert von clock() beim Programmstart.

       Beachten  Sie,  dass  Zeit  überlaufen kann. Auf einem 32-Bit-System, auf dem CLOCKS_PER_SEC 1000000 ist,
       wird diese Funktion ungefähr alle 72 Minuten den gleichen Wert zurückgeben.

       Es gibt einige andere Implementierungen, bei denen der Rückgabewert  von  clock()  auch  die  Zeiten  der
       Kindprozesse  enthält, deren Status mittels wait (oder einem Aufruf einer anderen Funktion vergleichbarer
       Funktionalität) ermittelt wurden. Die  Linux-Implementierung  schließt  im  Rückgabewert  von  clock  die
       Wartezeiten  auf  Kindprozesse  nicht  mit  ein.  Die  Funktion  times(2)  liefert detaillierte, separate
       Informationen über den aufrufenden Prozess und seine Kindprozesse zurück. Sie ist vorzuziehen,  wenn  Sie
       diese Informationen benötigen.

       In  glibc  2.17  und  früher  setzte clock() auf times(2) auf. Zur Verbesserung der Präzision ist es seit
       glibc 2.18  als  Aufsatz  von  clock_gettime(2)  implementiert  (wobei  die  CLOCK_PROCESS_CPUTIME_ID-Uhr
       verwendet wird).

SIEHE AUCH

       clock_gettime(2), getrusage(2), times(2)

KOLOPHON

       Diese  Seite  ist  Teil  der  Veröffentlichung  5.03  des Projekts Linux-man-pages. Eine Beschreibung des
       Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden
       sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die  deutsche  Übersetzung  dieser  Handbuchseite  wurde  von Michael Piefel <piefel@debian.org>, Patrick
       Rother  <krd@gulu.net>,  Martin  Eberhard  Schauer  <Martin.E.Schauer@gmx.de>   und   Mario   Blättermann
       <mario.blaettermann@gmail.com> erstellt.

       Diese  Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer
       bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

       Wenn Sie Fehler in der Übersetzung dieser  Handbuchseite  finden,  schicken  Sie  bitte  eine  E-Mail  an
       <debian-l10n-german@lists.debian.org>.