Janet 1.15.0-2795e8a Documentation
(Other Versions: 1.13.1 1.12.2 1.11.1 1.10.1 1.9.1 1.8.1 1.7.0 1.6.0 1.5.1 1.5.0 1.4.0 1.3.1 )

Fiber Module


fiber/can-resume? fiber/current fiber/getenv fiber/last-value fiber/maxstack fiber/new fiber/root fiber/setenv fiber/setmaxstack fiber/status

fiber/can-resume? cfunction
(fiber/can-resume? fiber)

Check if a fiber is finished and cannot be resumed.
Community Examples

fiber/current cfunction

Returns the currently running fiber.
Community Examples

fiber/getenv cfunction
(fiber/getenv fiber)

Gets the environment for a fiber. Returns nil if no such table is set yet.
Community Examples

fiber/last-value cfunction

Get the last value returned or signaled from the fiber.
Community Examples

fiber/maxstack cfunction
(fiber/maxstack fib)

Gets the maximum stack size in janet values allowed for a fiber. While memory for the fiber's stack is not allocated up front, the fiber will not allocated more than this amount and will throw a stack-overflow error if more memory is needed. 
Community Examples

fiber/new cfunction
(fiber/new func &opt sigmask)

Create a new fiber with function body func. Can optionally take a set of signals to block from the current parent fiber when called. The mask is specified as a keyword where each character is used to indicate a signal to block. If the ev module is enabled, and this fiber is used as an argument to `ev/go`, these "blocked" signals will result in messages being sent to the supervisor channel. The default sigmask is :y. For example,

 (fiber/new myfun :e123)

blocks error signals and user signals 1, 2 and 3. The signals are as follows:

* :a - block all signals
* :d - block debug signals
* :e - block error signals
* :t - block termination signals: error + user[0-4]
* :u - block user signals
* :y - block yield signals
* :0-9 - block a specific user signal

The sigmask argument also can take environment flags. If any mutually exclusive flags are present, the last flag takes precedence.

* :i - inherit the environment from the current fiber
* :p - the environment table's prototype is the current environment table
Community Examples

fiber/root cfunction

Returns the current root fiber. The root fiber is the oldest ancestor that does not have a parent.
Community Examples

fiber/setenv cfunction
(fiber/setenv fiber table)

Sets the environment table for a fiber. Set to nil to remove the current environment.
Community Examples

fiber/setmaxstack cfunction
(fiber/setmaxstack fib maxstack)

Sets the maximum stack size in janet values for a fiber. By default, the maximum stack size is usually 8192.
Community Examples

fiber/status cfunction
(fiber/status fib)

Get the status of a fiber. The status will be one of:

* :dead - the fiber has finished
* :error - the fiber has errored out
* :debug - the fiber is suspended in debug mode
* :pending - the fiber has been yielded
* :user(0-9) - the fiber is suspended by a user signal
* :alive - the fiber is currently running and cannot be resumed
* :new - the fiber has just been created and not yet run
Community Examples