Struct FunctionObject 

pub struct FunctionObject {
    pub id: FunctionId,
    pub symbol: Symbol,
    pub cases: Vec<FunctionCase>,
}

A callable function object: a named set of shape-typed overload cases with selection driven by case priority and argument match score.

Fields

id: FunctionId

Stable function identifier.

symbol: Symbol

Symbol naming the function.

cases: Vec<FunctionCase>

Overload cases in registration order.

Implementations

impl FunctionObject

pub fn new( id: FunctionId, symbol: Symbol, cases: Vec<FunctionCase>, ) -> FunctionObject

Build a function object from an id, symbol, and its overload cases.

pub fn select_case<'a>( &'a self, cx: &mut Cx, prepared: &PreparedArgs, ) -> Result<SelectedCase<'a>, Error>

Pick the overload case that best matches the prepared arguments.

Cases whose argument shape accepts the arguments are ordered by priority first, then by proven argument-shape specificity (the subshape lattice), and only then by additive match score: a case whose argument shape is a proven subshape of another’s is strictly more specific and wins even at an equal or lower score. Returns Error::NoMatchingOverload when nothing matches and Error::AmbiguousOverload when two top cases remain unordered (equal priority, neither shape subsumes the other, and equal score).

pub fn combined_args_shape(&self) -> Option<Arc<dyn Shape>>

Shape accepting any case’s arguments: the lone case’s shape, or a one-of over every case. None when the function has no cases.

pub fn combined_result_shape(&self) -> Option<Arc<dyn Shape>>

Shape covering every case’s result, or None if any case omits a result shape. A single result is returned directly; many become a one-of.

pub fn declared_demand(&self, index: usize) -> Option<Demand>

Evaluation demand declared for argument index across all cases.

Returns the shared demand when every case agrees, Demand::Value when they disagree, and None when no case declares that position.

pub fn declared_demands(&self) -> Vec<Demand>

Per-position demands for the call, sized to the widest case and defaulting unspecified positions to Demand::Value.

Trait Implementations

impl Callable for FunctionObject

fn call(&self, cx: &mut Cx, args: Args) -> Result<Value, Error>

Invoke the callable with already-evaluated, checked Args.

fn browse_args_shape(&self, _cx: &mut Cx) -> Result<Option<Value>, Error>

Optional shape describing the accepted argument list, for browsing.

fn browse_result_shape(&self, _cx: &mut Cx) -> Result<Option<Value>, Error>

Optional shape describing the call result, for browsing.

fn call_exprs(&self, cx: &mut Cx, args: RawArgs) -> Result<Value, Error>

Invoke the callable on raw, unevaluated argument expressions.

impl Clone for FunctionObject

fn clone(&self) -> FunctionObject

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Object for FunctionObject

fn display(&self, _cx: &mut Cx) -> Result<String, Error>

Render the object as a human-readable display string.

fn as_any(&self) -> &(dyn Any + 'static)

Expose the object for Rust downcasting.

fn header(&self) -> &ObjectHeader

Identity and trust header for the object; defaults to the shared anonymous header.

fn op(&self, _key: &OpKey) -> Option<&dyn Op>

Resolve the operation registered under key, if any.

fn claims( &self, _cx: &mut Cx, _pattern: &ClaimPattern, _sink: &mut dyn ClaimSink, ) -> Result<(), Error>

Emit the object’s claims matching pattern into sink.

fn snapshot(&self, _cx: &mut Cx) -> Result<Option<Datum>, Error>

Optional content-addressable snapshot of the object’s state.

impl ObjectCompat for FunctionObject

fn class(&self, cx: &mut Cx) -> Result<Value, Error>

Class object this value belongs to; defaults to nil.

fn as_table(&self, cx: &mut Cx) -> Result<Value, Error>

Project the object into a table value; the default exposes its display.

fn as_callable(&self) -> Option<&dyn Callable>

Callable view, if the object can be invoked.

fn as_read_constructor(&self) -> Option<&dyn ReadConstructor>

Read-constructor view, if the object decodes data forms.

fn as_class(&self) -> Option<&dyn Class>

Class view, if the object is a class.

fn as_shape(&self) -> Option<&dyn Shape>

Shape view, if the object is a shape.

fn as_object_encoder(&self) -> Option<&dyn ObjectEncode>

Object-encoder view, if the object encodes other objects.

fn as_number_domain(&self) -> Option<&(dyn NumberDomain + 'static)>

Number-domain view, if the object is a number domain.

fn as_number_value(&self) -> Option<&dyn NumberValue>

Number-value view, if the object is a domain number.

fn as_eval_fabric(&self) -> Option<&dyn EvalFabric>

Eval-fabric view, if the object is a distributed eval surface.

fn as_stream(&self) -> Option<&dyn Stream>

Stream view, if the object is a stream.

fn as_sequence(&self) -> Option<&dyn Sequence>

Sequence view, if the object is a sequence.

fn as_thunk(&self) -> Option<&dyn Thunk>

Thunk view, if the object is a deferred computation.

fn as_list(&self) -> Option<&(dyn ListValue + 'static)>

List view, if the object is a list value.

fn as_table_impl(&self) -> Option<&(dyn Table + 'static)>

Table-implementation view, if the object is a table.

fn as_dir(&self) -> Option<&(dyn Dir + 'static)>

Directory view, if the object is a directory.

fn as_expr(&self, cx: &mut Cx) -> Result<Expr, Error>

Expression form of the object; defaults to an opaque extension node.

fn truth(&self, _cx: &mut Cx) -> Result<bool, Error>

Truthiness of the object; defaults to true.

fn publish_shape_satisfaction_claims( &self, _cx: &mut Cx, _shape: &Ref, ) -> Result<bool, Error>

Publish claims asserting that the object satisfies shape; returns whether any were published.

impl ReadConstructor for FunctionObject

fn symbol(&self) -> Symbol

The symbol naming this constructor.

fn args_shape(&self, cx: &mut Cx) -> Result<Value, Error>

The shape the constructor’s arguments must match.

fn construct_read(&self, cx: &mut Cx, args: Vec<Value>) -> Result<Value, Error>

Constructs the value from matched arguments at read time.