From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/c/chrono%2Ftimespec_getres.html | 34 +++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 devdocs/c/chrono%2Ftimespec_getres.html (limited to 'devdocs/c/chrono%2Ftimespec_getres.html') diff --git a/devdocs/c/chrono%2Ftimespec_getres.html b/devdocs/c/chrono%2Ftimespec_getres.html new file mode 100644 index 00000000..b40a3243 --- /dev/null +++ b/devdocs/c/chrono%2Ftimespec_getres.html @@ -0,0 +1,34 @@ +

timespec_getres

Defined in header <time.h> 
int timespec_getres( struct timespec *ts, int base );
+		 (since C23)

If ts is non-null and base is supported by timespec_get, modifies *ts to hold the resolution of time provided by timespec_get for base. For each supported base, multiple calls to timespec_getres during the same program execution have identical results.

+

Parameters

+ + +
ts - pointer to an object of type struct timespec
base - TIME_UTC or another nonzero integer value indicating the time base

Return value

The value of base if base is supported, zero otherwise.

+

Notes

The POSIX function clock_getres(clock_id, ts) may also be used to populate a timespec with the resolution of time identified by clock_id.

+

Example

#include <stdio.h>
+#include <time.h>
+ 
+int main(void)
+{
+    char buff[128];
+    struct timespec ts;
+    const int res = timespec_getres(&ts, TIME_UTC);
+    if (res == TIME_UTC) {
+        struct tm timer;
+        strftime(buff, sizeof buff, "%D %T", gmtime_r(&ts.tv_sec, &timer));
+        printf("Time resolution info: %s.%09ld UTC\n", buff, ts.tv_nsec);
+    } else {
+        printf("TIME_UTC base is not supported.");
+    }
+}

Possible output:

+
Time resolution info: 01/01/70 00:00:00.000000001 UTC

See also

+ + +
+
(C11)
 time in seconds and nanoseconds
(struct)
+
(C11)
 returns the calendar time in seconds and nanoseconds based on a given time base
(function)
returns the current calendar time of the system as time since epoch
(function)
+

+ © cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
+ https://en.cppreference.com/w/c/chrono/timespec_getres +

+
-- cgit v1.2.3