Struct artichoke::Artichoke

pub struct Artichoke {
    pub mrb: NonNull<mrb_state>,
    pub state: Option<Box<State>>,
}

Interpreter instance.

Functionality is added to the interpreter via traits, for example, garbage collection or eval.

Fields

mrb: NonNull<mrb_state>

Underlying mruby interpreter.

This is an owned reference to the interpreter via a mutable pointer.

state: Option<Box<State>>

Interpreter state.

This field is an Option because the State is moved in and out of the Artichoke struct as the call graph crosses between Rust and C and C to Rust.

Implementations

impl Artichoke

#[must_use]pub fn new(mrb: NonNull<mrb_state>, state: Box<State>) -> Artichoke

Create a new interpreter from an underlying mrb and a State.

pub unsafe fn with_ffi_boundary<F, T>(
    &mut self,
    func: F
) -> Result<T, InterpreterExtractError> where
    F: FnOnce(*mut mrb_state) -> T, 

Execute a a closure by moving the [State] into the mrb instance.

This method prepares this interpreter to cross an FFI boundary. When the Artichoke implementation calls mruby FFI functions, the State must be moved into the [sys::mrb_state] userdata pointer.

Safety

This method moves the State out of this instance into the mrb instance. During this function's execution, this instance may be partially initialized.

This function is only safe to call if the closure only calls FFI functions that use a raw *mut sys::mrb_state.

#[must_use]pub unsafe fn into_raw(interp: Artichoke) -> *mut mrb_state

Consume an interpreter and return the pointer to the underlying [sys::mrb_state].

This function does not free any interpreter resources. Its intended use is to prepare the interpreter to cross over an FFI boundary.

This is an associated function and must be called as Artichoke::into_raw(interp).

Safety

After calling this function, the caller is responsible for properly freeing the memory occupied by the interpreter heap. The easiest way to do this is to call [ffi::from_user_data] with the returned pointer and then call Artichoke::close.

pub fn close(self)

Consume an interpreter and free all live objects.

impl Artichoke

pub fn all_symbols(&self) -> Result<AllSymbols, InterpreterExtractError>

Return a type that yields all Symbols in the interpreter.

pub fn lookup_symbol_with_trailing_nul(
    &self,
    symbol: Symbol
) -> Result<Option<&[u8]>, Exception>

Trait Implementations

impl<'a> AsMut<Artichoke> for Guard<'a>

fn as_mut(&mut self) -> &mut Artichoke

Performs the conversion.

impl<'a> AsRef<Artichoke> for Guard<'a>

fn as_ref(&self) -> &Artichoke

Performs the conversion.

impl ClassRegistry for Artichoke

fn def_class<T>(&mut self, spec: Spec) -> Result<(), Exception> where
    T: Any, 

Create a class definition bound to a Rust type T.

Class definitions have the same lifetime as the State because the class def owns the mrb_data_type for the type, which must be long-lived.

fn class_spec<T>(&self) -> Result<Option<&Spec>, Exception> where
    T: Any, 

Retrieve a class definition from the state bound to Rust type T.

This function returns None if type T has not had a class spec registered for it using [ClassRegistry::def_class].

fn class_of<T>(&mut self) -> Result<Option<Value>, Exception> where
    T: Any, 

fn new_instance<T>(
    &mut self,
    args: &[Value]
) -> Result<Option<Value>, Exception> where
    T: Any, 

fn is_class_defined<T>(&self) -> bool where
    T: Any, 

impl Convert<Integer, Value> for Artichoke

fn convert(&self, from: Integer) -> Value

Performs the infallible conversion.

impl Convert<Option<Value>, Value> for Artichoke

fn convert(&self, value: Option<Value>) -> Value

Performs the infallible conversion.

impl Convert<Option<i64>, Value> for Artichoke

fn convert(&self, value: Option<i64>) -> Value

Performs the infallible conversion.

impl Convert<Value, Option<Value>> for Artichoke

fn convert(&self, value: Value) -> Option<Value>

Performs the infallible conversion.

impl Convert<Value, Value> for Artichoke

fn convert(&self, value: Value) -> Value

Performs the infallible conversion.

impl Convert<bool, Value> for Artichoke

fn convert(&self, value: bool) -> Value

Performs the infallible conversion.

impl Convert<i16, Value> for Artichoke

fn convert(&self, value: i16) -> Value

Performs the infallible conversion.

impl Convert<i32, Value> for Artichoke

fn convert(&self, value: i32) -> Value

