Struct Composition

pub struct Composition<G, F, XG, XF> { /* private fields */ }

A struct representing a function composed with another.

When calling the composition as a function, the leftover arguments of the composition function come first (if curried), then the arguments of the function being composed with.

#![feature(generic_const_exprs)]
 
use currycompose::*;
 
// g ∘ f
// where
// g :: f32 -> f32
// f :: u8 -> f32
// g ∘ f :: u8 -> f32
let g = |x: f32| x*x;
let f = |x: u8| x as f32;
 
let gf = g.compose(f);
 
let x = 1;
 
assert_eq!(gf(x), g(f(x)));
 
// g ∘ f
// where
// g :: f32 -> f32 -> f32
// f :: u8 -> f32
// g ∘ f :: f32 -> u8 -> f32
let g = |x: f32, y: f32| x + y;
let f = gf;
 
let gf = g.compose(f);
 
let x = 1;
let y = 1.0;
 
// note here the argument x has been shifted to the end of the args in gf
assert_eq!(gf(y, x), g(f(x), y));
 
// g ∘ f ∘ f
// where
// g :: f32 -> f32 -> f32
// f :: u8 -> f32
// g ∘ f ∘ f :: u8 -> u8 -> f32
let gff = gf.compose(f);
 
let x = 1;
let y = 1;
 
assert_eq!(gff(x, y), g(f(x), f(y)));

Trait Implementations

impl<G: Clone, F: Clone, XG: Clone, XF: Clone> Clone for Composition<G, F, XG, XF>

fn clone(&self) -> Composition<G, F, XG, XF>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<G: Debug, F: Debug, XG: Debug, XF: Debug> Debug for Composition<G, F, XG, XF>

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

Formats the value using the given formatter.

impl<G, F, XG, XF> Fn<<(<XG as TupleUnprepend<XG>>::Tail, XF) as TupleConcat<<XG as TupleUnprepend<XG>>::Tail, XF>>::Type> for Composition<G, F, XG, XF>

where XG: Tuple + TupleUnprepend<XG>, XF: Tuple, G: Fn<XG>, F: Fn<XF, Output = Head<XG>>, (Tail<XG>, XF): TupleConcat<Tail<XG>, XF>, ConcatTuples<Tail<XG>, XF>: Tuple + SplitInto<Tail<XG>, XF>, [(); <Tail<XG> as TupleLength>::LENGTH]:, ((F::Output,), Tail<XG>): TupleConcat<(F::Output,), Tail<XG>, Type = XG>,

extern "rust-call" fn call( &self, args: ConcatTuples<Tail<XG>, XF>, ) -> Self::Output

🔬This is a nightly-only experimental API. (fn_traits)

Performs the call operation.

impl<G, F, XG, XF> FnMut<<(<XG as TupleUnprepend<XG>>::Tail, XF) as TupleConcat<<XG as TupleUnprepend<XG>>::Tail, XF>>::Type> for Composition<G, F, XG, XF>

where XG: Tuple + TupleUnprepend<XG>, XF: Tuple, G: FnMut<XG>, F: FnMut<XF, Output = Head<XG>>, (Tail<XG>, XF): TupleConcat<Tail<XG>, XF>, ConcatTuples<Tail<XG>, XF>: Tuple + SplitInto<Tail<XG>, XF>, [(); <Tail<XG> as TupleLength>::LENGTH]:, ((F::Output,), Tail<XG>): TupleConcat<(F::Output,), Tail<XG>, Type = XG>,

extern "rust-call" fn call_mut( &mut self, args: ConcatTuples<Tail<XG>, XF>, ) -> Self::Output

🔬This is a nightly-only experimental API. (fn_traits)

Performs the call operation.

impl<G, F, XG, XF> FnOnce<<(<XG as TupleUnprepend<XG>>::Tail, XF) as TupleConcat<<XG as TupleUnprepend<XG>>::Tail, XF>>::Type> for Composition<G, F, XG, XF>

where XG: Tuple + TupleUnprepend<XG>, XF: Tuple, G: FnOnce<XG>, F: FnOnce<XF, Output = Head<XG>>, (Tail<XG>, XF): TupleConcat<Tail<XG>, XF>, ConcatTuples<Tail<XG>, XF>: Tuple + SplitInto<Tail<XG>, XF>, [(); <Tail<XG> as TupleLength>::LENGTH]:, ((F::Output,), Tail<XG>): TupleConcat<(F::Output,), Tail<XG>, Type = XG>,

type Output = <G as FnOnce<XG>>::Output

The returned type after the call operator is used.

extern "rust-call" fn call_once( self, args: ConcatTuples<Tail<XG>, XF>, ) -> Self::Output

🔬This is a nightly-only experimental API. (fn_traits)

Performs the call operation.

impl<G: Copy, F: Copy, XG: Copy, XF: Copy> Copy for Composition<G, F, XG, XF>