Packages

object ConcurrentQueue extends Serializable

Source
ConcurrentQueue.scala
Linear Supertypes
Serializable, AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. ConcurrentQueue
  2. Serializable
  3. AnyRef
  4. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Type Members

  1. final class ApplyBuilders[F[_]] extends AnyVal

    Returned by the apply builder.

Value Members

  1. def apply[F[_]](implicit F: Concurrent[F]): ApplyBuilders[F]

    Builds an ConcurrentQueue value for F data types that implement the Concurrent type class.

    Builds an ConcurrentQueue value for F data types that implement the Concurrent type class.

    This builder uses the Partially-Applied Type technique.

    F

    is a cats.effect.Concurrent type class restriction; this queue is built to work with Concurrent data types

  2. def bounded[F[_], A](capacity: Int)(implicit F: Concurrent[F], cs: ContextShift[F]): F[ConcurrentQueue[F, A]]

    Builds a limited capacity and back-pressured ConcurrentQueue.

    Builds a limited capacity and back-pressured ConcurrentQueue.

    capacity

    is the maximum capacity of the internal buffer; note that due to performance optimizations, the capacity of the internal buffer can get rounded to a power of 2, so the actual capacity may be slightly different than the one specified

    F

    is a cats.effect.Concurrent type class restriction; this queue is built to work with Concurrent data types

    cs

    is a ContextShift, needed for triggering async boundaries for fairness reasons, in case there's a need to back-pressure on the internal buffer

    See also

    unbounded for building an unbounded queue that can use the entire memory available to the process.

  3. def unbounded[F[_], A](chunkSizeHint: Option[Int] = None)(implicit F: Concurrent[F], cs: ContextShift[F]): F[ConcurrentQueue[F, A]]

    Builds an unlimited ConcurrentQueue that can use the entire memory available to the process.

    Builds an unlimited ConcurrentQueue that can use the entire memory available to the process.

    chunkSizeHint

    is an optimization parameter — the underlying implementation may use an internal buffer that uses linked arrays, in which case the "chunk size" represents the size of a chunk; providing it is just a hint, it may or may not be used

    F

    is a cats.effect.Concurrent type class restriction; this queue is built to work with Concurrent data types

    cs

    is a ContextShift, needed for triggering async boundaries for fairness reasons, in case there's a need to back-pressure on the internal buffer

    See also

    bounded for building a limited capacity queue.

  4. def unsafe[F[_], A](capacity: BufferCapacity, channelType: ChannelType = MPMC)(implicit F: Concurrent[F], cs: ContextShift[F]): ConcurrentQueue[F, A]

    The unsafe version of the ConcurrentQueue.bounded builder.

    The unsafe version of the ConcurrentQueue.bounded builder.

    UNSAFE PROTOCOL: This is unsafe due to problems that can happen via selecting the wrong ChannelType, so use with care.

    UNSAFE BECAUSE IMPURE: this builder violates referential transparency, as the queue keeps internal, shared state. Only use when you know what you're doing, otherwise prefer ConcurrentQueue.withConfig or ConcurrentQueue.bounded.

    capacity

    specifies the BufferCapacity, which can be either "bounded" (with a maximum capacity), or "unbounded"

    channelType

    (UNSAFE) specifies the concurrency scenario, for fine tuning the performance

    F

    is a cats.effect.Concurrent type class restriction; this queue is built to work with Concurrent data types

    cs

    is a ContextShift, needed for triggering async boundaries for fairness reasons, in case there's a need to back-pressure on the internal buffer

    Annotations
    @UnsafeProtocol() @UnsafeBecauseImpure()
  5. def withConfig[F[_], A](capacity: BufferCapacity, channelType: ChannelType)(implicit F: Concurrent[F], cs: ContextShift[F]): F[ConcurrentQueue[F, A]]

    Builds an ConcurrentQueue with fined tuned config parameters.

    Builds an ConcurrentQueue with fined tuned config parameters.

    UNSAFE PROTOCOL: This is unsafe due to problems that can happen via selecting the wrong ChannelType, so use with care.

    capacity

    specifies the BufferCapacity, which can be either "bounded" (with a maximum capacity), or "unbounded"

    channelType

    (UNSAFE) specifies the concurrency scenario, for fine tuning the performance

    F

    is a cats.effect.Concurrent type class restriction; this queue is built to work with Concurrent data types

    cs

    is a ContextShift, needed for triggering async boundaries for fairness reasons, in case there's a need to back-pressure on the internal buffer

    Annotations
    @UnsafeProtocol()