Performs the infallible conversion.

impl Convert<i64, Value> for Artichoke

Converter for Artichoke native integer type.

The Int type alias must be i64.

assert_eq!(mem::size_of::<i64>(), mem::size_of::<Int>());
assert_eq!(i64::min_value(), Int::min_value());
assert_eq!(i64::max_value(), Int::max_value());
assert_eq!(TypeId::of::<i64>(), TypeId::of::<Int>());

fn convert(&self, value: i64) -> Value

Performs the infallible conversion.

impl Convert<i8, Value> for Artichoke

fn convert(&self, value: i8) -> Value

Performs the infallible conversion.

impl Convert<u16, Value> for Artichoke

fn convert(&self, value: u16) -> Value

Performs the infallible conversion.

impl Convert<u32, Value> for Artichoke

fn convert(&self, value: u32) -> Value

Performs the infallible conversion.

impl Convert<u8, Value> for Artichoke

fn convert(&self, value: u8) -> Value

Performs the infallible conversion.

impl<'_> ConvertMut<&'_ [u8], Value> for Artichoke

fn convert_mut(&mut self, value: &[u8]) -> Value

Performs the infallible conversion.

impl<'_> ConvertMut<&'_ str, Value> for Artichoke

fn convert_mut(&mut self, value: &str) -> Value

Performs the infallible conversion.

impl<'a> ConvertMut<Cow<'a, [u8]>, Value> for Artichoke

