Struct Variant 

pub struct Variant { /* private fields */ }

An evaluated value represents the value of a an expression after evaluation.

Implementations

impl Variant

pub fn datatype(&self) -> VariantDataType

pub fn new_typed(vdt: &VariantDataType) -> Self

pub fn convert_into(&self, vdt: &VariantDataType) -> Self

pub fn to_bool(&self) -> bool

Converts the variant into a bool.

If the variant contains a string value, the “n” or “N” string convert into a false boolean, other strings convert into a true boolean.

If the variant contains a numeric value, either an integer or hexadecimal value, a 0 is converted into a false boolean, any other value into a true boolean.

If the variant contains a tristate value, only the false tristate value will be converted into a false boolean, either a true or maybe tristate value will be converted into a true value.

If the variant contains a boolean value, it will be returned as is.

pub fn to_tristate(&self) -> Tristate

Converts the variant into a tristate.

If the variant contains a string value, the “n” or “N” string convert into a false tristate, the “m” or “M” strings convert into a maybe tristate, any other strings convert into a true tristate.

If the variant contains a numeric value, either an integer or hexadecimal value, a 0 is converted into a false tristate, any other value into a true tristate.

If the variant contains a tristate value, it will be returned as is.

If the variant contains a boolean value, it will be converted as tristate.

pub fn to_hex(&self) -> Hex

Converts the variant into a hexadecimal value.

If the variant contains a string value, an attempt will be made to convert the string in to an integer. If that fails, and the string contains a “n” or “N” value, it is converted into 0x00, otherwise it is interpreted as 0x01.

If the variant contains a numeric value, either an integer or hexadecimal value, it will be returned as is, as hexadecimal representation. If the value is an integer, the sign will be converted.

If the variant contains a tristate value, if the tristate is a false value, it will be converted as 0x00, otherwise it will be converted as 0x01.

If the variant contains a boolean value, if the boolean is a false value, it will be converted as 0x00, otherwise it will be converted as 0x01.

pub fn to_int(&self) -> i64

Converts the variant into an integer value.

If the variant contains a string value, an attempt will be made to convert the string in to an integer. If that fails, and the string contains a “n” or “N” value, it is converted into 0, otherwise it is interpreted as 1.

If the variant contains a numeric value, either an integer or hexadecimal value, it will be returned as is, as hexadecimal representation. If the value is a hexadecimal, the sign will be converted.

If the variant contains a tristate value, if the tristate is a false value, it will be converted as 0, otherwise it will be converted as 1.

If the variant contains a boolean value, if the boolean is a false value, it will be converted as 0, otherwise it will be converted as 1.

pub fn parse(v: &str) -> Self

Parses a given string, and attempts to return the closest matching variant belonging to the string. If the string contains a “y” or “Y” value, it is converted to a boolean true value, if the string contains a “n” or “N” value, it is converted to a boolean false value, if the string contains a “m” or “M” value, it is converted into a tristate maybe value.

If none of the above are true, an attempt is made to parse the string as hexadecimal and integer values. If unsuccessful, it is considered a normal string.

pub fn from_dot_config(v: &str) -> Self

Converts a dot config value back into a Variant

pub fn dot_config(&self) -> String

Converts the representation of the variant from a normal value to a .config representation, as used by the Kconfig intermediate format.

pub fn transform(&self, vdt: VariantDataType) -> Variant

Transforms the variant from the current variant type, into the given variant type

Trait Implementations

impl Clone for Variant

fn clone(&self) -> Variant

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Variant

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

Formats the value using the given formatter.

impl Display for Variant

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

Formats the display of the variant as value

impl From<&str> for Variant

fn from(v: &str) -> Self

Creates a variant from a string

impl From<Hex> for Variant

fn from(h: Hex) -> Self

Creates a variant form a hexadecimal value

impl From<String> for Variant

fn from(v: String) -> Self

Creates a variant from a string

impl From<Tristate> for Variant

fn from(t: Tristate) -> Self

Creates a variant from a tristate value

impl From<Variant> for MutationStart

fn from(value: Variant) -> Self

Converts to this type from the input type.

impl From<bool> for Variant

fn from(b: bool) -> Self

Creates a variant from a boolean value

impl From<i64> for Variant

fn from(i: i64) -> Self

Creates a variant from an integer value

impl Into<Hex> for Variant

fn into(self) -> Hex

Converts the variant into a hexadecimal value, using the Self::to_hex() function.

impl Into<String> for Variant

fn into(self) -> String

Converts the variant into a string, using the Self::to_string() function.

impl Into<Tristate> for Variant

fn into(self) -> Tristate

Converts the variant into a tristate value, using the Self::to_tristate() function.

impl Into<bool> for Variant

fn into(self) -> bool

Converts the variant into a boolean value, using the Self::to_bool() function.

impl Into<i64> for Variant

fn into(self) -> i64

Converts the variant into an integer value, using the Self::to_int() function.

impl Not for Variant

fn not(self) -> Self::Output

Inverts the variant. If the variant is a boolean, inverts it directly. If the variant is not a boolean, it is converted to a tristate value, then it is inverted, such that the maybe tristate value, retains its properties.

type Output = Variant

The resulting type after applying the ! operator.

impl Ord for Variant

fn cmp(&self, other: &Self) -> Ordering

If self and other are both of integer or hexadecimal type, then comparison will be performed by integer comparison.

If self and other are both of boolean or tristate type, then comparison will be performed on tristate value, thus y > m > n.

If one is of type boolean/tristate and the other is of type integer/hexadecimal, the integer/hexadecimal type will be converted to it’s boolean equivalent, then compared

Everything else will be compared as if it were two string types.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

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

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Variant

fn eq(&self, other: &Variant) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Variant

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl Eq for Variant

impl StructuralPartialEq for Variant