Struct ExternalLibrary 

pub struct ExternalLibrary { /* private fields */ }

A loaded external-function library plus its registered functions.

Implementations

impl ExternalLibrary

pub fn load(path: &Path) -> Result<Self, String>

Open a shared library at path and invoke its funcadd_ASL entry point, collecting all functions it registers.

pub fn function_names(&self) -> impl Iterator<Item = &str>

Names of all functions registered by this library.

pub fn get(&self, name: &str) -> Option<&RegisteredFunc>

Look up a registered function by name.

pub fn eval( &self, name: &str, args: &[ExternalArg<'_>], want_derivs: bool, want_hes: bool, ) -> Result<EvalResult, String>

Evaluate a registered function with the given positional arguments.

Arguments are encoded per the AMPL arglist ABI: real args are stored in ra[], string args in sa[], and at[i] maps argument position i to either a real-slot index (at[i] >= 0) or a string-slot index (at[i] < 0, decoded as -(at[i]+1)).

If want_derivs is set, a length-nr derivative buffer is allocated and returned on success. If want_hes is set, a length-nr*(nr+1)/2 Hessian buffer is also allocated and returned. The library is told to fill both by the non-null arglist.derivs / arglist.hes pointers.

Trait Implementations

impl Debug for ExternalLibrary

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.