fn convert_mut(&mut self, value: Cow<'a, [u8]>) -> Value

Performs the infallible conversion.

impl<'a> ConvertMut<Cow<'a, str>, Value> for Artichoke

fn convert_mut(&mut self, value: Cow<'a, str>) -> Value

Performs the infallible conversion.

impl ConvertMut<Float, Value> for Artichoke

fn convert_mut(&mut self, from: Float) -> Value

Performs the infallible conversion.

impl ConvertMut<HashMap<Vec<u8>, Vec<u8>, RandomState>, Value> for Artichoke

fn convert_mut(
    &mut self,
    value: HashMap<Vec<u8>, Vec<u8>, RandomState>
) -> Value

Performs the infallible conversion.

impl<'_> ConvertMut<Option<&'_ [u8]>, Value> for Artichoke

fn convert_mut(&mut self, value: Option<&[u8]>) -> Value

Performs the infallible conversion.

impl<'_> ConvertMut<Option<&'_ str>, Value> for Artichoke

fn convert_mut(&mut self, value: Option<&str>) -> Value

Performs the infallible conversion.

impl ConvertMut<Option<HashMap<Vec<u8>, Option<Vec<u8>>, RandomState>>, Value> for Artichoke

fn convert_mut(
    &mut self,
    value: Option<HashMap<Vec<u8>, Option<Vec<u8>>, RandomState>>
) -> Value

Performs the infallible conversion.

impl ConvertMut<Option<String>, Value> for Artichoke

fn convert_mut(&mut self, value: Option<String>) -> Value

Performs the infallible conversion.

impl ConvertMut<Option<Vec<u8>>, Value> for Artichoke

fn convert_mut(&mut self, value: Option<Vec<u8>>) -> Value

Performs the infallible conversion.

impl ConvertMut<Outcome, Value> for Artichoke

fn convert_mut(&mut self, from: Outcome) -> Value

Performs the infallible conversion.

impl ConvertMut<RandomNumber, Value> for Artichoke

fn convert_mut(&mut self, from: RandomNumber) -> Value

Performs the infallible conversion.

impl ConvertMut<RandomNumber, Value> for Artichoke

fn convert_mut(&mut self, from: RandomNumber) -> Value

Performs the infallible conversion.

impl ConvertMut<String, Value> for Artichoke

fn convert_mut(&mut self, value: String) -> Value

Performs the infallible conversion.

impl ConvertMut<Value, Options> for Artichoke

fn convert_mut(&mut self, value: Value) -> Options

Performs the infallible conversion.

impl ConvertMut<Value, Value> for Artichoke

fn convert_mut(&mut self, value: Value) -> Value

Performs the infallible conversion.

impl ConvertMut<Vec<(Value, Value)>, Value> for Artichoke

fn convert_mut(&mut self, value: Vec<(Value, Value)>) -> Value

Performs the infallible conversion.

impl ConvertMut<Vec<u8>, Value> for Artichoke

fn convert_mut(&mut self, value: Vec<u8>) -> Value

Performs the infallible conversion.

impl ConvertMut<f64, Value> for Artichoke

fn convert_mut(&mut self, value: f64) -> Value

Performs the infallible conversion.

impl Debug for Artichoke

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

Formats the value using the given formatter.

impl DefineConstant for Artichoke

type Value = Value

Concrete type for Ruby values.

type Error = Exception

Concrete error type for fallible operations.

fn define_global_constant(
    &mut self,
    constant: &str,
    value: <Artichoke as DefineConstant>::Value
) -> Result<(), <Artichoke as DefineConstant>::Error>

Define a global constant.

fn define_class_constant<T>(
    &mut self,
    constant: &str,
    value: <Artichoke as DefineConstant>::Value
) -> Result<(), <Artichoke as DefineConstant>::Error> where
    T: 'static, 

Define a class constant.

fn define_module_constant<T>(
    &mut self,
    constant: &str,
    value: <Artichoke as DefineConstant>::Value
) -> Result<(), <Artichoke as DefineConstant>::Error> where
    T: 'static, 

Define a module constant.

impl Eval for Artichoke

type Value = Value

Concrete type for return values from eval.

type Error = Exception

Concrete error type for eval functions.

fn eval(
    &mut self,
    code: &[u8]
) -> Result<<Artichoke as Eval>::Value, <Artichoke as Eval>::Error>

Eval code on the Artichoke interpreter using the current Context.

fn eval_os_str(
    &mut self,
    code: &OsStr
) -> Result<<Artichoke as Eval>::Value, <Artichoke as Eval>::Error>

Eval code on the Artichoke interpreter using the current Context when given code as an [OsStr].

fn eval_file(
    &mut self,
    file: &Path
) -> Result<<Artichoke as Eval>::Value, <Artichoke as Eval>::Error>

Eval code on the Artichoke interpreter using a new file Context given a file path.

impl Globals for Artichoke

type Value = Value

Concrete value type for global variables.

type Error = Exception

Concrete error type for failures manipulating global variables.

fn set_global_variable<T>(
    &mut self,
    name: T,
    value: &<Artichoke as Globals>::Value
) -> Result<(), <Artichoke as Globals>::Error> where
    T: Into<Cow<'static, [u8]>>, 

Set global variable pointed to by name to the given Ruby value.

fn unset_global_variable<T>(
    &mut self,
    name: T
) -> Result<(), <Artichoke as Globals>::Error> where
    T: Into<Cow<'static, [u8]>>, 

Unset global variable pointed to by name.

Unsetting a global variable removes the name from the global storage table. Unset globals resolve to nil in the Ruby VM.

Unsetting a global that is currently unset is a no-op.

Errors

If the name is not a valid global name, an error is returned.

fn get_global_variable<T>(
    &mut self,
    name: T
) -> Result<Option<<Artichoke as Globals>::Value>, <Artichoke as Globals>::Error> where
    T: Into<Cow<'static, [u8]>>, 

Get the Ruby value stored in the global variable pointed to by name.

impl Intern for Artichoke

type Symbol = Symbol

Concrete type for symbol identifiers.

type Error = Exception

Concrete type for errors returned while interning symbols.

fn intern_bytes<T>(
    &mut self,
    bytes: T
) -> Result<<Artichoke as Intern>::Symbol, <Artichoke as Intern>::Error> where
    T: Into<Cow<'static, [u8]>>, 

Store an immutable bytestring for the life of the interpreter.

fn check_interned_bytes(
    &self,
    bytes: &[u8]
) -> Result<Option<<Artichoke as Intern>::Symbol>, <Artichoke as Intern>::Error>

Check if a bytestring is already interned and return its symbol identifier. Return None if the string has not been interned before.

fn lookup_symbol(
    &self,
    symbol: <Artichoke as Intern>::Symbol
) -> Result<Option<&[u8]>, <Artichoke as Intern>::Error>

Retrieve the original byte content of an interned bytestring.

fn intern_string<T>(&mut self, symbol: T) -> Result<Self::Symbol, Self::Error> where
    T: Into<Cow<'static, str>>, 

Store an immutable string for the life of the interpreter.

fn check_interned_string(
    &self,
    symbol: &str
) -> Result<Option<Self::Symbol>, Self::Error>

Check if a string is already interned and return its symbol identifier. Return None if the string has not been interned before.

impl Io for Artichoke

type Error = Exception

Concrete error type for errors encountered when reading and writing.

fn print<T>(&mut self, message: T) -> Result<(), <Artichoke as Io>::Error> where
    T: AsRef<[u8]>, 

Writes the given bytes to the interpreter stdout stream.

This implementation delegates to the underlying output strategy.

Errors

If the output stream encounters an error, an error is returned.

fn puts<T>(&mut self, message: T) -> Result<(), <Artichoke as Io>::Error> where
    T: AsRef<[u8]>, 

Writes the given bytes to the interpreter stdout stream followed by a newline.

This implementation delegates to the underlying output strategy.

Errors

If the output stream encounters an error, an error is returned.

impl LoadSources for Artichoke

type Artichoke = Artichoke

Concrete type for interpreter.

type Error = Exception

Concrete type for errors returned from filesystem IO.

type Exception = Exception

Concrete type for errors returned by File::require.

fn def_file_for_type<P, T>(
    &mut self,
    path: P
) -> Result<(), <Artichoke as LoadSources>::Error> where
    P: AsRef<Path>,
    T: File<Artichoke = <Artichoke as LoadSources>::Artichoke, Error = <Artichoke as LoadSources>::Exception>, 

Add a Rust extension hook to the virtual filesystem. A stub Ruby file is added to the filesystem and [File::require] will dynamically define Ruby items when invoked via Kernel#require.

fn def_rb_source_file<P, T>(
    &mut self,
    path: P,
    contents: T
) -> Result<(), <Artichoke as LoadSources>::Error> where
    P: AsRef<Path>,
    T: Into<Cow<'static, [u8]>>, 

Add a Ruby source to the virtual filesystem.

fn source_is_file<P>(
    &self,
    path: P
) -> Result<bool, <Artichoke as LoadSources>::Error> where
    P: AsRef<Path>, 

Test for a source file at a path.

fn load_source<P>(
    &mut self,
    path: P
) -> Result<bool, <Artichoke as LoadSources>::Error> where
    P: AsRef<Path>, 

Load source located at the given path.

fn require_source<P>(
    &mut self,
    path: P
) -> Result<bool, <Artichoke as LoadSources>::Error> where
    P: AsRef<Path>, 

Require source located at the given path.

fn read_source_file_contents<P>(
    &self,
    path: P
) -> Result<Cow<[u8]>, <Artichoke as LoadSources>::Error> where
    P: AsRef<Path>, 

Retrieve file contents for a source file.

impl ModuleRegistry for Artichoke

fn def_module<T>(&mut self, spec: Spec) -> Result<(), Exception> where
    T: Any, 

Create a module definition bound to a Rust type T.

Module definitions have the same lifetime as the interpreter because the module def owns the mrb_data_type for the type, which must be long-lived.

fn module_spec<T>(&self) -> Result<Option<&Spec>, Exception> where
    T: Any, 

Retrieve a module definition from the interpreter bound to Rust type T.

This function returns None if type T has not had a module spec registered for it using [ModuleRegistry::def_module].

fn module_of<T>(&mut self) -> Result<Option<Value>, Exception> where
    T: Any, 

fn is_module_defined<T>(&self) -> bool where
    T: Any, 

impl MrbGarbageCollection for Artichoke

fn create_arena_savepoint(&mut self) -> Result<ArenaIndex, IndexError>

Create a savepoint in the GC arena.

fn live_object_count(&mut self) -> i32

Retrieve the number of live objects on the interpreter heap.

fn mark_value(&mut self, value: &Value)

Mark a [Value] as reachable in the mruby garbage collector.

fn incremental_gc(&mut self)

Perform an incremental garbage collection.

fn full_gc(&mut self)

Perform a full garbage collection.

fn enable_gc(&mut self) -> State

Enable garbage collection.

fn disable_gc(&mut self) -> State

Disable garbage collection.

impl Parser for Artichoke

type Context = Context

Concrete type for parser context.

type Error = Exception

Error type for Parser APIs.

fn reset_parser(&mut self) -> Result<(), <Artichoke as Parser>::Error>

Reset parser state to initial values.

fn fetch_lineno(&self) -> Result<usize, <Artichoke as Parser>::Error>

Fetch the current line number from the parser state.

fn add_fetch_lineno(
    &mut self,
    val: usize
) -> Result<usize, <Artichoke as Parser>::Error>

Increment line number and return the new value.

fn push_context(
    &mut self,
    context: <Artichoke as Parser>::Context
) -> Result<(), <Artichoke as Parser>::Error>

Set the currently active context by modifying the parser stack.

fn pop_context(
    &mut self
) -> Result<Option<<Artichoke as Parser>::Context>, <Artichoke as Parser>::Error>

Remove the current active context and return it.

fn peek_context(
    &self
) -> Result<Option<&<Artichoke as Parser>::Context>, <Artichoke as Parser>::Error>

Return a reference to the currently active context.

impl Prng for Artichoke

type Error = Exception

Concrete type for PRNG errors.

type InternalState = InternalState

Cocnrete type representing the internal state of all PRNG backends.

type Int = i64

Conrete type for integer input and output.

type Float = f64

Concrete type for floating point input and output.

fn prng_fill_bytes(
    &mut self,
    buf: &mut [u8]
) -> Result<(), <Artichoke as Prng>::Error>

Completely fill a buffer with random bytes.

fn prng_seed(&self) -> Result<u64, <Artichoke as Prng>::Error>

Return the value this PRNG was seeded with.

fn prng_reseed(
    &mut self,
    seed: Option<u64>
) -> Result<(), <Artichoke as Prng>::Error>

Reseed the PRNG with a new seed.

fn prng_internal_state(
    &self
) -> Result<<Artichoke as Prng>::InternalState, <Artichoke as Prng>::Error>

Return true if this and other would return the same sequence of random data.

fn rand_int(
    &mut self,
    max: <Artichoke as Prng>::Int
) -> Result<<Artichoke as Prng>::Int, <Artichoke as Prng>::Error>

Return a random Integer between 0 and max -- [0, max).

fn rand_float(
    &mut self,
    max: Option<<Artichoke as Prng>::Float>
) -> Result<<Artichoke as Prng>::Float, <Artichoke as Prng>::Error>

Return a random Float between 0 and max -- [0, max).

impl Regexp for Artichoke

type Error = InterpreterExtractError

Concrete error type for errors encountered when manipulating Regexp state.

fn active_regexp_globals(&self) -> Result<usize, <Artichoke as Regexp>::Error>

Retrieve the current number of set Regexp global variables.

fn set_active_regexp_globals(
    &mut self,
    count: usize
) -> Result<(), <Artichoke as Regexp>::Error>

Set the current number of set Regexp global variables.

fn clear_regexp(&mut self) -> Result<(), <Artichoke as Regexp>::Error>

Clear all Regexp state.

impl TopSelf for Artichoke

type Value = Value

Concrete [Value] type.

fn top_self(&mut self) -> Value

Return a [Value]-wrapped reference to "top self".

impl<T, U> TryConvert<T, U> for Artichoke where
    Artichoke: Convert<T, U>, 

Provide a fallible converter for types that implement an infallible conversion.

type Error = Exception

Error type for failed conversions.

fn try_convert(
    &self,
    value: T
) -> Result<U, <Artichoke as TryConvert<T, U>>::Error>

Blanket implementation that always succeeds by delegating to [Convert::convert].

impl TryConvert<Value, Float> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert(
    &self,
    value: Value
) -> Result<Float, <Artichoke as TryConvert<Value, Float>>::Error>

Performs the fallible conversion.

impl TryConvert<Value, Integer> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert(
    &self,
    value: Value
) -> Result<Integer, <Artichoke as TryConvert<Value, Integer>>::Error>

Performs the fallible conversion.

impl TryConvert<Value, Option<bool>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert(
    &self,
    value: Value
) -> Result<Option<bool>, <Artichoke as TryConvert<Value, Option<bool>>>::Error>

Performs the fallible conversion.

impl TryConvert<Value, Option<i64>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert(
    &self,
    value: Value
) -> Result<Option<i64>, <Artichoke as TryConvert<Value, Option<i64>>>::Error>

Performs the fallible conversion.

impl TryConvert<Value, bool> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert(
    &self,
    value: Value
) -> Result<bool, <Artichoke as TryConvert<Value, bool>>::Error>

Performs the fallible conversion.

impl TryConvert<Value, f64> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert(
    &self,
    value: Value
) -> Result<f64, <Artichoke as TryConvert<Value, f64>>::Error>

Performs the fallible conversion.

impl TryConvert<Value, i64> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert(
    &self,
    value: Value
) -> Result<i64, <Artichoke as TryConvert<Value, i64>>::Error>

Performs the fallible conversion.

impl TryConvert<Value, u32> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert(
    &self,
    value: Value
) -> Result<u32, <Artichoke as TryConvert<Value, u32>>::Error>

Performs the fallible conversion.

impl TryConvert<Value, usize> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert(
    &self,
    value: Value
) -> Result<usize, <Artichoke as TryConvert<Value, usize>>::Error>

Performs the fallible conversion.

impl TryConvert<isize, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert(
    &self,
    value: isize
) -> Result<Value, <Artichoke as TryConvert<isize, Value>>::Error>

Performs the fallible conversion.

impl TryConvert<u64, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert(
    &self,
    value: u64
) -> Result<Value, <Artichoke as TryConvert<u64, Value>>::Error>

Performs the fallible conversion.

impl TryConvert<usize, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert(
    &self,
    value: usize
) -> Result<Value, <Artichoke as TryConvert<usize, Value>>::Error>

Performs the fallible conversion.

impl<'_, '_> TryConvertMut<&'_ [&'_ [u8]], Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: &[&[u8]]
) -> Result<Value, <Artichoke as TryConvertMut<&'_ [&'_ [u8]], Value>>::Error>

