net

definition of a request handler.

defines constants for protocol families which
can be used for network communication.

defines constants for network protocols that
can be used for network communication.
usually there is only one possible protocol
for each pair of family and socket type.

defines constants for socket types which
specify the communication semantics to
used in a socket.

create a String from this instance. Unless redefined, `a.as_string` will
create `"instance[T]"` where `T` is the dynamic type of `a`

This tries establishing a connection to `host`
on success it uses the installed `request_handler`
to process the request.

Minimal example:


Blocks until connection is establised.
NYI blocking / none blocking

Get the dynamic type of this instance. For value instances `x`, this is
equal to `type_of x`, but for `x` with a `ref` type `x.dynamic_type` gives
the actual runtime type, while `type_of x` results in the static
compile-time type.

There is no dynamic type of a type instance since this would result in an
endless hierachy of types. So for Type values, dynamic_type is redefined
to just return Type.type.

name of this type, including type parameters, e.g. 'option (list i32)'.

convenience prefix operator to create a string from a value.

This permits usage of `$` as a prefix operator in a similar way both
inside and outside of constant strings: $x and "$x" will produce the
same string.

get currently installed server from env

open new server bound to the any address listening on port
closes currently installed server
NYI blocking / none blocking

open new server bound to addr listening on port
closes currently installed server
NYI blocking / none blocking

definition of a request handler.

a channel encapsulates an open network resource
that can be read from and written to.
channels are usually installed by a successfully connected client
or a by a newly accepted server connection.

Note that even though UDP is a connection-less protocol its
usage in fuzion does not differ from TCP except for the following
caveats.
1) Reading a Datagram with a buffer not large enough to hold
all data will lead to the rest of the datagram being dropped.
2) writing to a channel installed by `server.accept` will result in an error.
3) reading from a channel installed by `client ...` will block indefinitely.

defines constants for protocol families which
can be used for network communication.

defines constants for network protocols that
can be used for network communication.
usually there is only one possible protocol
for each pair of family and socket type.

server -- effect for storing a bound - and in the
case of TCP, listening - socket descriptor.

Basic usage description:
1) Initialize the server, e.g. like this:
`server family.ipv4 protocol.tcp 8080`
2) accept a new connection:

defines constants for socket types which
specify the communication semantics to
used in a socket.

Get a type as a value.

This is a feature with the effect equivalent to Fuzion's `expr.type` call tail.
It is recommended to use `expr.type` and not `expr.type_value`.

`type_value` is here to show how this can be implemented and to illustrate the
difference to `dynamic_type`.