gettimeofday()
QNX SDP8.0C Library ReferenceAPIDeveloper
Get the current time
Synopsis:
#include <sys/time.h>
int gettimeofday( struct timeval * when,
void * not_used );
Arguments:
- when
- A pointer to a timeval structure where the function
can store the time.
The struct timeval contains the following members:
- time_t tv_sec — the number of seconds since the start of the Unix Epoch.
- suseconds_t tv_usec — the number of microseconds.
- not_used
- This pointer must be NULL or the behavior of gettimeofday() is undefined. This argument is provided only for backwards compatibility.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The gettimeofday() function returns the current time in when in seconds and microseconds, since the Unix Epoch, 00:00:00 January 1, 1970 Coordinated Universal Time (UTC) (formerly known as Greenwich Mean Time (GMT)).
Returns:
0 for success, or -1 if an error occurs (errno is set).
Errors:
- EFAULT
- An error occurred while accessing the when buffer.
Classification:
POSIX 1003.1 OB XSI. This function is marked as obsolescent, and may be removed from a future version of the standard.
| Safety: | |
|---|---|
| Cancellation point | No |
| Signal handler | Yes |
| Thread | Yes |
Caveats:
The gettimeofday() function is provided for porting existing code. You shouldn't use it in new code; use clock_gettime() instead.
Page updated: