Skip to main content Link Search Menu Expand Document (external link)

TQueue.ts overview

Since v2.0.0


Exports Grouped by Category


constructors

bounded

Creates a bounded queue with the back pressure strategy. The queue will retain values until they have been taken, applying back pressure to offerors if the queue is at capacity.

For best performance use capacities that are powers of two.

Signature

declare const bounded: <A>(requestedCapacity: number) => STM.STM<TQueue<A>>

Source

Since v2.0.0

dropping

Creates a bounded queue with the dropping strategy. The queue will drop new values if the queue is at capacity.

For best performance use capacities that are powers of two.

Signature

declare const dropping: <A>(requestedCapacity: number) => STM.STM<TQueue<A>>

Source

Since v2.0.0

sliding

Creates a bounded queue with the sliding strategy. The queue will add new values and drop old values if the queue is at capacity.

For best performance use capacities that are powers of two.

Signature

declare const sliding: <A>(requestedCapacity: number) => STM.STM<TQueue<A>>

Source

Since v2.0.0

unbounded

Creates an unbounded queue.

Signature

declare const unbounded: <A>() => STM.STM<TQueue<A>>

Source

Since v2.0.0

getters

capacity

Returns the number of elements the queue can hold.

Signature

declare const capacity: <A>(self: TDequeue<A> | TEnqueue<A>) => number

Source

Since v2.0.0

isEmpty

Returns true if the TQueue contains zero elements, false otherwise.

Signature

declare const isEmpty: <A>(self: TDequeue<A> | TEnqueue<A>) => STM.STM<boolean>

Source

Since v2.0.0

isFull

Returns true if the TQueue contains at least one element, false otherwise.

Signature

declare const isFull: <A>(self: TDequeue<A> | TEnqueue<A>) => STM.STM<boolean>

Source

Since v2.0.0

isShutdown

Returns true if shutdown has been called, otherwise returns false.

Signature

declare const isShutdown: <A>(self: TDequeue<A> | TEnqueue<A>) => STM.STM<boolean>

Source

Since v2.0.0

peek

Views the next element in the queue without removing it, retrying if the queue is empty.

Signature

declare const peek: <A>(self: TDequeue<A>) => STM.STM<A>

Source

Since v2.0.0

peekOption

Views the next element in the queue without removing it, returning None if the queue is empty.

Signature

declare const peekOption: <A>(self: TDequeue<A>) => STM.STM<Option.Option<A>>

Source

Since v2.0.0

poll

Takes a single element from the queue, returning None if the queue is empty.

Signature

declare const poll: <A>(self: TDequeue<A>) => STM.STM<Option.Option<A>>

Source

Since v2.0.0

size

Retrieves the size of the queue, which is equal to the number of elements in the queue. This may be negative if fibers are suspended waiting for elements to be added to the queue.

Signature

declare const size: <A>(self: TDequeue<A> | TEnqueue<A>) => STM.STM<number>

Source

Since v2.0.0

models

BaseTQueue (interface)

The base interface that all TQueues must implement.

Signature

export interface BaseTQueue {
  /**
   * Returns the number of elements the queue can hold.
   */
  capacity(): number

  /**
   * Retrieves the size of the queue, which is equal to the number of elements
   * in the queue. This may be negative if fibers are suspended waiting for
   * elements to be added to the queue.
   */
  readonly size: STM.STM<number>

  /**
   * Returns `true` if the `TQueue` contains at least one element, `false`
   * otherwise.
   */
  readonly isFull: STM.STM<boolean>

  /**
   * Returns `true` if the `TQueue` contains zero elements, `false` otherwise.
   */
  readonly isEmpty: STM.STM<boolean>

  /**
   * Interrupts any fibers that are suspended on `offer` or `take`. Future calls
   * to `offer*` and `take*` will be interrupted immediately.
   */
  readonly shutdown: STM.STM<void>

