rcutils  master
C API providing common utilities and data structures.
time.h
Go to the documentation of this file.
1 // Copyright 2015 Open Source Robotics Foundation, Inc.
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License");
4 // you may not use this file except in compliance with the License.
5 // You may obtain a copy of the License at
6 //
7 // http://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS IS" BASIS,
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 // See the License for the specific language governing permissions and
13 // limitations under the License.
14 
16 
17 #ifndef RCUTILS__TIME_H_
18 #define RCUTILS__TIME_H_
19 
20 #ifdef __cplusplus
21 extern "C"
22 {
23 #endif
24 
25 #include <stdint.h>
26 
27 #include "rcutils/macros.h"
28 #include "rcutils/types.h"
30 
32 #define RCUTILS_S_TO_NS(seconds) ((seconds) * (1000LL * 1000LL * 1000LL))
33 #define RCUTILS_MS_TO_NS(milliseconds) ((milliseconds) * (1000LL * 1000LL))
35 #define RCUTILS_US_TO_NS(microseconds) ((microseconds) * 1000LL)
37 
39 #define RCUTILS_NS_TO_S(nanoseconds) ((nanoseconds) / (1000LL * 1000LL * 1000LL))
40 #define RCUTILS_NS_TO_MS(nanoseconds) ((nanoseconds) / (1000LL * 1000LL))
42 #define RCUTILS_NS_TO_US(nanoseconds) ((nanoseconds) / 1000LL)
44 #define RCUTILS_STEADY_TIME rcutils_steady_time_now
46 
50 typedef int64_t rcutils_duration_value_t;
51 
78 
80 
106 
108 
142  const rcutils_time_point_value_t * time_point,
143  char * str,
144  size_t str_size);
145 
147 
181  const rcutils_time_point_value_t * time_point,
182  char * str,
183  size_t str_size);
184 
185 #ifdef __cplusplus
186 }
187 #endif
188 
189 #endif // RCUTILS__TIME_H_
rcutils_duration_value_t
int64_t rcutils_duration_value_t
A duration of time, measured in nanoseconds.
Definition: time.h:50
rcutils_system_time_now
rcutils_ret_t rcutils_system_time_now(rcutils_time_point_value_t *now)
types.h
macros.h
rcutils_time_point_value_as_seconds_string
rcutils_ret_t rcutils_time_point_value_as_seconds_string(const rcutils_time_point_value_t *time_point, char *str, size_t str_size)
Return a time point as floating point seconds in a string.
rcutils_ret_t
int rcutils_ret_t
The type that holds a return value for an rcutils operation.
Definition: rcutils_ret.h:26
RCUTILS_WARN_UNUSED
#define RCUTILS_WARN_UNUSED
A macro to make the compiler warn when the return value of a function is not used.
Definition: macros.h:27
rcutils_time_point_value_t
int64_t rcutils_time_point_value_t
A single point in time, measured in nanoseconds since the Unix epoch.
Definition: time.h:48
visibility_control.h
rcutils_steady_time_now
rcutils_ret_t rcutils_steady_time_now(rcutils_time_point_value_t *now)
Retrieve the current time as a rcutils_time_point_value_t object.
RCUTILS_PUBLIC
#define RCUTILS_PUBLIC
Definition: visibility_control.h:23
rcutils_time_point_value_as_nanoseconds_string
rcutils_ret_t rcutils_time_point_value_as_nanoseconds_string(const rcutils_time_point_value_t *time_point, char *str, size_t str_size)
Return a time point as nanoseconds in a string.