monotonicclock

Documentation

Overview

Package monotonicclock represents the imported interface "wasi:clocks/monotonic-clock@0.2.0".

WASI Monotonic Clock is a clock API intended to let users measure elapsed time.

It is intended to be portable at least between Unix-family platforms and Windows.

A monotonic clock is a clock which has an unspecified initial value, and successive reads of the clock will produce non-decreasing values.

It is intended for measuring elapsed time.

Index

• type Duration
  • func Resolution() (result Duration)
• type Instant
  • func Now() (result Instant)
• type Pollable
  • func SubscribeDuration(when Duration) (result Pollable)
  • func SubscribeInstant(when Instant) (result Pollable)

Types

type Duration

type Duration uint64

Duration represents the u64 "wasi:clocks/monotonic-clock@0.2.0#duration".

A duration of time, in nanoseconds.

type duration = u64

func Resolution

func Resolution() (result Duration)

Resolution represents the imported function "resolution".

Query the resolution of the clock. Returns the duration of time corresponding to a clock tick.

resolution: func() -> duration

type Instant

type Instant uint64

Instant represents the u64 "wasi:clocks/monotonic-clock@0.2.0#instant".

An instant in time, in nanoseconds. An instant is relative to an unspecified initial value, and can only be compared to instances from the same monotonic-clock.

type instant = u64

func Now

func Now() (result Instant)

Now represents the imported function "now".

Read the current value of the clock.

The clock is monotonic, therefore calling this function repeatedly will produce a sequence of non-decreasing values.

now: func() -> instant

type Pollable

type Pollable = poll.Pollable

Pollable represents the imported type alias "wasi:clocks/monotonic-clock@0.2.0#pollable".

See poll.Pollable for more information.

func SubscribeDuration

func SubscribeDuration(when Duration) (result Pollable)

SubscribeDuration represents the imported function "subscribe-duration".

Create a `pollable` which will resolve once the given duration has elapsed, starting at the time at which this function was called. occured.

subscribe-duration: func(when: duration) -> pollable

func SubscribeInstant

func SubscribeInstant(when Instant) (result Pollable)

SubscribeInstant represents the imported function "subscribe-instant".

Create a `pollable` which will resolve once the specified instant occured.

subscribe-instant: func(when: instant) -> pollable