Struct HostCall 

pub struct HostCall<'call, Profile, Provider, Return>
where
    Profile: HostProfile,
    Provider: HostProvider<Profile>,
    Return: HostType,
{ /* private fields */ }

Implementations

impl<'call, Profile, Provider, Return> HostCall<'call, Profile, Provider, Return>

where Profile: HostProfile, Provider: HostProvider<Profile>, Return: HostType,

pub fn state(&mut self) -> &mut Provider::State

pub fn return_value( self, value: Return::Value<'call>, ) -> HostCallCompletion<'call, Return>

pub fn equal<Type: HostType>( &self, left: Type::Value<'call>, right: Type::Value<'call>, ) -> bool

pub fn source_hash<Type: HostType>(&self, value: Type::Value<'call>) -> u64

Hashes a call-scoped value consistently with Gleam source equality.

The result is intended for runtime lookup within this execution. It is not a stable serialization or a process-independent value.

pub fn inspect<Type: HostType>(&self, value: Type::Value<'call>) -> EcoString

Returns the canonical Gleam-facing inspection of a call-scoped value.

pub fn list_len<Item>(&self, value: HostList<'call, Item>) -> usize

pub fn list_item<Item: HostType>( &mut self, value: HostList<'call, Item>, index: usize, ) -> Option<Item::Value<'call>>

pub fn construct_list<Item: HostType>( &mut self, _construction: HostConstruction<'call, HostListType<Item>>, values: impl IntoIterator<Item = Item::Value<'call>>, ) -> HostList<'call, Item>

Constructs a list authorized by one registered construction token.

pub fn tuple_len<Elements>(&self, value: HostTuple<'call, Elements>) -> usize

pub fn tuple_values<Elements: HostTypeSequence>( &mut self, value: HostTuple<'call, Elements>, ) -> Elements::Values<'call>

pub fn construct_tuple<Elements: HostTypeSequence>( &mut self, _construction: HostConstruction<'call, HostTupleType<Elements>>, values: Elements::Values<'call>, ) -> HostTuple<'call, Elements>

Constructs a tuple authorized by one registered construction token.

pub fn custom_constructor<Custom>( &self, value: HostCustom<'call, Custom>, ) -> usize

pub fn custom_fields<Constructor>( &mut self, value: HostCustom<'call, Constructor::Custom>, ) -> Option<<Constructor::Fields as HostTypeSequence>::Values<'call>>

where Constructor: HostCustomConstructor,

pub fn construct_custom<Constructor>( &mut self, _construction: HostConstruction<'call, Constructor::Custom>, fields: <Constructor::Fields as HostTypeSequence>::Values<'call>, ) -> HostCustom<'call, Constructor::Custom>

where Constructor: HostCustomConstructor, Constructor::Fields: HostTypeSequence,

Constructs an ordinary custom value authorized by one registered type token.

pub fn external_payload<Schema, Arguments>( &self, value: HostExternal<'call, HostExternalType<Schema, Arguments>>, ) -> HostExternalPayloadView<'call, <<Provider as HostExternalBinding<Profile, Schema>>::Storage as HostExternalStorage<Profile, Schema>>::Payload, Arguments>

where Schema: HostExternalSchema, Provider: HostExternalBinding<Profile, Schema>, Arguments: HostTypeSequence,

Borrows the Rust payload behind one typed external value.

pub fn invoke<Arguments, FunctionReturn>( &mut self, function: HostCallable<'call, Arguments, FunctionReturn>, arguments: Arguments::Values<'call>, ) -> Result<FunctionReturn::Value<'call>, HostCallError>

where Arguments: HostTypeSequence, FunctionReturn: HostType,

Invokes a Gleam callable while this host call owns the active runtime.

A provider-state borrow must end before re-entry.

use geam_core::{
    HostCall, HostCallCompletion, HostCallError, HostCallable, HostProfile, HostProvider,
    HostTypeList, HostTypeListEnd,
};
use num_bigint::BigInt;

struct Profile;
struct Provider;

impl HostProfile for Profile {
    type RunState = usize;
    type ExternalStores = ();
}

impl HostProvider<Profile> for Provider {
    type State = usize;

    fn project(state: &mut usize) -> &mut Self::State {
        state
    }
}

type Arguments = HostTypeList<BigInt, HostTypeListEnd>;

fn reenter_with_live_state<'call>(
    mut call: HostCall<'call, Profile, Provider, BigInt>,
    callable: HostCallable<'call, Arguments, BigInt>,
) -> Result<HostCallCompletion<'call, BigInt>, HostCallError> {
    let state = call.state();
    let returned = call.invoke(callable, (BigInt::from(1), ()))?;
    *state += 1;
    Ok(call.return_value(returned))
}

pub fn construct_external_with<Schema, Arguments>( &mut self, _construction: HostConstruction<'call, HostExternalType<Schema, Arguments>>, build: impl FnOnce(&mut HostExternalPayloadBuilder<'_, Profile, Arguments>) -> <<Provider as HostExternalBinding<Profile, Schema>>::Storage as HostExternalStorage<Profile, Schema>>::Payload, ) -> HostExternal<'call, HostExternalType<Schema, Arguments>>

where Schema: HostExternalSchema, Provider: HostExternalBinding<Profile, Schema>, Arguments: HostTypeSequence, HostExternalType<Schema, Arguments>: HostType,

Constructs an intermediate external payload that retains typed Gleam values.

impl<'call, Profile, Provider, Schema, Arguments> HostCall<'call, Profile, Provider, HostExternalType<Schema, Arguments>>

where Profile: HostProfile, Provider: HostProvider<Profile>, Schema: HostExternalSchema, Arguments: HostTypeSequence, HostExternalType<Schema, Arguments>: HostType,

pub fn create_external( &mut self, value: <<Provider as HostExternalBinding<Profile, Schema>>::Storage as HostExternalStorage<Profile, Schema>>::Payload, ) -> HostExternal<'call, HostExternalType<Schema, Arguments>>

where Provider: HostExternalBinding<Profile, Schema>,

pub fn create_external_with( &mut self, build: impl FnOnce(&mut HostExternalPayloadBuilder<'_, Profile, Arguments>) -> <<Provider as HostExternalBinding<Profile, Schema>>::Storage as HostExternalStorage<Profile, Schema>>::Payload, ) -> HostExternal<'call, HostExternalType<Schema, Arguments>>

where Provider: HostExternalBinding<Profile, Schema>,

Creates an external payload that may retain typed Gleam values.

impl<'call, Profile, Provider, Return> HostCall<'call, Profile, Provider, Return>

where Profile: HostProfile, Provider: HostProvider<Profile>, Return: HostType,

pub fn construct_external<Schema, Arguments>( &mut self, _construction: HostConstruction<'call, HostExternalType<Schema, Arguments>>, value: <<Provider as HostExternalBinding<Profile, Schema>>::Storage as HostExternalStorage<Profile, Schema>>::Payload, ) -> HostExternal<'call, HostExternalType<Schema, Arguments>>

where Schema: HostExternalSchema, Provider: HostExternalBinding<Profile, Schema>, Arguments: HostTypeSequence, HostExternalType<Schema, Arguments>: HostType,

Constructs an intermediate external payload authorized by one registered type token.

impl<'call, Profile, Provider, Item> HostCall<'call, Profile, Provider, HostListType<Item>>

where Profile: HostProfile, Provider: HostProvider<Profile>, Item: HostType,

pub fn return_list( self, values: impl IntoIterator<Item = Item::Value<'call>>, ) -> HostCallCompletion<'call, HostListType<Item>>

impl<'call, Profile, Provider, Elements> HostCall<'call, Profile, Provider, HostTupleType<Elements>>

where Profile: HostProfile, Provider: HostProvider<Profile>, Elements: HostTypeSequence,

pub fn return_tuple( self, values: <Elements as HostTypeSequence>::Values<'call>, ) -> HostCallCompletion<'call, HostTupleType<Elements>>

impl<'call, Profile, Provider, Schema, Arguments> HostCall<'call, Profile, Provider, HostCustomType<Schema, Arguments>>

where Profile: HostProfile, Provider: HostProvider<Profile>, Schema: HostCustomSchema, Arguments: HostTypeSequence,

pub fn return_custom<Constructor>( self, fields: <Constructor::Fields as HostTypeSequence>::Values<'call>, ) -> HostCallCompletion<'call, HostCustomType<Schema, Arguments>>

where Constructor: HostCustomConstructor<Custom = HostCustomType<Schema, Arguments>>, Constructor::Fields: HostTypeSequence,