Performs the fallible conversion.

impl<'_, '_> TryConvertMut<&'_ [&'_ str], Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: &[&str]
) -> Result<Value, <Artichoke as TryConvertMut<&'_ [&'_ str], Value>>::Error>

Performs the fallible conversion.

impl<'_, '_> TryConvertMut<&'_ [Option<&'_ [u8]>], Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: &[Option<&[u8]>]
) -> Result<Value, <Artichoke as TryConvertMut<&'_ [Option<&'_ [u8]>], Value>>::Error>

Performs the fallible conversion.

impl<'_, '_> TryConvertMut<&'_ [Option<&'_ str>], Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: &[Option<&str>]
) -> Result<Value, <Artichoke as TryConvertMut<&'_ [Option<&'_ str>], Value>>::Error>

Performs the fallible conversion.

impl<'_> TryConvertMut<&'_ [Option<Value>], Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: &[Option<Value>]
) -> Result<Value, <Artichoke as TryConvertMut<&'_ [Option<Value>], Value>>::Error>

Performs the fallible conversion.

impl<'_> TryConvertMut<&'_ [Option<Vec<u8>>], Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: &[Option<Vec<u8>>]
) -> Result<Value, <Artichoke as TryConvertMut<&'_ [Option<Vec<u8>>], Value>>::Error>