  /**
   * Returns `true` if `shutdown` has been called, otherwise returns `false`.
   */
  readonly isShutdown: STM.STM<boolean>

  /**
   * Waits until the queue is shutdown. The `STM` returned by this method will
   * not resume until the queue has been shutdown. If the queue is already
   * shutdown, the `STM` will resume right away.
   */
  readonly awaitShutdown: STM.STM<void>
}

Source

Since v2.0.0

TDequeue (interface)

Signature

export interface TDequeue<out A> extends TQueue.TDequeueVariance<A>, BaseTQueue {
  /**
   * Views the next element in the queue without removing it, retrying if the
   * queue is empty.
   */
  readonly peek: STM.STM<A>

  /**
   * Views the next element in the queue without removing it, returning `None`
   * if the queue is empty.
   */
  readonly peekOption: STM.STM<Option.Option<A>>

  /**
   * Takes the oldest value in the queue. If the queue is empty, this will return
   * a computation that resumes when an item has been added to the queue.
   */
  readonly take: STM.STM<A>

  /**
   * Takes all the values in the queue and returns the values. If the queue is
   * empty returns an empty collection.
   */
  readonly takeAll: STM.STM<Array<A>>

  /**
   * Takes up to max number of values from the queue.
   */
  takeUpTo(max: number): STM.STM<Array<A>>
}

Source

Since v2.0.0

TEnqueue (interface)

Signature

export interface TEnqueue<in A> extends TQueue.TEnqueueVariance<A>, BaseTQueue {
  /**
   * Places one value in the queue.
   */
  offer(value: A): STM.STM<boolean>

  /**
   * For Bounded TQueue: uses the `BackPressure` Strategy, places the values in
   * the queue and always returns true. If the queue has reached capacity, then
   * the fiber performing the `offerAll` will be suspended until there is room
   * in the queue.
   *
   * For Unbounded TQueue: Places all values in the queue and returns true.
   *
   * For Sliding TQueue: uses `Sliding` Strategy If there is room in the queue,
   * it places the values otherwise it removes the old elements and enqueues the
   * new ones. Always returns true.
   *
   * For Dropping TQueue: uses `Dropping` Strategy, It places the values in the
   * queue but if there is no room it will not enqueue them and return false.
   */
  offerAll(iterable: Iterable<A>): STM.STM<boolean>
}

Source

Since v2.0.0

TQueue (interface)

Signature

export interface TQueue<in out A> extends TEnqueue<A>, TDequeue<A> {}

Source

Since v2.0.0

mutations

awaitShutdown

Waits until the queue is shutdown. The STM returned by this method will not resume until the queue has been shutdown. If the queue is already shutdown, the STM will resume right away.

Signature

declare const awaitShutdown: <A>(self: TDequeue<A> | TEnqueue<A>) => STM.STM<void>

Source

Since v2.0.0

offer

Places one value in the queue.

Signature

declare const offer: {
  <A>(value: A): (self: TEnqueue<A>) => STM.STM<void>
  <A>(self: TEnqueue<A>, value: A): STM.STM<void>
}

Source

Since v2.0.0

offerAll

For Bounded TQueue: uses the BackPressure Strategy, places the values in the queue and always returns true. If the queue has reached capacity, then the fiber performing the offerAll will be suspended until there is room in the queue.

For Unbounded TQueue: Places all values in the queue and returns true.

For Sliding TQueue: uses Sliding Strategy If there is room in the queue, it places the values otherwise it removes the old elements and enqueues the new ones. Always returns true.

For Dropping TQueue: uses Dropping Strategy, It places the values in the queue but if there is no room it will not enqueue them and return false.

Signature

declare const offerAll: {
  <A>(iterable: Iterable<A>): (self: TEnqueue<A>) => STM.STM<boolean>
  <A>(self: TEnqueue<A>, iterable: Iterable<A>): STM.STM<boolean>
}

Source

