Struct ComposedHom 

pub struct ComposedHom<R, S, T, F, G>
where
    F: Homomorphism<R, S>,
    G: Homomorphism<S, T>,
    R: ?Sized + RingBase,
    S: ?Sized + RingBase,
    T: ?Sized + RingBase,
{ /* private fields */ }

The function composition of two homomorphisms f: R -> S and g: S -> T.

More concretely, this is the homomorphism R -> T that maps x to g(f(x)). The best way to create a ComposedHom is through Homomorphism::compose().

Implementations

impl<R, S, T, F, G> ComposedHom<R, S, T, F, G>

where F: Clone + Homomorphism<R, S>, G: Clone + Homomorphism<S, T>, R: ?Sized + RingBase, S: ?Sized + RingBase, T: ?Sized + RingBase,

pub fn first(&self) -> &F

Available on crate feature unstable-enable only.

Returns a reference to f, the homomorphism that is applied first to input elements x.

Availability

This API is marked as unstable and is only available when the unstable-enable crate feature is enabled. This comes with no stability guarantees, and could be changed or removed at any time.

pub fn second(&self) -> &G

Available on crate feature unstable-enable only.

Returns a reference to g, the homomorphism that is applied second, so to f(x) when mapping an input element x.

Availability

This API is marked as unstable and is only available when the unstable-enable crate feature is enabled. This comes with no stability guarantees, and could be changed or removed at any time.

Trait Implementations

impl<R, S, T, F, G> Clone for ComposedHom<R, S, T, F, G>

where F: Clone + Homomorphism<R, S>, G: Clone + Homomorphism<S, T>, R: ?Sized + RingBase, S: ?Sized + RingBase, T: ?Sized + RingBase,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<R, S, T, F, G> Homomorphism<R, T> for ComposedHom<R, S, T, F, G>

where F: Homomorphism<R, S>, G: Homomorphism<S, T>, R: ?Sized + RingBase, S: ?Sized + RingBase, T: ?Sized + RingBase,

type DomainStore = <F as Homomorphism<R, S>>::DomainStore

The type of the RingStore used by this object to store the domain ring.

type CodomainStore = <G as Homomorphism<S, T>>::CodomainStore

The type of the RingStore used by this object to store the codomain ring.

fn domain<'a>(&'a self) -> &'a Self::DomainStore

Returns a reference to the domain ring.

fn codomain<'a>(&'a self) -> &'a Self::CodomainStore

Returns a reference to the codomain ring.

fn map(&self, x: <R as RingBase>::Element) -> <T as RingBase>::Element

Applies this homomorphism to the given element from the domain ring, resulting in an element in the codomain ring.

fn map_ref(&self, x: &<R as RingBase>::Element) -> <T as RingBase>::Element

Applies this homomorphism to the given element from the domain ring, resulting in an element in the codomain ring.

fn mul_assign_map( &self, lhs: &mut <T as RingBase>::Element, rhs: <R as RingBase>::Element, )

Multiplies the given element in the codomain ring with an element obtained by applying this homomorphism to a given element from the domain ring.

fn mul_assign_ref_map( &self, lhs: &mut <T as RingBase>::Element, rhs: &<R as RingBase>::Element, )

Multiplies the given element in the codomain ring with an element obtained by applying this homomorphism to a given element from the domain ring.

fn fma_map( &self, lhs: &<T as RingBase>::Element, rhs: &<R as RingBase>::Element, summand: <T as RingBase>::Element, ) -> <T as RingBase>::Element

Fused-multiply-add. This computes lhs * rhs + summand, where rhs is mapped into the ring via this homomorphism.

fn mul_map( &self, lhs: Codomain::Element, rhs: Domain::Element, ) -> Codomain::Element

Multiplies the given element in the codomain ring with an element obtained by applying this homomorphism to a given element from the domain ring.

fn mul_ref_fst_map( &self, lhs: &Codomain::Element, rhs: Domain::Element, ) -> Codomain::Element

Multiplies the given element in the codomain ring with an element obtained by applying this homomorphism to a given element from the domain ring.

fn mul_ref_snd_map( &self, lhs: Codomain::Element, rhs: &Domain::Element, ) -> Codomain::Element

Multiplies the given element in the codomain ring with an element obtained by applying this homomorphism to a given element from the domain ring.

fn mul_ref_map( &self, lhs: &Codomain::Element, rhs: &Domain::Element, ) -> Codomain::Element

Multiplies the given element in the codomain ring with an element obtained by applying this homomorphism to a given element from the domain ring.

fn compose<F, PrevDomain: ?Sized + RingBase>( self, prev: F, ) -> ComposedHom<PrevDomain, Domain, Codomain, F, Self>

where Self: Sized, F: Homomorphism<PrevDomain, Domain>,

Constructs the homomorphism x -> self.map(prev.map(x)).

fn mul_assign_ref_map_through_hom<First: ?Sized + RingBase, H: Homomorphism<First, Domain>>( &self, lhs: &mut Codomain::Element, rhs: &First::Element, hom: H, )

Multiplies the given element in the codomain ring with an element obtained by applying this and another homomorphism to a given element from another ring.

fn mul_assign_map_through_hom<First: ?Sized + RingBase, H: Homomorphism<First, Domain>>( &self, lhs: &mut Codomain::Element, rhs: First::Element, hom: H, )

Multiplies the given element in the codomain ring with an element obtained by applying this and another homomorphism to a given element from another ring.

impl<R, S, T, F, G> Copy for ComposedHom<R, S, T, F, G>

where F: Copy + Homomorphism<R, S>, G: Copy + Homomorphism<S, T>, R: ?Sized + RingBase, S: ?Sized + RingBase, T: ?Sized + RingBase,