Struct CallBuilder

pub struct CallBuilder { /* private fields */ }

Utility struct for building a Call with arguments on the Stack.

Implementations

impl CallBuilder

pub fn add_argument( &mut self, stack: &mut Stack, argument: Argument, ) -> &mut Self

Add an argument to the Stack and reference it from the Call.

pub fn add_positional( &mut self, stack: &mut Stack, span: Span, val: Value, ) -> &mut Self

Add a positional argument to the Stack and reference it from the Call.

pub fn add_spread( &mut self, stack: &mut Stack, span: Span, vals: Value, ) -> &mut Self

Add a spread argument to the Stack and reference it from the Call.

pub fn add_flag( &mut self, stack: &mut Stack, name: impl AsRef<str>, short: impl AsRef<str>, span: Span, ) -> &mut Self

Add a flag (no-value named) argument to the Stack and reference it from the Call.

pub fn add_named( &mut self, stack: &mut Stack, name: impl AsRef<str>, short: impl AsRef<str>, span: Span, val: Value, ) -> &mut Self

Add a named argument to the Stack and reference it from the Call.

pub fn finish(&self) -> Call

Produce the finished Call from the builder.

The call should be entered / run before any other calls are constructed, because the argument stack will be reset when they exit.

pub fn with<T>( self, stack: &mut Stack, f: impl FnOnce(&mut Stack, &Call<'_>) -> T, ) -> T

Run a closure with the Call as an engine::Call reference, and then clean up the arguments that were added to the Stack after.

For convenience. Calls Call::leave after the closure ends.