Struct PrimOp 

pub struct PrimOp { /* private fields */ }

A Nix primitive operation (primop) wrapping a Rust closure.

After construction with PrimOp::new, the primop can be:

• Registered as a global builtin via PrimOp::register (must happen before creating any EvalState).
• Embedded in a value via PrimOp::into_value for use as a first-class function inside an EvalState.

Implementations

impl PrimOp

pub fn new<F>( context: &Arc<Context>, name: &str, arity: u32, doc: Option<&str>, f: F, ) -> Result<Self>

where F: Fn(&[PrimOpArg<'_>], &mut PrimOpRet<'_>) -> Result<()> + Send + Sync + 'static,

Create a new primop backed by the given Rust closure.

Arguments

• context: the Nix context.
• name: the name of the primop as it will appear in Nix.
• arity: number of arguments the primop accepts.
• doc: optional documentation string.
• f: the Rust closure to invoke.

Errors

Returns an error if the name or doc string contains an interior NUL byte, or if the underlying allocation fails.

pub fn register(self, context: &Context) -> Result<()>

Register this primop as a global Nix builtin.

After this call the primop will appear in builtins.* for all EvalState instances created after this call.

This consumes self; the underlying pointer is transferred to the global registry and is no longer accessible.

Errors

Returns an error if the registration fails.

pub fn into_value(self, state: &EvalState) -> Result<Value<'_>>

Embed this primop in a Nix value, returning a callable Value.

This consumes self. The returned value holds a GC reference to the primop, keeping it alive for the lifetime of the value.

Errors

Returns an error if the value allocation or initialisation fails.

Trait Implementations

impl Drop for PrimOp

fn drop(&mut self)

Executes the destructor for this type.

impl Send for PrimOp