Class NetworkState

The NetworkState monitor handles tracking the usage of a NetworkModule. The up method is used to signal that a client needs to use the module and the down method is used to signal that it is no longer needed.
Multiple clients can request access to the NetworkModule simultaneously, so the accesses need to be synchronized through the monitor operations.

Class summary


module -> NetworkModule
up [create] -> NetworkModule
up [--if-unconnected] -> NetworkModule
down -> none
operator == other/any -> bool
Whether this object is equal to the other.
stringify -> string
Stringifies this object.
await [condition] -> none
Yields until the condition block returns true.
try-await --deadline/int [condition] -> any
Yields until the condition block returns true or until the given deadline is reached.

Methods

await [condition] -> none
Yields until the condition block returns true.
This should be called from a locked method.
The condition is not allowed to change the state, only query it.

down -> none

operator == other/any -> bool
Whether this object is equal to the other.
By default, identical is used for equality.
Inheritance
Classes overwrite this operator to get an equality specific to their needs. Equality operators often compare the type and field contents. For example:

class Pin:
  number/int

  constructor .number:

  operator == other:
    if other is not Pin: return false
    return number == other.number
A class doesn't have to follow the above format, but it must keep the operator in sync with any hash-code method. That is, if a class has a hash-code member, then the equality and hash-code must agree. If two instances are equal (a == b), then their hash codes must also be equal (a.hash-code == b.hash-code).

Stringifies this object.
Inheritance
Objects that need a human-friendly string representation should overwrite this method. The default string is based on the internal class-ID.

try-await --deadline/int [condition] -> any
Yields until the condition block returns true or until the given deadline is reached.
Returns true if the condition has been met or false if we have reached the deadline.
This should be called from a locked method.
The condition is not allowed to change the state, only query it.

up [create] -> NetworkModule

up [--if-unconnected] -> NetworkModule