noble (3) clock.3.gz
BEZEICHNUNG
clock - ermittelt die verbrauchte CPU-Zeit
BIBLIOTHEK
Standard-C-Bibliothek (libc, -lc)
Ü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 │ └──────────────────────────────────────────────────────────────────────┴───────────────────────┴─────────┘
STANDARDS
POSIX.1-2001, POSIX.1-2008, 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)
Ü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 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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 die Mailingliste der Übersetzer ⟨debian-l10n-german@lists.debian.org⟩.