Struct exmex::OwnedFlatEx

pub struct OwnedFlatEx<T, OF = DefaultOpsFactory<T>> where
    T: Clone + Debug,
    OF: MakeOperators<T>,  { /* fields omitted */ }

This is another representation of a flattened expression besides FlatEx. The difference is that OwnedFlatEx can be used without a lifetime parameter. All the data that FlatEx borrowed is kept in a buffer by OwnedFlatEx. The drawback is that parsing takes longer, since additional allocations are necessary. Evaluation time should be about the same for FlatEx and OwnedFlatEx.

use exmex::{Express, OwnedFlatEx};
let to_be_parsed = "log(z) + 2* (-z^(x-2) + sin(4*y))";
let expr_owned = OwnedFlatEx::<f64>::from_str(to_be_parsed)?;
assert!((expr_owned.eval(&[4.0, 3.7, 2.5])? - 14.992794866624788 as f64).abs() < 1e-12);

Implementations

impl<T, OF> OwnedFlatEx<T, OF> where
    T: Clone + Debug,
    OF: MakeOperators<T>, 

pub fn from_flatex<'a>(flatex: FlatEx<'a, T, OF>) -> Self

Creates an OwnedFlatEx instance from an instance of FlatEx.

Trait Implementations

impl<T: Clone, OF: Clone> Clone for OwnedFlatEx<T, OF> where
    T: Clone + Debug,
    OF: MakeOperators<T>, 

fn clone(&self) -> OwnedFlatEx<T, OF>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug, OF: Debug> Debug for OwnedFlatEx<T, OF> where
    T: Clone + Debug,
    OF: MakeOperators<T>, 

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

Formats the value using the given formatter.

impl<T, OF> Display for OwnedFlatEx<T, OF> where
    T: DataType,
    OF: MakeOperators<T>, 

The expression is displayed as a string created by unparse.

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

Formats the value using the given formatter.

impl<'a, T, OF> Express<'a, T> for OwnedFlatEx<T, OF> where
    T: DataType,
    OF: MakeOperators<T>, 

fn from_str(text: &'a str) -> ExResult<Self> where
    <T as FromStr>::Err: Debug,
    T: Clone + FromStr, 

Parses a string into an expression that can be evaluated.

fn from_pattern(text: &'a str, number_regex_pattern: &str) -> ExResult<Self> where
    <T as FromStr>::Err: Debug,
    T: DataType, 

Use custom number literals defined as regex patterns to create an expression that can be evaluated.

fn eval(&self, vars: &[T]) -> ExResult<T>

Evaluates an expression with the given variable values and returns the computed result.

fn partial(self, var_idx: usize) -> ExResult<Self> where
    T: Float, 

This method computes a new instance that is a partial derivative of self with default operators.

fn unparse(&self) -> ExResult<String>

Creates an expression string that corresponds to the FlatEx instance. This is not necessarily the input string. More precisely,

fn reduce_memory(&mut self)

This function frees some memory. After calling, the methods partial and unparse as well as the implementation of the Display trait might stop working.

fn n_vars(&self) -> usize

Returns the number of variables of the expression

impl<T: Ord, OF: Ord> Ord for OwnedFlatEx<T, OF> where
    T: Clone + Debug,
    OF: MakeOperators<T>, 

fn cmp(&self, other: &OwnedFlatEx<T, OF>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl<T: PartialEq, OF: PartialEq> PartialEq<OwnedFlatEx<T, OF>> for OwnedFlatEx<T, OF> where
    T: Clone + Debug,
    OF: MakeOperators<T>, 

fn eq(&self, other: &OwnedFlatEx<T, OF>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &OwnedFlatEx<T, OF>) -> bool

This method tests for !=.

impl<T: PartialOrd, OF: PartialOrd> PartialOrd<OwnedFlatEx<T, OF>> for OwnedFlatEx<T, OF> where
    T: Clone + Debug,
    OF: MakeOperators<T>, 

fn partial_cmp(&self, other: &OwnedFlatEx<T, OF>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T: Eq, OF: Eq> Eq for OwnedFlatEx<T, OF> where
    T: Clone + Debug,
    OF: MakeOperators<T>, 

impl<T, OF> StructuralEq for OwnedFlatEx<T, OF> where
    T: Clone + Debug,
    OF: MakeOperators<T>, 

impl<T, OF> StructuralPartialEq for OwnedFlatEx<T, OF> where
    T: Clone + Debug,
    OF: MakeOperators<T>,