Since v2.0.0

seek

Drops elements from the queue while they do not satisfy the predicate, taking and returning the first element that does satisfy the predicate. Retries if no elements satisfy the predicate.

Signature

declare const seek: {
  <A>(predicate: Predicate<A>): (self: TDequeue<A>) => STM.STM<A>
  <A>(self: TDequeue<A>, predicate: Predicate<A>): STM.STM<A>
}

Source

Since v2.0.0

shutdown

Interrupts any fibers that are suspended on offer or take. Future calls to offer* and take* will be interrupted immediately.

Signature

declare const shutdown: <A>(self: TDequeue<A> | TEnqueue<A>) => STM.STM<void>

Source

Since v2.0.0

take

Takes the oldest value in the queue. If the queue is empty, this will return a computation that resumes when an item has been added to the queue.

Signature

declare const take: <A>(self: TDequeue<A>) => STM.STM<A>

Source

Since v2.0.0

takeAll

Takes all the values in the queue and returns the values. If the queue is empty returns an empty collection.

Signature

declare const takeAll: <A>(self: TDequeue<A>) => STM.STM<Array<A>>

Source

Since v2.0.0

takeBetween

Takes a number of elements from the queue between the specified minimum and maximum. If there are fewer than the minimum number of elements available, retries until at least the minimum number of elements have been collected.

Signature

declare const takeBetween: {
  (min: number, max: number): <A>(self: TDequeue<A>) => STM.STM<Array<A>>
  <A>(self: TDequeue<A>, min: number, max: number): STM.STM<Array<A>>
}

Source

Since v2.0.0

takeN

Takes the specified number of elements from the queue. If there are fewer than the specified number of elements available, it retries until they become available.

Signature

declare const takeN: {
  (n: number): <A>(self: TDequeue<A>) => STM.STM<Array<A>>
  <A>(self: TDequeue<A>, n: number): STM.STM<Array<A>>
}

Source

Since v2.0.0

takeUpTo

Takes up to max number of values from the queue.

Signature

declare const takeUpTo: {
  (max: number): <A>(self: TDequeue<A>) => STM.STM<Array<A>>
  <A>(self: TDequeue<A>, max: number): STM.STM<Array<A>>
}

Source

Since v2.0.0

refinements

isTDequeue

Returns true if the specified value is a TDequeue, false otherwise.

Signature

declare const isTDequeue: (u: unknown) => u is TDequeue<unknown>

Source

Since v2.0.0

isTEnqueue

Returns true if the specified value is a TEnqueue, false otherwise.

Signature

declare const isTEnqueue: (u: unknown) => u is TEnqueue<unknown>

Source

Since v2.0.0

isTQueue

Returns true if the specified value is a TQueue, false otherwise.

Signature

declare const isTQueue: (u: unknown) => u is TQueue<unknown>

Source

Since v2.0.0

symbols

TDequeueTypeId

Signature

declare const TDequeueTypeId: unique symbol

Source

Since v2.0.0

TDequeueTypeId (type alias)

Signature

type TDequeueTypeId = typeof TDequeueTypeId

Source

Since v2.0.0

TEnqueueTypeId

Signature

declare const TEnqueueTypeId: unique symbol

Source

Since v2.0.0

TEnqueueTypeId (type alias)

Signature

type TEnqueueTypeId = typeof TEnqueueTypeId

Source

Since v2.0.0

utils

TQueue (namespace)

Source

Since v2.0.0

TEnqueueVariance (interface)

Signature

export interface TEnqueueVariance<in A> {
  readonly [TEnqueueTypeId]: {
    readonly _In: Types.Contravariant<A>
  }
}

Source

Since v2.0.0

TDequeueVariance (interface)

Signature

export interface TDequeueVariance<out A> {
  readonly [TDequeueTypeId]: {
    readonly _Out: Types.Covariant<A>
  }
}

Source

Since v2.0.0