SkipUntil modifies the source sequence so that all elements are ignored until the second sequence produces a notification. At that time, SkipUntil will start emitting all remaining elements from the source sequence. SkipUntil is often used to create a dynamic start condition for an infinite sequence.

If the source sequence terminates before the second sequence produces a value, SkipUntil will terminate without emitting any elements.

Examples

Use SkipUntil to skip elements from an active sequence.

Start Video Recording

Use SkipUntil to start video recording when a trigger is sent (e.g. key press).

Note

This example requires the Bonsai.Vision, Bonsai.Vision.Design, and Bonsai.Windows.Input packages to be installed.

Note

Use TakeUntil to control the termination of video recording.

Related Operators

Use SubscribeWhen to control the start of subscription.

Warning

Although SubscribeWhen and SkipUntil often produce a similar sequence, SkipUntil always subscribes to the source sequence immediately. This means that any initialization side-effects will be evaluated immediately. For hot sequences (e.g. camera) this might be advantageous, since any initialization costs are paid upfront, and new values are immediately ready to be consumed after the trigger. However, for cold sequences (e.g. video or a timer) this might lead to loss of data from the start of the sequence. For more about the difference between hot and cold sequences, see the section on temperature.