otter-nif 0.3.1

Write Erlang NIFs in Rust. Direct mapping of the NIF C ABI with compile-time lifetime safety and no hidden magic.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

//! BEAM time functions.
//!
//! Wraps `enif_monotonic_time`, `enif_time_offset`, and
//! `enif_convert_time_unit`.

/// A BEAM time value, in the [`TimeUnit`] it was produced with. Re-exported from
/// `enif_ffi`.
pub use enif_ffi::Time;
/// The unit a [`Time`] value is expressed in (`ErlNifTimeUnit` — seconds,
/// milliseconds, microseconds, nanoseconds). Re-exported from `enif_ffi`.
pub use enif_ffi::TimeUnit;

/// Return the current BEAM monotonic time in the given unit.
///
/// Wraps `enif_monotonic_time`.
pub fn monotonic_time(unit: TimeUnit) -> Time {
    unsafe { enif_ffi::monotonic_time(unit) }
}

/// Return the current BEAM time offset in the given unit.
///
/// `monotonic_time + time_offset = system_time` (Erlang system time).
///
/// Wraps `enif_time_offset`.
pub fn time_offset(unit: TimeUnit) -> Time {
    unsafe { enif_ffi::time_offset(unit) }
}

/// Convert a time value from one unit to another.
///
/// Wraps `enif_convert_time_unit`.
pub fn convert_time_unit(val: Time, from: TimeUnit, to: TimeUnit) -> Time {
    unsafe { enif_ffi::convert_time_unit(val, from, to) }
}