Performs the fallible conversion.

impl<'_> TryConvertMut<&'_ [String], Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: &[String]
) -> Result<Value, <Artichoke as TryConvertMut<&'_ [String], Value>>::Error>

Performs the fallible conversion.

impl<'_> TryConvertMut<&'_ [Value], Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: &[Value]
) -> Result<Value, <Artichoke as TryConvertMut<&'_ [Value], Value>>::Error>

Performs the fallible conversion.

impl<'_> TryConvertMut<&'_ [Vec<u8>], Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: &[Vec<u8>]
) -> Result<Value, <Artichoke as TryConvertMut<&'_ [Vec<u8>], Value>>::Error>

Performs the fallible conversion.

impl<'_> TryConvertMut<&'_ [i64], Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: &[i64]
) -> Result<Value, <Artichoke as TryConvertMut<&'_ [i64], Value>>::Error>

Performs the fallible conversion.

impl<'_> TryConvertMut<&'_ OsStr, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: &OsStr
) -> Result<Value, <Artichoke as TryConvertMut<&'_ OsStr, Value>>::Error>

Performs the fallible conversion.

impl<'a> TryConvertMut<&'a mut Value, CaptureExtract<'a>> for Artichoke

type Error = TypeError

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: &'a mut Value
) -> Result<CaptureExtract<'a>, <Artichoke as TryConvertMut<&'a mut Value, CaptureExtract<'a>>>::Error>

