Module Picos_thread.TLSSource

Thread-local storage.

Note that here "thread" refers to system level threads rather than fibers or domains. In case a system level thread implementation, i.e. the threads.posix library, is not available, this will use Picos_domain.DLS.

Sourcetype 'a t

Represents a key for associating values with threads.

Sourceval create : unit -> 'a t

create () allocates a new key for associating values with threads.

⚠️ Keys should not be created dynamically as each key will potentially increase the space taken by every thread.

Sourceexception Not_set

Exception raised by get_exn when no value is associated with the specified key for the current thread.

Sourceval get_exn : 'a t -> 'a

get_exn key returns the value associated with the specified key for the current thread or raises Not_set in case no value has been set for the key.

⚠️ The Not_set exception is raised with no backtrace. Always catch the exception unless it is known that a value has been set.

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

set key value associates the value with the specified key for the current thread.