Struct feanor_math::wrapper::RingElementWrapper

pub struct RingElementWrapper<R>
where
    R: RingStore,
{ /* private fields */ }

Stores a ring element together with its ring, so that ring operations do not require explicit mention of the ring object. This can be used both for convenience of notation (i.e. use a + b instead of ring.add(a, b)) and might also be necessary when e.g. storing elements in a set.

Examples

 
let ring = DensePolyRing::new(StaticRing::<i64>::RING, "X");
let x = RingElementWrapper::new(&ring, ring.indeterminate());
println!("The result is: {}", x.clone() + x.clone() * x);
// instead of
let x = ring.indeterminate();
println!("The result is: {}", ring.format(&ring.add(ring.mul(ring.clone_el(&x), ring.clone_el(&x)), ring.clone_el(&x))));

Implementations

impl<R: RingStore> RingElementWrapper<R>

pub const fn new(ring: R, element: El<R>) -> Self

pub fn pow(self, power: usize) -> Self

pub fn unwrap(self) -> El<R>

Trait Implementations

impl<R: RingStore> Add for RingElementWrapper<R>

type Output = RingElementWrapper<R>

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self::Output

Performs the + operation.

impl<'a, R: RingStore> AddAssign<&'a RingElementWrapper<R>> for RingElementWrapper<R>

fn add_assign(&mut self, rhs: &'a Self)

Performs the += operation.

impl<R: RingStore> AddAssign for RingElementWrapper<R>

fn add_assign(&mut self, rhs: Self)

Performs the += operation.

impl<R: RingStore + Clone> Clone for RingElementWrapper<R>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<R: RingStore> Debug for RingElementWrapper<R>

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

Formats the value using the given formatter.

impl<R: RingStore> Deref for RingElementWrapper<R>

type Target = <<R as RingStore>::Type as RingBase>::Element

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<R: RingStore> Display for RingElementWrapper<R>

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

Formats the value using the given formatter.

impl<R: RingStore + HashableElRingStore> Hash for RingElementWrapper<R>

where R::Type: HashableElRing,

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<R: RingStore> Mul for RingElementWrapper<R>

type Output = RingElementWrapper<R>

The resulting type after applying the * operator.

fn mul(self, rhs: Self) -> Self::Output

Performs the * operation.

impl<'a, R: RingStore> MulAssign<&'a RingElementWrapper<R>> for RingElementWrapper<R>

fn mul_assign(&mut self, rhs: &'a Self)

Performs the *= operation.

impl<R: RingStore> MulAssign for RingElementWrapper<R>

fn mul_assign(&mut self, rhs: Self)

Performs the *= operation.

impl<R: RingStore> PartialEq for RingElementWrapper<R>

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

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

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

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

impl<R: RingStore> Sub for RingElementWrapper<R>

type Output = RingElementWrapper<R>

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self::Output

Performs the - operation.

impl<'a, R: RingStore> SubAssign<&'a RingElementWrapper<R>> for RingElementWrapper<R>

fn sub_assign(&mut self, rhs: &'a Self)

Performs the -= operation.

impl<R: RingStore> SubAssign for RingElementWrapper<R>

fn sub_assign(&mut self, rhs: Self)

Performs the -= operation.

impl<R: RingStore + Copy> Copy for RingElementWrapper<R>

where El<R>: Copy,

impl<R: RingStore> Eq for RingElementWrapper<R>