Performs the fallible conversion.

impl<'a> TryConvertMut<&'a mut Value, IntegerString<'a>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: &'a mut Value
) -> Result<IntegerString<'a>, <Artichoke as TryConvertMut<&'a mut Value, IntegerString<'a>>>::Error>

Performs the fallible conversion.

impl TryConvertMut<(Option<Value>, Option<Value>), (Option<Options>, Option<Encoding>)> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: (Option<Value>, Option<Value>)
) -> Result<(Option<Options>, Option<Encoding>), <Artichoke as TryConvertMut<(Option<Value>, Option<Value>), (Option<Options>, Option<Encoding>)>>::Error>

Performs the fallible conversion.

impl TryConvertMut<CaptureMatch, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: CaptureMatch
) -> Result<Value, <Artichoke as TryConvertMut<CaptureMatch, Value>>::Error>

Performs the fallible conversion.

impl<'a> TryConvertMut<Cow<'a, OsStr>, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Cow<'a, OsStr>
) -> Result<Value, <Artichoke as TryConvertMut<Cow<'a, OsStr>, Value>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Option<Value>, Option<Radix>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Option<Value>
) -> Result<Option<Radix>, <Artichoke as TryConvertMut<Option<Value>, Option<Radix>>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Option<Value>, RandomNumberMax> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    max: Option<Value>
) -> Result<RandomNumberMax, <Artichoke as TryConvertMut<Option<Value>, RandomNumberMax>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Option<Value>, RandomNumberMax> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    max: Option<Value>
) -> Result<RandomNumberMax, <Artichoke as TryConvertMut<Option<Value>, RandomNumberMax>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Option<Value>, Seed> for Artichoke

type Error = TypeError

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Option<Value>
) -> Result<Seed, <Artichoke as TryConvertMut<Option<Value>, Seed>>::Error>

Performs the fallible conversion.

impl TryConvertMut<OsString, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: OsString
) -> Result<Value, <Artichoke as TryConvertMut<OsString, Value>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Scan, Option<Value>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    from: Scan
) -> Result<Option<Value>, <Artichoke as TryConvertMut<Scan, Option<Value>>>::Error>

Performs the fallible conversion.

impl<T, U> TryConvertMut<T, U> for Artichoke where
    Artichoke: ConvertMut<T, U>, 

Provide a mutable fallible converter for types that implement an infallible conversion.

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: T
) -> Result<U, <Artichoke as TryConvertMut<T, U>>::Error>

Blanket implementation that always succeeds by delegating to [Convert::convert].

impl<'a> TryConvertMut<Value, &'a [u8]> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<&'a [u8], <Artichoke as TryConvertMut<Value, &'a [u8]>>::Error>

Performs the fallible conversion.

impl<'a> TryConvertMut<Value, &'a str> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<&'a str, <Artichoke as TryConvertMut<Value, &'a str>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Value, Encoding> for Artichoke

type Error = InvalidEncodingError

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<Encoding, <Artichoke as TryConvertMut<Value, Encoding>>::Error>

Performs the fallible conversion.

impl<'a> TryConvertMut<Value, Option<&'a [u8]>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<Option<&'a [u8]>, <Artichoke as TryConvertMut<Value, Option<&'a [u8]>>>::Error>

Performs the fallible conversion.

impl<'a> TryConvertMut<Value, Option<&'a str>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<Option<&'a str>, <Artichoke as TryConvertMut<Value, Option<&'a str>>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Value, Option<String>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<Option<String>, <Artichoke as TryConvertMut<Value, Option<String>>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Value, Option<Vec<u8>>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<Option<Vec<u8>>, <Artichoke as TryConvertMut<Value, Option<Vec<u8>>>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Value, RandomNumberMax> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    max: Value
) -> Result<RandomNumberMax, <Artichoke as TryConvertMut<Value, RandomNumberMax>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Value, RandomNumberMax> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    max: Value
) -> Result<RandomNumberMax, <Artichoke as TryConvertMut<Value, RandomNumberMax>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Value, Seed> for Artichoke

type Error = TypeError

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<Seed, <Artichoke as TryConvertMut<Value, Seed>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Value, String> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<String, <Artichoke as TryConvertMut<Value, String>>::Error>

Performs the fallible conversion.

impl<'a> TryConvertMut<Value, Vec<&'a [u8]>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<Vec<&'a [u8]>, <Artichoke as TryConvertMut<Value, Vec<&'a [u8]>>>::Error>

Performs the fallible conversion.

impl<'a> TryConvertMut<Value, Vec<&'a str>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<Vec<&'a str>, <Artichoke as TryConvertMut<Value, Vec<&'a str>>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Value, Vec<(Value, Value)>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<Vec<(Value, Value)>, <Artichoke as TryConvertMut<Value, Vec<(Value, Value)>>>::Error>

Performs the fallible conversion.

impl<'a> TryConvertMut<Value, Vec<Option<&'a [u8]>>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<Vec<Option<&'a [u8]>>, <Artichoke as TryConvertMut<Value, Vec<Option<&'a [u8]>>>>::Error>

Performs the fallible conversion.

