Struct orx_closure::ClosureResRefOneOf3

pub struct ClosureResRefOneOf3<C1, C2, C3, In, Out: ?Sized, Error> { /* private fields */ }

ClosureResRefOneOf3<C1, C2, C3, In, Out, Error> is a union of two closures:

• ClosureResRef<C1, In, Out, Error>
• ClosureResRef<C2, In, Out, Error>
• ClosureResRef<C3, In, Out, Error>

This is useful when it is possible that the closure might capture and work with either of the three types of data C1, C2 and C3.

It represents the transformation In -> Option<&Out>.

Note that, unlike trait objects of fn-traits, ClosureResRefOneOf3 auto-implements Clone given that captured data variants are cloneable.

Instead of ClosureOneOf3; this closure variant is particularly useful when we capture the data by value and return a result of a reference.

Example

The example below illustrates the usage of the closure over two possible types of captures; however, ClosureResRefOneOf3 is only a generalization of the below for three different capture types.

use orx_closure::*;

type Toy = String;
type MyErr = &'static str;
struct Cat {
    name: String,
    favorite_toys: Vec<Toy>,
}
struct Dog {
    name: String,
    nickname: String,
    favorite_toys: Vec<Toy>,
}

struct PresentIdeas<'a> {
    // for cats or dogs
    for_pet: ClosureResRefOneOf2<Vec<Cat>, Vec<Dog>, &'a str, [Toy], MyErr>,
}

// cats
let cats = vec![Cat {
    name: "bella".to_string(),
    favorite_toys: vec!["ball".to_string()],
}];
let present_ideas = PresentIdeas {
    for_pet: Capture(cats)
        .fun_result_ref(|cats, name| {
            cats.iter()
                .find(|cat| cat.name == name)
                .map(|cat| cat.favorite_toys.as_slice())
                .ok_or("pet name is absent")
        })
        .into_oneof2_var1(),
};

assert_eq!(
    Ok(vec!["ball".to_string()].as_slice()),
    present_ideas.for_pet.call("bella")
);
assert_eq!(
    Err("pet name is absent"),
    present_ideas.for_pet.call("luna")
);

// dogs
let dogs = vec![Dog {
    name: "luke".to_string(),
    nickname: "dogzilla".to_string(),
    favorite_toys: vec!["toy turtle".to_string()],
}];
let present_ideas = PresentIdeas {
    for_pet: Capture(dogs)
        .fun_result_ref(|dogs, name| {
            dogs.iter()
                .find(|dog| dog.name == name || dog.nickname == name)
                .map(|dog| dog.favorite_toys.as_slice())
                .ok_or("pet name is absent")
        })
        .into_oneof2_var2(),
};
assert_eq!(
    Ok(vec!["toy turtle".to_string()].as_slice()),
    present_ideas.for_pet.call("luke")
);
assert_eq!(
    Ok(vec!["toy turtle".to_string()].as_slice()),
    present_ideas.for_pet.call("dogzilla")
);
assert_eq!(Err("pet name is absent"), present_ideas.for_pet.call("tux"));

Implementations

impl<C1, C2, C3, In, Out: ?Sized, Error> ClosureResRefOneOf3<C1, C2, C3, In, Out, Error>

pub fn call(&self, input: In) -> Result<&Out, Error>

Calls the closure with the given input.

Example

The example below illustrates the usage of the closure over two possible types of captures; however, ClosureResRefOneOf3 is only a generalization of the below for three different capture types.

use orx_closure::*;

type Toy = String;
type MyErr = &'static str;
struct Cat {
    name: String,
    favorite_toys: Vec<Toy>,
}
struct Dog {
    name: String,
    nickname: String,
    favorite_toys: Vec<Toy>,
}

struct PresentIdeas<'a> {
    // for cats or dogs
    for_pet: ClosureResRefOneOf2<Vec<Cat>, Vec<Dog>, &'a str, [Toy], MyErr>,
}

// cats
let cats = vec![Cat {
    name: "bella".to_string(),
    favorite_toys: vec!["ball".to_string()],
}];
let present_ideas = PresentIdeas {
    for_pet: Capture(cats)
        .fun_result_ref(|cats, name| {
            cats.iter()
                .find(|cat| cat.name == name)
                .map(|cat| cat.favorite_toys.as_slice())
                .ok_or("pet name is absent")
        })
        .into_oneof2_var1(),
};

// calling the closure with different pat names
assert_eq!(
    Ok(vec!["ball".to_string()].as_slice()),
    present_ideas.for_pet.call("bella")
);
assert_eq!(
    Err("pet name is absent"),
    present_ideas.for_pet.call("luna")
);

pub fn captured_data(&self) -> OneOf3<&C1, &C2, &C3>

Returns a reference to the captured data.

pub fn into_captured_data(self) -> OneOf3<C1, C2, C3>

Consumes the closure and returns back the captured data.

Example

The example below illustrates the usage of the closure over two possible types of captures; however, ClosureResRefOneOf3 is only a generalization of the below for three different capture types.

use orx_closure::*;

type Toy = String;
type MyErr = &'static str;

#[derive(Debug, Clone, PartialEq, Eq)]
struct Cat {
    name: String,
    favorite_toys: Vec<Toy>,
}

#[derive(Debug, Clone, PartialEq, Eq)]
struct Dog {
    name: String,
    nickname: String,
    favorite_toys: Vec<Toy>,
}

struct PresentIdeas<'a> {
    // for cats or dogs
    for_pet: ClosureResRefOneOf2<Vec<Cat>, Vec<Dog>, &'a str, [Toy], MyErr>,
}

// cats
let cats = vec![Cat {
    name: "bella".to_string(),
    favorite_toys: vec!["ball".to_string()],
}];
let present_ideas = PresentIdeas {
    for_pet: Capture(cats.clone())
        .fun_result_ref(|cats, name| {
            cats.iter()
                .find(|cat| cat.name == name)
                .map(|cat| cat.favorite_toys.as_slice())
                .ok_or("pet name is absent")
        })
        .into_oneof2_var1(),
};

// calling the closure with different pat names
assert_eq!(
    Ok(vec!["ball".to_string()].as_slice()),
    present_ideas.for_pet.call("bella")
);
assert_eq!(
    Err("pet name is absent"),
    present_ideas.for_pet.call("luna")
);

// get back the captured data which can be one of the two options: cats or dogs:

let data = present_ideas.for_pet.into_captured_data();

assert_eq!(data, OneOf2::Variant1(cats));

pub fn as_fn<'a>(&'a self) -> impl Fn(In) -> Result<&'a Out, Error>

Returns the closure as an impl Fn(In) -> Result<&Out> struct, allowing the convenience

• to avoid the call method,
• or pass the closure to functions accepting a function generic over the Fn.

Example

The example below illustrates the usage of the closure over two possible types of captures; however, ClosureResRefOneOf3 is only a generalization of the below for three different capture types.

use orx_closure::*;

type Toy = String;
type MyErr = &'static str;
struct Cat {
    name: String,
    favorite_toys: Vec<Toy>,
}
struct Dog {
    name: String,
    nickname: String,
    favorite_toys: Vec<Toy>,
}

struct PresentIdeas<'a> {
    // for cats or dogs
    for_pet: ClosureResRefOneOf2<Vec<Cat>, Vec<Dog>, &'a str, [Toy], MyErr>,
}

// cats
let cats = vec![Cat {
    name: "bella".to_string(),
    favorite_toys: vec!["ball".to_string()],
}];
let present_ideas = PresentIdeas {
    for_pet: Capture(cats)
        .fun_result_ref(|cats, name| {
            cats.iter()
                .find(|cat| cat.name == name)
                .map(|cat| cat.favorite_toys.as_slice())
                .ok_or("pet name is absent")
        })
        .into_oneof2_var1(),
};

// function accepting an instance of the `Fn(&str) -> &[Toy]` trait
fn create_presents<'a, F: Fn(&'a str) -> Result<&'a [Toy], MyErr>>(present_ideas_for: F) -> Vec<Toy> {
    ["bella", "luna"]
        .iter()
        .flat_map(|name| present_ideas_for(name).unwrap_or(&[]).iter().cloned())
        .collect()
}

// we can conveniently create the `Fn` with `as_fn`
let presents = create_presents(present_ideas.for_pet.as_fn());
assert_eq!(&["ball".to_string()], presents.as_slice());

Trait Implementations

impl<C1: Clone, C2: Clone, C3: Clone, In: Clone, Out: Clone + ?Sized, Error: Clone> Clone for ClosureResRefOneOf3<C1, C2, C3, In, Out, Error>

fn clone(&self) -> ClosureResRefOneOf3<C1, C2, C3, In, Out, Error>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C1: Debug, C2: Debug, C3: Debug, In: Debug, Out: Debug + ?Sized, Error: Debug> Debug for ClosureResRefOneOf3<C1, C2, C3, In, Out, Error>

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

Formats the value using the given formatter.

impl<C1, C2, C3, In, Out: ?Sized, Error> FunResRef<In, Out, Error> for ClosureResRefOneOf3<C1, C2, C3, In, Out, Error>

fn call(&self, input: In) -> Result<&Out, Error>

Calls the function with the given input and returns the produced output.