UnboundedChannel

gears.async.UnboundedChannel
See theUnboundedChannel companion object
trait UnboundedChannel[T] extends BufferedChannel[T]

Unbounded channels are buffered channels that do not have an upper bound on the number of items in the channel. In other words, the buffer is treated as never being full and will expand as needed.

See UnboundedChannel$.apply for creation of unbounded channels.

Attributes

Companion
object
Graph
Supertypes
trait BufferedChannel[T]
trait Channel[T]
trait Closeable
trait AutoCloseable
trait ReadableChannel[T]
trait SendableChannel[T]
class Object
trait Matchable
class Any
Show all

Members list

Value members

Abstract methods

def sendImmediately(x: T): Unit

Sends the item immediately.

Sends the item immediately.

Attributes

Throws
ChannelClosedException

if the channel is closed.

Inherited methods

final inline def asCloseable: Closeable

Restrict this channel to close-only.

Restrict this channel to close-only.

Attributes

Inherited from:
Channel
final inline def asReadable: ReadableChannel[T]

Restrict this channel to read-only.

Restrict this channel to read-only.

Attributes

Inherited from:
Channel
final inline def asSendable: SendableChannel[T]

Restrict this channel to send-only.

Restrict this channel to send-only.

Attributes

Inherited from:
Channel
def read()(using Async): Res[T]

Read an item from the channel, suspending until the item has been received. Returns Failure(ChannelClosedException) if the channel was closed.

Read an item from the channel, suspending until the item has been received. Returns Failure(ChannelClosedException) if the channel was closed.

Attributes

Inherited from:
ReadableChannel
def send(x: T)(using Async): Unit

Send x over the channel, suspending until the item has been sent or, if the channel is buffered, queued.

Send x over the channel, suspending until the item has been sent or, if the channel is buffered, queued.

Attributes

Throws
ChannelClosedException

if the channel was closed.

Inherited from:
SendableChannel

Inherited and Abstract methods

def close(): Unit

Attributes

Inherited from:
Closeable
def sendSource(x: T): Source[Res[Unit]]

Create an Async.Source representing the send action of value x.

Create an Async.Source representing the send action of value x.

Note that each listener attached to and accepting an Unit value corresponds to x being sent once.

To create an Async.Source that sends the item exactly once regardless of listeners attached, wrap the send operation inside a gears.async.Future:

val sendOnce = Future(ch.send(x))

Attributes

Returns

an Async.Source that resolves with Right(()) when x is sent to the channel, or Left(Closed) if the channel is already closed. This source will perform a send operation every time a listener is attached to it, or every time it is Async$.awaited on.

Inherited from:
SendableChannel

Inherited and Abstract fields

val readSource: Source[Res[T]]

An Async.Source corresponding to items being sent over the channel. Note that each listener attached to and accepting a Right value corresponds to one value received over the channel.

An Async.Source corresponding to items being sent over the channel. Note that each listener attached to and accepting a Right value corresponds to one value received over the channel.

To create an Async.Source that reads exactly one item regardless of listeners attached, wrap the read operation inside a gears.async.Future.

val readOnce = Future(ch.read(x))

Attributes

Inherited from:
ReadableChannel