package eio

  1. Overview
  2. Docs
Effect-based direct-style IO API for OCaml

Install 

dune-project
 Dependency

github.com Readme Changelog ISC License Edit opam file Versions (21)

Authors

  1. A
    Anil Madhavapeddy
  2. T
    Thomas Leonard

Maintainers

  1. A
    anil@recoil.org

Sources

eio-1.5.tbz
sha256=7d70d1f5fb2b7190bf1ab28fffeb272da51ffe6d6c9c7c94e0485fabdf3b3fda
sha512=4582ac2fb2f8616b3d8ae9670eb7913a78085899b14044408801b30a34fed6c4d32971ba72eedb0cbc3d82c057610cf81c482090e75e2985330fcde96478ac5e

doc/eio.utils/Eio_utils/Lf_queue/index.html

Module Eio_utils.Lf_queueSource

A lock-free multi-producer, single-consumer, thread-safe queue without support for cancellation. This makes a good data structure for a scheduler's run queue.

Sourcetype 'a t

A queue of items of type 'a.

Sourceexception Closed
Sourceval create : unit -> 'a t

create () is a new empty queue.

Sourceval push : 'a t -> 'a -> unit

push t x adds x to the tail of the queue. This can be used safely by multiple producer domains, in parallel with the other operations.

Sourceval push_head : 'a t -> 'a -> unit

push_head t x inserts x at the head of the queue. This can only be used by the consumer (if run in parallel with pop, the item might be skipped).

  • raises Closed

    if t is closed and empty.

Sourceval pop : 'a t -> 'a option

pop t removes the head item from t and returns it. Returns None if t is currently empty.

  • raises Closed

    if t has been closed and is empty.

Sourceval is_empty : 'a t -> bool

is_empty t is true if calling pop would return None.

  • raises Closed

    if t has been closed and is empty.

Sourceval close : 'a t -> unit

close t marks t as closed, preventing any further items from being pushed.