std::clock

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Datums- und Zeitbibliothek

Zeitpunkt time_point (C++11) clock_time_conversion (C++20)   clock_cast (C++20) Dauer duration (C++11) Uhren system_clock (C++11) steady_clock (C++11) is_clock (C++20) utc_clock (C++20) tai_clock (C++20) high_resolution_clock (C++11) gps_clock (C++20) file_clock (C++20) local_t (C++20) Tageszeit is_amis_pm (C++20)(C++20) make12make24 (C++20)(C++20) hh_mm_ss (C++20)

Kalender day (C++20) month (C++20) year (C++20) weekday (C++20) operator/ (C++20) year_month_day (C++20) year_month_day_last (C++20) year_month_weekday (C++20) year_month_weekday_last (C++20)   weekday_indexed (C++20) weekday_last (C++20) month_day (C++20) month_day_last (C++20) month_weekday (C++20) month_weekday_last (C++20) year_month (C++20) last_speclast (C++20)(C++20) chrono E/A parse (C++20)

Zeitzone tzdb (C++20) tzdb_list (C++20) get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)(C++20)(C++20)(C++20) sys_info (C++20) local_info (C++20) nonexistent_local_time (C++20) ambiguous_local_time (C++20) locate_zone (C++20) current_zone (C++20) time_zone (C++20) choose (C++20) zoned_traits (C++20) zoned_time (C++20) time_zone_link (C++20) leap_second (C++20) leap_second_info (C++20) get_leap_second_info (C++20) C-Stil Datums- und Zeitfunktionen

 

C-Stil Datums- und Zeitwerkzeuge

Funktionen

Zeitmanipulation

difftime

time

clock

timespec_get (C++17)

Formatkonvertierungen

asctime

ctime

strftime

wcsftime

gmtime

localtime

mktime

Konstanten

CLOCKS_PER_SEC

Typen

tm

time_t

clock_t

timespec (C++17)

 

Definiert im Header <ctime>
std::clock_t clock();

Gibt die von dem Prozess seit Beginn einer implementierungsdefinierten Ära, die mit der Ausführung des Programms zusammenhängt, genutzte ungefähre Prozessorzeit zurück. Um den Rückgabewert in Sekunden umzurechnen, dividieren Sie ihn durch CLOCKS_PER_SEC.

Nur die Differenz zwischen zwei von verschiedenen Aufrufen von std::clock zurückgegebenen Werten ist aussagekräftig, da der Beginn der std::clock-Ära nicht mit dem Programmstart übereinstimmen muss.

Die Zeit von std::clock kann schneller oder langsamer als die Wanduhr vergehen, abhängig von den vom Betriebssystem dem Programm zugewiesenen Ausführungsressourcen. Wenn zum Beispiel die CPU von anderen Prozessen geteilt wird, kann die Zeit von std::clock langsamer als die Wanduhr vergehen. Wenn andererseits der aktuelle Prozess multithreaded ist und mehr als ein Ausführungskern verfügbar ist, kann die Zeit von std::clock schneller als die Wanduhr vergehen.

Rückgabewert

Bisher vom Programm genutzte Prozessorzeit.

• Wenn die genutzte Prozessorzeit nicht verfügbar ist, wird (std::clock_t)(-1) zurückgegeben.
• Wenn der Wert der genutzten Prozessorzeit nicht durch std::clock_t dargestellt werden kann, wird ein nicht spezifizierter Wert zurückgegeben.

Ausnahmen

Wirft nichts.

Hinweise

Auf POSIX-kompatiblen Systemen bietet clock_gettime mit der Clock-ID CLOCK_PROCESS_CPUTIME_ID eine bessere Auflösung.

Der von clock() zurückgegebene Wert kann bei einigen Implementierungen überlaufen. Zum Beispiel wird bei einer solchen Implementierung, wenn std::clock_t ein vorzeichenbehafteter 32-Bit-Integer ist und CLOCKS_PER_SEC 1'000'000 beträgt, dieser nach etwa 2147 Sekunden (etwa 36 Minuten) überlaufen.

Beispiel

Dieses Beispiel demonstriert den Unterschied zwischen der clock()-Zeit und der Echtzeit.

Führen Sie diesen Code aus

#include <chrono>
#include <ctime>
#include <iomanip>
#include <iostream>
#include <thread>
 
// The function f() does some time-consuming work.
void f()
{
    volatile double d = 0;
    for (int n = 0; n != 10000; ++n)
        for (int m = 0; m != 10000; ++m)
            d += d * n * m;
}
 
int main()
{
    const std::clock_t c_start = std::clock();
    auto t_start = std::chrono::high_resolution_clock::now();
    std::thread t1(f);
    std::thread t2(f); // f() is called on two threads
    t1.join();
    t2.join();
    const std::clock_t c_end = std::clock();
    const auto t_end = std::chrono::high_resolution_clock::now();
 
    std::cout << std::fixed << std::setprecision(2) << "CPU time used: "
              << 1000.0 * (c_end - c_start) / CLOCKS_PER_SEC << "ms\n"
              << "Wall clock time passed: "
              << std::chrono::duration<double, std::milli>(t_end - t_start) << '\n';
}

Mögliche Ausgabe

CPU time used: 1590.00ms
Wall clock time passed: 808.23ms

Siehe auch

ctime	konvertiert ein std::time_t-Objekt in eine textuelle Darstellung (Funktion)
time	gibt die aktuelle Zeit des Systems als Zeit seit der Epoche zurück (Funktion)
C-Dokumentation für clock