Google Git
Sign in
android / platform / external / rust / crates / instant / 9f7c650d452d7e8b3e3dea38a80fa4a24e7f7879
commit9f7c650d452d7e8b3e3dea38a80fa4a24e7f7879[log] [tgz]
authorWilliam Escande <[email protected]>Mon Aug 22 23:24:42 2022 +0000
committerAutomerger Merge Worker <[email protected]>Mon Aug 22 23:24:42 2022 +0000
tree164dab4e974239b8593234cfafe0932b666bed3f
parent5524d581447197bebc2c8b3cad3dcf02450a3c67 [diff]
parentc73201f403c78827fa37b67a4794502697cf4d9f [diff]
[Bluetooth apex] Use new apex name am: 383d6e8f5b am: 5274813946 am: ae4f34cf42 am: df694db78c am: c73201f403

Original change: https://android-review.googlesource.com/c/platform/external/rust/crates/instant/+/2192102

Change-Id: I02ebb056d59132fa7bb6bbad91bf24dcea252f8a
Signed-off-by: Automerger Merge Worker <[email protected]>
tree: 164dab4e974239b8593234cfafe0932b666bed3f
  1. .circleci/
  2. src/
  3. tests/
  4. .cargo_vcs_info.json
  5. .gitignore
  6. Android.bp
  7. AUTHORS
  8. Cargo.toml
  9. Cargo.toml.orig
  10. cargo2android.json
  11. CHANGELOGS.md
  12. LICENSE
  13. METADATA
  14. MODULE_LICENSE_BSD_LIKE
  15. OWNERS
  16. README.md
README.md

Instant

If you call std::time::Instant::now() on a WASM platform, it will panic. This crate provides a partial replacement for std::time::Instant that works on WASM too. This defines the type instant::Instant which is:

  • A struct emulating the behavior of std::time::Instant if you are targeting wasm32-unknown-unknown or wasm32-unknown-asmjs and you enabled either the stdweb or the wasm-bindgen feature. This emulation is based on the javascript performance.now() function.
  • A type alias for std::time::Instant otherwise.

Note that even if the stdweb or wasm-bindgen feature is enabled, this crate will continue to rely on std::time::Instant as long as you are not targeting wasm32. This allows for portable code that will work on both native and WASM platforms.

This crate also exports the function instant::now() which returns a representation of the current time as an f64, expressed in milliseconds, in a platform-agnostic way. instant::now() will either:

  • Call performance.now() when compiling for a WASM platform with the features stdweb or wasm-bindgen enabled, or using a custom javascript function.
  • Return the time elapsed since the Unix Epoch on native, non-WASM platforms.

Note: The old feature, now, has been deprecated. instant::now() is always exported and the now feature flag no longer has any effect. It remains listed in Cargo.toml to avoid introducing breaking changes and may be removed in future versions.

Examples

Using instant for a native platform.

Cargo.toml:

[dependencies]
instant = "0.1"

main.rs:

fn main() {
    // Will be the same as `std::time::Instant`.
    let now = instant::Instant::now();
}

Using instant for a WASM platform.

This example shows the use of the stdweb feature. It would be similar with wasm-bindgen.

Cargo.toml:

[dependencies]
instant = { version = "0.1", features = [ "stdweb" ] }

main.rs:

fn main() {
    // Will emulate `std::time::Instant` based on `performance.now()`.
    let now = instant::Instant::now();
}

Using instant for a WASM platform where performance.now() is not available.

This example shows the use of the inaccurate feature.

Cargo.toml:

[dependencies]
instant = { version = "0.1", features = [ "wasm-bindgen", "inaccurate" ] }

main.rs:

fn main() {
    // Will emulate `std::time::Instant` based on `Date.now()`.
    let now = instant::Instant::now();
}

Using instant for any platform enabling a feature transitively.

Cargo.toml:

[features]
stdweb = [ "instant/stdweb" ]
wasm-bindgen = [ "instant/wasm-bindgen" ]

[dependencies]
instant = "0.1"

lib.rs:

fn my_function() {
    // Will select the proper implementation depending on the
    // feature selected by the user.
    let now = instant::Instant::now();
}

Using instant::now()

Cargo.toml:

[features]
stdweb = [ "instant/stdweb" ]
wasm-bindgen = [ "instant/wasm-bindgen" ]

[dependencies]
instant = "0.1"

lib.rs:

fn my_function() {
    // Will select the proper implementation depending on the
    // feature selected by the user.
    let now_instant = instant::Instant::now();
    let now_milliseconds = instant::now(); // In milliseconds.
}

Using the feature now without stdweb or wasm-bindgen.

Cargo.toml:

[dependencies]
instant = "0.1"

lib.rs:

fn my_function() {
    // Will use the 'now' javascript implementation.
    let now_instant = instant::Instant::now();
    let now_milliseconds = instant::now(); // In milliseconds.
}

javascript WASM bindings file:

function now() {
	return Date.now() / 1000.0;
}