Struct ObjectRef 

pub struct ObjectRef<'a> { /* private fields */ }

A borrowed Python value, for inspecting results, arguments and inputs without copying.

Implementations

impl<'a> ObjectRef<'a>

pub fn type_name(&self) -> &'a str

The Python type name of the value, e.g. "list".

pub fn to_owned(&self) -> MontyObject

Copies into an owned value, preserving sharing within the value.

pub fn items(&self) -> Option<Vec<Self>>

The items of a list, tuple, set, frozenset or namedtuple; None for any other value.

pub fn pairs(&self) -> Option<Vec<(Self, Self)>>

The (key, value) pairs of a dict, or the attrs of a class instance, class type object or module; None for any other value.

pub fn as_int(&self) -> Option<i64>

The value as an int, if it fits in 64 bits.

pub fn as_str(&self) -> Option<&'a str>

The value as a str.

pub fn as_bool(&self) -> Option<bool>

The value as a bool.

pub fn as_float(&self) -> Option<f64>

The value as a float; an int converts as Python’s float() does, with one too large for a float giving None where Python overflows.

pub fn as_decimal(&self) -> Option<&str>

The string form of a decimal.Decimal, as str(d) prints it.

pub fn as_complex(&self) -> Option<MontyComplex>

The value as a complex; an int or float converts as Python’s complex() does, with a zero imaginary part (see as_float for an int too large to convert).

pub fn py_repr(&self) -> String

The Python repr() of the value.

Panics

Could panic if out of memory.

pub fn is_truthy(&self) -> bool

Whether the value is truthy under Python’s rules: None, False, zero and empty containers are falsy; everything else is truthy.

Trait Implementations

impl<'a> Clone for ObjectRef<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for ObjectRef<'a>

impl<'a> Debug for ObjectRef<'a>

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

Formats the value using the given formatter.

impl Display for ObjectRef<'_>

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

The Python str() of the value: text as is, everything else its repr().

impl PartialEq for ObjectRef<'_>

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

Structural equality as Python values: an int equals the same BigInt, a namedtuple equals a tuple of its values, floats compare bit-for-bit (so NaN round-trips equal), and a sub-object shared in one arena equals its copies in another. Linear in the arenas: each pair of nodes is compared once.

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

Inequality operator !=.

impl PartialEq<MontyObject> for ObjectRef<'_>

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<ObjectRef<'_>> for MontyObject

fn eq(&self, other: &ObjectRef<'_>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl PushValue for ObjectRef<'_>

fn push_into(self, graph: &mut MontyGraph) -> NodeId

Copies the reachable nodes; a sub-object shared inside the value stays shared. Linear sweeps over the value’s index span, no recursion, so a deep value from an untrusted worker costs heap rather than native stack.

impl TryFrom<ObjectRef<'_>> for i64

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: ObjectRef<'_>) -> Result<Self, ConversionError>

Performs the conversion.

impl TryFrom<ObjectRef<'_>> for f64

An int converts as Python’s float() does.

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: ObjectRef<'_>) -> Result<Self, ConversionError>

Performs the conversion.

impl TryFrom<ObjectRef<'_>> for String

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: ObjectRef<'_>) -> Result<Self, ConversionError>

Performs the conversion.

impl TryFrom<ObjectRef<'_>> for bool

Only True/False convert; this is not Python truthiness (see ObjectRef::is_truthy).

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: ObjectRef<'_>) -> Result<Self, ConversionError>

Performs the conversion.