impl<'a> TryConvertMut<Value, Vec<Option<&'a str>>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<Vec<Option<&'a str>>, <Artichoke as TryConvertMut<Value, Vec<Option<&'a str>>>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Value, Vec<Option<String>>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<Vec<Option<String>>, <Artichoke as TryConvertMut<Value, Vec<Option<String>>>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Value, Vec<Option<Vec<u8>>>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<Vec<Option<Vec<u8>>>, <Artichoke as TryConvertMut<Value, Vec<Option<Vec<u8>>>>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Value, Vec<String>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<Vec<String>, <Artichoke as TryConvertMut<Value, Vec<String>>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Value, Vec<Value>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<Vec<Value>, <Artichoke as TryConvertMut<Value, Vec<Value>>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Value, Vec<Vec<u8>>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<Vec<Vec<u8>>, <Artichoke as TryConvertMut<Value, Vec<Vec<u8>>>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Value, Vec<i64>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<Vec<i64>, <Artichoke as TryConvertMut<Value, Vec<i64>>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Value, Vec<u8>> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Value
) -> Result<Vec<u8>, <Artichoke as TryConvertMut<Value, Vec<u8>>>::Error>

Performs the fallible conversion.

impl<'_> TryConvertMut<Vec<&'_ [u8]>, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Vec<&[u8]>
) -> Result<Value, <Artichoke as TryConvertMut<Vec<&'_ [u8]>, Value>>::Error>

Performs the fallible conversion.

impl<'_> TryConvertMut<Vec<&'_ str>, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Vec<&str>
) -> Result<Value, <Artichoke as TryConvertMut<Vec<&'_ str>, Value>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Vec<(Vec<u8>, Vec<i64>)>, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Vec<(Vec<u8>, Vec<i64>)>
) -> Result<Value, <Artichoke as TryConvertMut<Vec<(Vec<u8>, Vec<i64>)>, Value>>::Error>

Performs the fallible conversion.

impl<'_> TryConvertMut<Vec<Option<&'_ [u8]>>, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Vec<Option<&[u8]>>
) -> Result<Value, <Artichoke as TryConvertMut<Vec<Option<&'_ [u8]>>, Value>>::Error>

Performs the fallible conversion.

impl<'_> TryConvertMut<Vec<Option<&'_ str>>, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Vec<Option<&str>>
) -> Result<Value, <Artichoke as TryConvertMut<Vec<Option<&'_ str>>, Value>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Vec<Option<Vec<u8>>>, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Vec<Option<Vec<u8>>>
) -> Result<Value, <Artichoke as TryConvertMut<Vec<Option<Vec<u8>>>, Value>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Vec<String>, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Vec<String>
) -> Result<Value, <Artichoke as TryConvertMut<Vec<String>, Value>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Vec<Value>, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Vec<Value>
) -> Result<Value, <Artichoke as TryConvertMut<Vec<Value>, Value>>::Error>

Performs the fallible conversion.

impl<'_> TryConvertMut<Vec<Vec<Option<&'_ [u8]>>>, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Vec<Vec<Option<&[u8]>>>
) -> Result<Value, <Artichoke as TryConvertMut<Vec<Vec<Option<&'_ [u8]>>>, Value>>::Error>

Performs the fallible conversion.

impl<'_> TryConvertMut<Vec<Vec<Option<&'_ str>>>, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Vec<Vec<Option<&str>>>
) -> Result<Value, <Artichoke as TryConvertMut<Vec<Vec<Option<&'_ str>>>, Value>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Vec<Vec<Option<Vec<u8>>>>, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Vec<Vec<Option<Vec<u8>>>>
) -> Result<Value, <Artichoke as TryConvertMut<Vec<Vec<Option<Vec<u8>>>>, Value>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Vec<Vec<u8>>, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Vec<Vec<u8>>
) -> Result<Value, <Artichoke as TryConvertMut<Vec<Vec<u8>>, Value>>::Error>

Performs the fallible conversion.

impl TryConvertMut<Vec<i64>, Value> for Artichoke

type Error = Exception

Error type for failed conversions.

fn try_convert_mut(
    &mut self,
    value: Vec<i64>
) -> Result<Value, <Artichoke as TryConvertMut<Vec<i64>, Value>>::Error>

Performs the fallible conversion.

impl Warn for Artichoke

type Error = Exception

Concrete error type for errors encountered when outputting warnings.

fn warn(&mut self, message: &[u8]) -> Result<(), <Artichoke as Warn>::Error>

Emit a warning message using Warning#warn.